Standard APIGET /v1/current

Current Weather API

Live weather conditions for any location on Earth, updated every few minutes.

Query real-time temperature, humidity, wind speed and direction, UV index, pressure, visibility, precipitation, and air quality for any city, postcode, GPS coordinate, or IP address. Our AI layer validates readings against multiple data sources and flags anomalies, so you always receive reliable data your users can trust.

What You Get with the Current Weather API

Global coverage

Over 2 million locations worldwide including cities, towns, remote coordinates, US/UK postal codes, and IATA airport codes.

AI-validated readings

Every data point passes through anomaly detection to catch sensor errors before they reach your application.

Units your users expect

Choose metric (°C, km/h), imperial (°F, mph), or both in a single request — no client-side conversion needed.

Air quality included

Add aqi=yes to receive PM2.5, PM10, CO, NO₂, O₃ and the US EPA air quality index alongside weather data.

Multi-language support

Return condition text in over 60 languages via the lang parameter — ideal for internationalised apps.

Millisecond response times

Responses are served from edge nodes close to your users, keeping latency low even under high request volumes.

Who Uses This API

From startups to enterprise teams, the Current Weather API powers a wide range of real-world applications.

Weather widgets & dashboards

Embed a live weather card in any website, app, or digital signage display using a single API call.

Travel & booking platforms

Show current conditions at a destination before and during a user's trip, reducing support queries about local weather.

Smart home & IoT devices

Trigger automations — close blinds, adjust thermostats, start irrigation — based on live outdoor conditions.

Fitness & outdoor apps

Display temperature, UV index, and air quality to help users decide whether to exercise outdoors safely.

Request Parameters

ParameterTypeRequiredDescriptionExample
qstringRequiredLocation — city name, lat/lon, postal code, IP address, or IATA codeLondon
unitsstringOptionalUnit system: metric | imperial | both (default: both)metric
aqistringOptionalInclude air quality data: yes | noyes
langstringOptionalLanguage code for condition textfr

Authenticate every request with the X-API-Key header.

Code Example

Request

cURL
curl "https://api.weatherai.io/v1/current?q=London&units=metric&aqi=yes" \
  -H "X-API-Key: your-api-key"

Response

200 OKapplication/json
{
  "location": { "name": "London", "country": "UK", "lat": 51.52, "lon": -0.11, "timezone": "Europe/London" },
  "temperature": { "celsius": 14, "feelsLike": { "celsius": 12 } },
  "condition": { "text": "Partly cloudy", "icon": "//cdn.weatherapi.com/weather/64x64/day/116.png", "code": 1003 },
  "wind": { "kph": 19, "direction": "SW", "degree": 225 },
  "humidity": 71,
  "visibility": { "km": 10 },
  "pressure": { "mb": 1015 },
  "precipitation": { "mm": 0 },
  "uv": 3,
  "lastUpdated": "2024-04-24 14:15",
  "airQuality": { "pm2_5": 12.3, "usEpaIndex": 1 }
}

Response Fields

FieldTypeDescription
location.namestringLocation name
location.lat / lonnumberCoordinates
location.timezonestringIANA timezone identifier
temperature.celsius / fahrenheitnumberCurrent temperature
temperature.feelsLikeobjectFeels-like temperature
condition.textstringLocalised condition description
condition.iconstringCDN URL to condition icon
wind.kph / mphnumberWind speed
wind.directionstringCardinal direction (e.g. SW)
humiditynumberRelative humidity %
uvnumberUV index (0–11+)
airQualityobjectPM2.5, EPA index, and more (if aqi=yes)

Start Using the Current Weather API Today

Create a free account and get your API key in under a minute. 1,000 free calls per day. No credit card required.

Get Your Free API Key