Weather API docs
Current weather and multi-day forecasts for any city or coordinates worldwide. Temperatures, wind, precipitation, humidity and conditions — powered by Open-Meteo.
Authentication
All Weather API requests authenticate via two headers. Get your API key from your RapidAPI dashboard after subscribing on the Basic (free) tier or higher.
X-RapidAPI-Key: YOUR_API_KEY X-RapidAPI-Host: weather-by-helix-api.p.rapidapi.com
Base URL
https://weather-by-helix-api.p.rapidapi.com
Endpoints
GET
/currentCurrent weather for a city or coordinates
GET
/forecastDaily forecast for up to 16 days
Code Examples
Python
import requests
url = "https://weather-by-helix-api.p.rapidapi.com/current"
headers = {
"X-RapidAPI-Key": "YOUR_API_KEY",
"X-RapidAPI-Host": "weather-by-helix-api.p.rapidapi.com",
}
response = requests.get(url, headers=headers)
print(response.json())JavaScript
const response = await fetch(
"https://weather-by-helix-api.p.rapidapi.com/current",
{
method: "GET",
headers: {
"X-RapidAPI-Key": "YOUR_API_KEY",
"X-RapidAPI-Host": "weather-by-helix-api.p.rapidapi.com"
}
}
);
const data = await response.json();cURL
curl -X GET "https://weather-by-helix-api.p.rapidapi.com/current" \ -H "X-RapidAPI-Key: YOUR_API_KEY" \ -H "X-RapidAPI-Host: weather-by-helix-api.p.rapidapi.com"
Response Format
All endpoints return JSON in this consistent envelope:
{
"status": "ok",
"data": { /* endpoint-specific payload */ },
"meta": {
"cached": false,
"latency_ms": 142,
"request_id": "req_abc123"
},
"timestamp": "2026-05-21T12:00:00Z"
}Error Codes
| HTTP | Code | Meaning |
|---|---|---|
| 400 | BAD_REQUEST | Missing or invalid parameter |
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 403 | FORBIDDEN | Your plan doesn't include this endpoint |
| 429 | RATE_LIMIT_EXCEEDED | Too many requests — back off and retry |
| 500 | INTERNAL_ERROR | Something went wrong on our side |
| 503 | UPSTREAM_UNAVAILABLE | A third-party data source is down |
Common Use Cases
Weather apps
Travel planning
Outdoor activity planners
Agriculture & farming
Delivery logistics