Loading
Loading
Get weather forecasts up to 16 days ahead for any location worldwide. Supports lookup by city name or address, GPS coordinates, or IP address. Returns daily, hourly, or minutely forecast data along with astronomical information.
Specify a date range using startDate/endDate or use forecastDays for a rolling window. Set precision to daily (default), hourly, or minutely to control data granularity. Each response includes astronomical data (sunrise, sunset, moon phase) for every date in the range.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
Provide a location using location, lat/long, or ip. If none are provided the API auto-detects the requesting IP. Specify a date range or use forecastDays. Forecast dates must be within the current date to 16 days ahead.
formatoptionalStringdefault: jsonResponse format: 'json'.
locationoptionalStringLocation to get weather for. Accepts a city name, place, or full address.
latoptionalFloatLatitude coordinate of the location.
longoptionalFloatLongitude coordinate of the location.
ipoptionalStringIPv4 or IPv6 address to infer the user's location automatically.
forecastDaysoptionalStringdefault: 7Number of days for which the forecast is required, ranging from 1 to 16. Default value: 7. Max value: 16.
startDateoptionalStringSpecific date for which to fetch weather data. Must follow YYYY-MM-DD format (e.g., "2025-08-25"). Forecast dates must be current or future dates only. Past dates are not allowed for forecast data.
endDateoptionalStringSpecific date for which to fetch weather data. Must follow YYYY-MM-DD format (e.g., "2025-08-25"). Forecast dates must be current or future dates only. Past dates are not allowed for forecast data.
precisionoptionalStringdefault: dailyForecast granularity. Options: daily (default), hourly, minutely.
timezoneoptionalStringThe timezone in which results are returned. Defaults to the location's timezone. Any time zone name from the time zone database is supported.
A successful request returns a 200 OK with a JSON object. The top-level contains location and forecast. The forecast object is keyed by date (YYYY-MM-DD), each containing daily, hourly, or minutely sub-objects based on the precision setting, plus an astronomy object. See the response preview for the full structure.
date (Object)
Address Lookup (Object), Coordinates Lookup (Object), IP Lookup (Object)
Reference for the weather_code field values returned in the daily, hourly, minutely, and astronomy objects. Codes follow the WMO standard for weather interpretation.
0Clear sky - completely clear with no cloud coverage.
1, 2, 3Mainly clear, partly cloudy, and overcast - varying cloud coverage levels.
45, 48Fog - standard fog (45) and depositing rime fog (48).
51, 53, 55Drizzle - light (51), moderate (53), and dense intensity (55).
56, 57Freezing drizzle - light (56) and dense/heavy intensity (57).
61, 63, 65Rain - slight (61), moderate (63), and heavy intensity (65).
66, 67Freezing rain - light (66) and heavy intensity (67).
71, 73, 75Snowfall - slight (71), moderate (73), and heavy intensity (75).
77Snow grains - small, white, opaque ice particles.
80, 81, 82Rain showers - slight (80), moderate (81), and violent intensity (82).
85, 86Snow showers - slight (85) and heavy intensity (86).
95Thunderstorm - slight or moderate intensity.
96, 99Thunderstorm with hail - slight hail (96) and heavy hail (99).
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
Invalid latitude or longitude values. Latitude must be between -90 and 90, and longitude must be between -180 and 180
Forecast date range must be within 2026-06-04 to 2026-06-19
We couldn't find the location (asdfghjklqwerty). Try a city or state level location address only.