CTRL+K
Get real-time weather data for any location worldwide with APIFreaks' Live Weather API. The API instantly delivers current conditions — including temperature, humidity, wind speed and direction, visibility, and pressure — for a given city, coordinate, or IP address.
You can fetch live weather insights using a simple GET request, or use the POST endpoint to retrieve data for up to 50 locations at once. Each response includes weather, air quality (AQI), and astronomical data, giving you a complete environmental snapshot in one call.
Built for developers, the Live Weather API powers IoT systems, dashboards, travel apps, and forecasting tools with verified, high-frequency updates sourced from global meteorological networks. It's fast, reliable, and designed for precision-driven applications.
Instant access to live temperature, humidity, visibility, wind speed, pressure, and condition codes. Ideal for apps that rely on real-time weather data APIs for accuracy and speed
Get weather by city, weather by coordinates (lat & long), or weather by IP address — making it easy to detect a user’s environment or serve localized experiences globally.
Pull live weather data for up to 50 locations using the bulk POST endpoint. Great for analytics dashboards, fleet management tools, and enterprise monitoring systems.
Each request returns AQI metrics and astronomical data (sunrise, sunset, moon phase) — enabling developers to build complete weather, environment, and sustainability features.
Each response includes complete geographic context with continent, country, state/province, district, city, locality, postal code, precise coordinates, elevation data, and timezone information.
$ pip install requests
$ pip install requests
A maximum of 50 locations (city names, IP addresses, or geographic coordinates) can be included in the request body for Bulk request.
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
| location | No | string | - | Specifies the target location. It can be a city name, place name, or a complete address (e.g., "Lahore", "Paris, France", "1600 Amphitheatre Parkway, Mountain View, CA"). |
| lat | No | float | - | Specifies the latitude coordinate of the target location. Must be used together with the "long" parameter. |
| long | No | float | - | Specifies the longitude coordinate of the target location. Must be used together with the "lat" parameter. |
| ip | No | string | Requester IP | IPv4 or IPv6 address used for location-based lookup. If not provided, the requester’s public IP address is used by default. |
| timezone | No | string | Location’s timezone | Specifies the timezone for the returned data. Defaults to the timezone of the resolved location. |
For bulk requests, the request body must be in JSON format and should contain a locations array. Each item in this array can represent a city name, place name, full address (e.g. 'Lahore', 'Paris, France', '1600 Amphitheatre Parkway, Mountain View, CA'), a latitude/longitude coordinate pair, or an IP address. This flexibility allows you to fetch weather data for different types of location identifiers in a single API call.
{
"locations": [
{
"location": "Lahore"
},
{
"lat": 32.5,
"long": 74.5
},
{
"ip": "8.8.8.8"
},
{
"location": "Seoul"
}
]
}For a comprehensive view of the API response structure and detailed field descriptions, explore the interactive Response Table. For Live Weather API Test Page click here, For Live Weather Bulk API Test Page click here.
| HTTP Status | Reasons |
|---|---|
| 400 | (1) "lat" and "long" must be valid numbers.
(2) Latitude must be between -90 and 90; longitude must be between -180 and 180.
(3) Given address is Invaild.
(4) Invalid "timezone" format. Timezone must follow standard tz database. |
Retrieve real-time weather conditions for any address, landmark, or city worldwide using the location parameter. The API automatically geocodes your location query and returns comprehensive weather data along with precise geographic details.
# Response { "location": { "location_string": "Wembley Stadium, London", "country_name": "United Kingdom", "state_prov": "England", "city": "London", "locality": "", "latitude": "51.55607", "longitude": "-0.27960", "elevation": "12", "timezone": "Europe/London", "timezone_abbreviation": "GMT" }, "current": { "timestamp": "2025-11-05T12:30", "temperature_2m": 16.8, "relative_humidity_2m": 69, "apparent_temperature": 15.5, "snowfall": 0, "rain": 0, "showers": 0, "precipitation": 0, "weather_code": 3, "cloud_cover": 100, "pressure_msl": 1007.6, "surface_pressure": 1002.2, "wind_speed_10m": 11.5, "wind_direction_10m": 176, "wind_gusts_10m": 28.4, "air_quality": { "timestamp": "2025-11-05T12:00", "european_aqi": 20, "us_aqi": 24, "pm10": 10.1, "pm2_5": 6, "carbon_monoxide": 137, "nitrogen_dioxide": 14, "sulphur_dioxide": 1.7, "ozone": 49, "dust": 2, "uv_index": 1.2, "aerosol_optical_depth": 0.09, "uv_index_clear_sky": 1.35 }, "astronomy": { "date": "2025-11-05", "mid_night": "23:44", "night_end": "05:07", "sunrise": "06:59", "sunset": "16:29", "night_begin": "18:21", "sun_status": "-", "solar_noon": "11:44", "day_length": "09:29", "moon_phase": "FULL_MOON", "moonrise": "15:52", "moonset": "07:05", "moon_status": "-" } } }curl -X 'GET' 'https://api.apifreaks.com/v1.0/weather/current?location=Wembley%20Stadium,%20London&apiKey=API-KEY'
Request weather by coordinates for pinpoint accuracy. This method is essential for GPS-enabled applications and any use case requiring exact geographic positioning. Use the lat and long parameters to retrieve current weather conditions for any point on Earth.
# Response { "location": { "latitude": "51.52951", "longitude": "-0.17392", "country_name": "United Kingdom", "state_prov": "England", "city": "London", "locality": "St. John's Wood", "elevation": "12", "timezone": "Europe/London", "timezone_abbreviation": "GMT" }, "current": { "timestamp": "2025-11-05T12:30", "temperature_2m": 17, "relative_humidity_2m": 67, "apparent_temperature": 15.5, "snowfall": 0, "rain": 0, "showers": 0, "precipitation": 0, "weather_code": 3, "cloud_cover": 100, "pressure_msl": 1007.8, "surface_pressure": 1002.4, "wind_speed_10m": 11.5, "wind_direction_10m": 184, "wind_gusts_10m": 28.4, "air_quality": { "timestamp": "2025-11-05T12:00", "european_aqi": 19, "us_aqi": 26, "pm10": 10.3, "pm2_5": 6, "carbon_monoxide": 139, "nitrogen_dioxide": 16.6, "sulphur_dioxide": 2, "ozone": 48, "dust": 2, "uv_index": 1.3, "aerosol_optical_depth": 0.1, "uv_index_clear_sky": 1.35 }, "astronomy": { "date": "2025-11-05", "mid_night": "23:44", "night_end": "05:07", "sunrise": "06:59", "sunset": "16:28", "night_begin": "18:20", "sun_status": "-", "solar_noon": "11:44", "day_length": "09:29", "moon_phase": "FULL_MOON", "moonrise": "15:51", "moonset": "07:04", "moon_status": "-" } } }curl -X 'GET' 'https://api.apifreaks.com/v1.0/weather/current?lat=51.529514&long=-0.173923&apiKey=API-KEY'
Automatically detect and retrieve live weather data based on any IP address. Use the ip parameter to display relevant weather information at specific network locations.
# Response { "location": { "continent_code": "AS", "continent_name": "Asia", "country_code2": "JP", "country_code3": "JPN", "country_name": "Japan", "country_name_official": "Japan", "is_eu": false, "state_prov": "Tokyo", "state_code": "JP-13", "district": "Chiyoda", "city": "Tokyo", "zipcode": "102-0000", "latitude": "35.69495", "longitude": "139.75398", "locality": "Chiyoda", "elevation": "0", "timezone": "Asia/Tokyo", "timezone_abbreviation": "GMT+9" }, "current": { "timestamp": "2025-11-05T21:45", "temperature_2m": 14.1, "relative_humidity_2m": 67, "apparent_temperature": 12.8, "snowfall": 0, "rain": 0, "showers": 0, "precipitation": 0, "weather_code": 3, "cloud_cover": 100, "pressure_msl": 1023.9, "surface_pressure": 1020.9, "wind_speed_10m": 5.4, "wind_direction_10m": 352, "wind_gusts_10m": 12.2, "air_quality": { "timestamp": "2025-11-05T21:00", "european_aqi": 73, "us_aqi": 116, "pm10": 49.5, "pm2_5": 49, "carbon_monoxide": 372, "nitrogen_dioxide": 80.9, "sulphur_dioxide": 46.3, "ozone": 2, "dust": 0, "uv_index": 0, "aerosol_optical_depth": 0.18, "uv_index_clear_sky": 0 }, "astronomy": { "date": "2025-11-05", "mid_night": "23:24", "night_end": "04:39", "sunrise": "06:05", "sunset": "16:43", "night_begin": "18:08", "sun_status": "-", "solar_noon": "11:24", "day_length": "10:38", "moon_phase": "FULL_MOON", "moonrise": "16:08", "moonset": "05:28", "moon_status": "-" } } }curl -X 'GET' 'https://api.apifreaks.com/v1.0/weather/current?ip=111.111.111.111&apiKey=API-KEY'
When no parameters are provided, the API intelligently detects the requesting IP address and returns weather data for that location automatically.
# Response { "location": { "continent_code": "AS", "continent_name": "Asia", "country_code2": "PK", "country_code3": "PAK", "country_name": "Pakistan", "country_name_official": "Islamic Republic of Pakistan", "is_eu": false, "state_prov": "Punjab", "state_code": "PK-PB", "district": "Lahore", "city": "Lahore", "zipcode": "54000", "latitude": "31.52037", "longitude": "74.35875", "locality": "Gulberg", "elevation": "", "timezone": "Asia/Karachi", "timezone_abbreviation": "GMT+5" }, "current": { "timestamp": "2025-11-05T17:45", "temperature_2m": 22.4, "relative_humidity_2m": 40, "apparent_temperature": 21.1, "snowfall": 0, "rain": 0, "showers": 0, "precipitation": 0, "weather_code": 0, "cloud_cover": 0, "pressure_msl": 1011.7, "surface_pressure": 986.4, "wind_speed_10m": 5.4, "wind_direction_10m": 307, "wind_gusts_10m": 17.6, "air_quality": { "timestamp": "2025-11-05T17:00", "european_aqi": 73, "us_aqi": 114, "pm10": 48.1, "pm2_5": 31.8, "carbon_monoxide": 1368, "nitrogen_dioxide": 23.6, "sulphur_dioxide": 10.7, "ozone": 104, "dust": 31, "uv_index": 0, "aerosol_optical_depth": 0.25, "uv_index_clear_sky": 0 }, "astronomy": { "date": "2025-11-05", "mid_night": "23:46", "night_end": "04:59", "sunrise": "06:20", "sunset": "17:11", "night_begin": "18:33", "sun_status": "-", "solar_noon": "11:46", "day_length": "10:51", "moon_phase": "FULL_MOON", "moonrise": "16:46", "moonset": "05:55", "moon_status": "-" } } }curl -X 'GET' 'https://api.apifreaks.com/v1.0/weather/current?apiKey=API-KEY'
Efficiently retrieve real-time weather data for multiple locations simultaneously using a single POST request. This powerful batch processing capability is essential for applications monitoring weather across numerous sites. Mix and match location types (addresses, coordinates, and IP addresses) within the same request for maximum flexibility.
# Response { "bulk": [ { "location": { "location_string": "New York, USA", "country_name": "United States", "state_prov": "New York", "city": "Syracuse", "locality": "Destiny USA Mall", "latitude": "43.06923", "longitude": "-76.17249", "elevation": "128", "timezone": "America/New_York", "timezone_abbreviation": "GMT-5" }, "current": { "timestamp": "2025-11-05T07:45", "temperature_2m": 5.4, "relative_humidity_2m": 75, "apparent_temperature": 2.3, "snowfall": 0, "rain": 0, "showers": 0, "precipitation": 0, "weather_code": 3, "cloud_cover": 100, "pressure_msl": 1014, "surface_pressure": 998.4, "wind_speed_10m": 8.8, "wind_direction_10m": 81, "wind_gusts_10m": 13, "astronomy": { "date": "2025-11-05", "mid_night": "23:48", "night_end": "05:08", "sunrise": "06:43", "sunset": "16:53", "night_begin": "18:28", "sun_status": "-", "solar_noon": "11:48", "day_length": "10:10", "moon_phase": "FULL_MOON", "moonrise": "16:34", "moonset": "06:58", "moon_status": "-" } } }, { "location": { "latitude": "51.50740", "longitude": "-0.12780", "country_name": "", "state_prov": "England", "city": "London", "locality": "", "elevation": "12", "timezone": "Europe/London", "timezone_abbreviation": "GMT" }, "current": { "timestamp": "2025-11-05T12:45", "temperature_2m": 17.2, "relative_humidity_2m": 66, "apparent_temperature": 15.6, "snowfall": 0, "rain": 0, "showers": 0, "precipitation": 0, "weather_code": 3, "cloud_cover": 100, "pressure_msl": 1007.8, "surface_pressure": 1005.9, "wind_speed_10m": 13, "wind_direction_10m": 185, "wind_gusts_10m": 29.9, "astronomy": { "date": "2025-11-05", "mid_night": "23:44", "night_end": "05:07", "sunrise": "06:59", "sunset": "16:28", "night_begin": "18:20", "sun_status": "-", "solar_noon": "11:43", "day_length": "09:29", "moon_phase": "FULL_MOON", "moonrise": "15:51", "moonset": "07:04", "moon_status": "-" } } }, { "location": { "continent_code": "NA", "continent_name": "North America", "country_code2": "US", "country_code3": "USA", "country_name": "United States", "country_name_official": "United States of America", "is_eu": false, "state_prov": "California", "state_code": "US-CA", "district": "Santa Clara", "city": "Mountain View", "zipcode": "94043-1351", "latitude": "37.42240", "longitude": "-122.08421", "locality": "Charleston Terrace", "elevation": "3", "timezone": "America/Los_Angeles", "timezone_abbreviation": "GMT-8" }, "current": { "timestamp": "2025-11-05T04:45", "temperature_2m": 14.1, "relative_humidity_2m": 81, "apparent_temperature": 10.6, "snowfall": 0, "rain": 0, "showers": 0, "precipitation": 0, "weather_code": 2, "cloud_cover": 72, "pressure_msl": 1015.2, "surface_pressure": 1013.8, "wind_speed_10m": 25.4, "wind_direction_10m": 148, "wind_gusts_10m": 51.8, "astronomy": { "date": "2025-11-05", "mid_night": "23:52", "night_end": "05:08", "sunrise": "06:36", "sunset": "17:07", "night_begin": "18:34", "sun_status": "-", "solar_noon": "11:51", "day_length": "10:31", "moon_phase": "FULL_MOON", "moonrise": "17:00", "moonset": "06:56", "moon_status": "-" } } } ] }curl -s -X POST "https://api.apifreaks.com/v1.0/weather/current?apiKey=API-KEY" \ -H "Content-Type: application/json" \ -d '{ "locations": [ { "location": "New York, USA" }, { "lat": 51.5074, "long": -0.1278 }, { "ip": "8.8.8.8" } ] }'
To perform an Live Weather API request through the API, you will need API credits. Credits are only deducted for successful queries, defined by a 2xx status code. If a request results in a 4xx or 5xx status code, no credits will be deducted, and any credits already charged will be refunded.
Utilize the Credits Usage API to efficiently monitor your recent consumption of both one-off and subscription credits. This API provides a streamlined way to track and manage your credit usage, ensuring you stay informed about your remaining balance and can optimize your resource allocation effectively.