## Get your forecast
1. **Get your API key**
Sign up at [pvnode.com](https://pvnode.com/auth/register) and create an API key in your
[dashboard](https://pvnode.com/settings/api-keys).
2. **Make your first forecast request**
Install the `requests` library if you don't have it:
```bash
pip install requests
```
Then run this Python script:
```python title="forecast.py"
import requests
response = requests.get(
"https://api.pvnode.com/v1/forecast",
headers={"Authorization": f"Bearer YOUR_API_KEY"},
params={
"latitude": 51.0,
"longitude": 10.0,
"slope": 30.0,
"orientation": 180.0,
"pv_power_kw": 10
}
)
data = response.json()
print(f"Status: {response.status_code}")
print(f"First entry: {data['values'][0]}")
```
**Example response:**
```json title="Response (200 OK)"
{
"data": "forecast",
"latitude": 51.0,
"longitude": 10.0,
"elevation": 378.0,
"slope": 30.0,
"orientation": 180.0,
"data_timezone": "utc",
"values": [
{
"dtm": "2026-03-01 00:00:00",
"GHI": 0.0,
"DHI": 0.0,
"BNI": 0.0,
"spec_watts": 0.0,
"temp": 5.5,
"weather_code": 3
},
{
"dtm": "2026-03-01 00:15:00",
"GHI": 0.0,
"DHI": 0.0,
"BNI": 0.0,
"spec_watts": 0.0,
"temp": 5.3,
"weather_code": 3
},
{...}
]
}
```
:::tip
The response contains 15-minute intervals with power output (`spec_watts` in W/kWp), irradiance (GHI, DHI, BNI), temperature, and weather codes by default. You can customize which fields are returned and configure dozens of additional parameters — see the [API Reference](/api) for the full list.
:::