The base URL for all API calls against the latest API version is

https://api.forecast.solar/

There is also a Swagger Editor to inspect for proper request URLs.

With this parameter you can define in which format the timestamps will be returned.

https://api.forecast.solar/...?time=...

If not given, a simple date time format is used: 2017-09-18 01:00:00

With this parameter you can add a factor to adjust the forecasted watts in the morning and the evening.

https://api.forecast.solar/...?damping=...

See this further explanations.

The API can deliver responses in JSON, XML or CSV (with semicolon as value separator).

The response format have to be defined by the Accept header like this:

curl -H "Accept: application/json" https://api.forecast.solar/...

If no Accept header is defined, JSON will delivered by default. These values are accepted for the Accept header:

JSON : application/json
XML  : application/xml, text/xml
CSV  : text/csv

These are the most relevant headers returned from API.

See rate limit specification below.

Any JSON and XML response will contain these 2 sections

• result - in case of correct API call with requested data
• message - useful in case of an error during the API call

The message –> code is here always 0

{
    "result": {
        ...
    },
    "message": {
        "code": 0,
        "type": "success",
        "text": "",
        "ratelimit": {
            "limit": 86400,
            "remaining": 86397,
            "reset": 48075
        }
    }
}

The message → code is here always > 0

{
    "result": null,
    "message": {
        "type": "error",
        "code": 1,
        "text": "A meaningful error message"
    }
}

Rate limits are defined by hour.