Loading
Loading
Retrieve real-time weather conditions for up to 50 locations in a single POST request. Each location can be specified as a city name or address, GPS coordinates, or IP address. Responses follow the same structure as the single Live Weather API.
The request body must contain a locations array. Each element is an object specifying one location using one of the supported lookup methods: location (address or city name), lat/long (coordinates), or ip (IP address). Each result in the response bulk array contains the same location and current objects as the single endpoint, including full air quality and astronomical data.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
Send a POST request with a units query parameter for the measurement system, an optional timezone to set the default timezone for all results. The request body must be JSON with a locations array (max 50 items).
timezoneoptionalstringOverride timezone for all returned data. Defaults to each location's local timezone.
The request body must be a JSON object containing a locations array with up to 50 entries. Each item accepts a location, optional lat/long for coordinates, and optional timezone override.
{
"locations": [
{
"location": "London"
},
{
"lat": 35.6895,
"long": 139.6917
}
]
}A successful request returns a 200 OK response with a JSON object containing a bulk array. Each element mirrors a single live-weather response. See the response preview on the right for the full JSON structure.
bulkArray of weather result objects, one per requested location. Each element has the same structure as a single live-weather response: a location object and a current object.
When a location item uses the 'location' field, the location object includes the following fields:
location_stringOriginal location query string as submitted, including full address or place name.
country_nameResolved country name derived from the geocoded location query.
state_provState, province, or primary administrative division identified from the location.
cityCity or municipal area name extracted from the geocoded location.
localitySpecific locality, neighborhood, suburb, or village within the geocoded area.
latitudeGeocoded latitude coordinate in decimal degrees, ranging from -90 to +90.
longitudeGeocoded longitude coordinate in decimal degrees, ranging from -180 to +180.
elevationElevation above mean sea level in meters at the geocoded coordinates.
timezoneIANA timezone database identifier for the geocoded location (e.g., America/Los_Angeles).
timezone_abbreviationCurrent timezone abbreviation for the location based on local offset (e.g., PDT, CET).
When a location item uses 'lat'/'long' fields, the location object includes the following fields:
latitudeGeographic latitude coordinate in decimal degrees, ranging from -90 (South Pole) to +90 (North Pole).
longitudeGeographic longitude coordinate in decimal degrees, ranging from -180 (West) to +180 (East).
country_nameFull name of the country corresponding to the provided coordinates.
state_provState, province, or primary administrative division name for the location.
cityCity or municipal area name associated with the coordinate location.
localitySpecific locality, neighborhood, district, or village name within the broader area.
elevationHeight above mean sea level in meters for the specified coordinates.
timezoneIANA timezone database identifier for the location (e.g., America/New_York, Europe/London).
timezone_abbreviationAbbreviated timezone representation based on current offset (e.g., EST, GMT, PST).
When a location item uses the 'ip' field, the location object includes the following fields:
continent_codeTwo-letter continent code (e.g., NA for North America, EU for Europe, AS for Asia).
continent_nameFull name of the continent where the IP address is registered.
country_code2ISO 3166-1 alpha-2 two-letter country code (e.g., US, GB, FR).
country_code3ISO 3166-1 alpha-3 three-letter country code (e.g., USA, GBR, FRA).
country_nameCommon name of the country associated with the IP address.
country_name_officialOfficial long-form country name as recognized internationally (e.g., United States of America).
is_euBoolean flag indicating whether the country is a member state of the European Union.
state_provState, province, or primary administrative division associated with the IP location.
state_codeISO 3166-2 subdivision code for the state or province (e.g., CA for California).
districtDistrict, county, or secondary administrative division within the region.
cityCity or urban area name where the IP address is geographically registered.
zipcodePostal code or ZIP code for the approximate location of the IP address.
latitudeGeographic latitude in decimal degrees for the IP geolocation, ranging from -90 to +90.
longitudeGeographic longitude in decimal degrees for the IP geolocation, ranging from -180 to +180.
localitySpecific locality, neighborhood, or small area designation within the city.
elevationElevation above mean sea level in meters for the IP geolocation.
timezoneIANA timezone database identifier for the IP location (e.g., America/Chicago, Asia/Tokyo).
timezone_abbreviationCurrent timezone abbreviation based on local offset (e.g., CST, JST, UTC).
The current object contains the following weather observation fields:
timestampISO 8601 formatted timestamp of the current weather observation.
temperature_2mCurrent air temperature (°C) measured at 2 meters above ground.
relative_humidity_2mCurrent relative humidity percentage at 2 meters above ground.
apparent_temperatureCurrent apparent temperature (°C) accounting for wind chill and humidity.
snowfallCurrent snowfall accumulation in centimeters.
rainCurrent rainfall accumulation in millimeters.
showersCurrent shower precipitation in millimeters.
precipitationTotal precipitation (mm) including rain, showers, and snowfall.
weather_codeWMO weather condition code representing current conditions.
cloud_coverCurrent percentage of sky covered by clouds.
pressure_mslCurrent atmospheric pressure (hPa) adjusted to mean sea level.
surface_pressureCurrent atmospheric pressure (hPa) at surface level.
wind_speed_10mCurrent wind speed (km/h) at 10 meters above ground.
wind_direction_10mCurrent wind direction in degrees at 10 meters above ground.
wind_gusts_10mCurrent wind gust speed (km/h) at 10 meters above ground.
astronomyAstronomical information including sunrise, sunset, and moon phases for the current date.
air_qualityAir quality metrics including pollutant concentrations and AQI values.
The astronomy sub-object contains the following fields:
dateCalendar date in YYYY-MM-DD format for the astronomical data.
mid_nightTime of true solar midnight in HH:MM format.
night_endTime when astronomical twilight ends and dawn begins in HH:MM format.
sunriseTime when the Sun becomes visible above the horizon in HH:MM format.
solar_noonTime when the Sun reaches its highest point in the sky in HH:MM format.
sunsetTime when the Sun disappears below the horizon in HH:MM format.
night_beginTime when astronomical twilight begins and night starts in HH:MM format.
day_lengthTotal duration of daylight in HH:MM format.
sun_statusCurrent position of the Sun relative to the horizon (above_horizon, below_horizon, or -).
moon_phaseCurrent lunar phase (NEW_MOON, WAXING_CRESCENT, FULL_MOON, WANING_GIBBOUS, etc.).
moonriseTime when the Moon becomes visible above the horizon in HH:MM format.
moonsetTime when the Moon disappears below the horizon in HH:MM format.
moon_statusCurrent visibility status of the Moon (visible, not_visible, or -).
The air_quality sub-object contains the following fields:
timestampISO 8601 formatted timestamp of the air quality observation.
european_aqiConsolidated European Air Quality Index. Ranges: 0-20 (good), 20-40 (fair), 40-60 (moderate), 60-80 (poor), 80-100 (very poor), >100 (extremely poor).
us_aqiConsolidated U.S. Air Quality Index. Ranges: 0-50 (good), 51-100 (moderate), 101-150 (unhealthy for sensitive groups), 151-200 (unhealthy), 201-300 (very unhealthy), 301-500 (hazardous).
pm10Particulate matter with diameter less than 10 micrometers (μg/m³) measured at 10 meters above ground.
pm2_5Particulate matter with diameter less than 2.5 micrometers (μg/m³) measured at 10 meters above ground.
carbon_monoxideAtmospheric carbon monoxide gas concentration (μg/m³) at 10 meters above ground.
nitrogen_dioxideAtmospheric nitrogen dioxide gas concentration (μg/m³) at 10 meters above ground.
sulphur_dioxideAtmospheric sulphur dioxide gas concentration (μg/m³) at 10 meters above ground.
ozoneAtmospheric ozone gas concentration (μg/m³) at 10 meters above ground.
dustSaharan dust particle concentration (μg/m³) at 10 meters above ground.
uv_indexUltraviolet radiation intensity index accounting for cloud coverage.
aerosol_optical_depthAerosol optical depth at 550 nm wavelength indicating atmospheric haze levels.
uv_index_clear_skyUltraviolet radiation intensity index assuming cloud-free conditions.
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
Please provide data in required format in request body
"locations[0]" must be of type object