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
Construction site scheduling
Event planning weather check
Solar energy production forecasting
Flight delay prediction
Insurance risk assessment
Ski resort snow conditions
Sports event scheduling
Allergy and pollen alerts
Smart home automation triggers
Marine and sailing forecasts
Wedding date weather lookup
Wildfire risk monitoring
Drone flight planning
Hiking trail conditions
Retail foot traffic prediction