Getting Started

You need to signup and then you can find your API key under your account, and start using API right away!

Try our weather API by using interactive API Explorer or use Swagger Tool.

We also have SDK for popular framework/languages available on Github for quick integrations.

Want to choose which weather field to return in the API response? Change it from API response fields.

If you find any features missing or have any suggestions, please contact us.

Authentication

API access to the data is protected by an API key. If at anytime, you find the API key has become vulnerable, please regenerate the key using Regenerate button next to the API key.

Authentication to the WeatherAPI.com API is provided by passing your API key as request parameter through an API .

key parameter

Request

Request URL

Request to WeatherAPI.com API consists of base url and API method. You can make both HTTP or HTTPS request to our API.

Base URL: http://api.weatherapi.com/v1

Request Parameters

Location Object

Location object is returned with each API response. It is actually the matched location for which the information has been returned.

It returns information about the location including geo points, name, region, country and time zone information as well.

When using Search or Autocomplete API following fields are NOT returned tz_id, localtime_epoch and localtime.

Weather Alerts

Forecast API returns alerts and warnings issued by government agencies (USA, UK, Europe and Rest of the World) as an array if available for the location provided through the Forecast API.

By default alerts are not returned. To get alerts back in the response from Forecast API, pass the parameter alerts=yes.

Note: Some of the alerts may be in local language of the location.

Example response of alerts

                            "alerts":{
    "alert":[
        {
        "headline":"Flood Warning issued January 05 at 9:47PM EST until January 07 at 6:15AM EST by NWS",
        "msgtype":"Alert",
        "severity":"Moderate",
        "urgency":"Expected",
        "areas":"Calhoun; Lexington; Richland",
        "category":"Met",
        "certainty":"Likely",
        "event":"Flood Warning",
        "note":"Alert for Calhoun; Lexington; Richland (South Carolina) Issued by the National Weather Service",
        "effective":"2021-01-05T21:47:00-05:00",
        "expires":"2021-01-07T06:15:00-05:00",
        "desc":"...The Flood Warning continues for the following rivers in South\nCarolina...\nCongaree River At Carolina Eastman affecting Richland, Calhoun\nand Lexington Counties.\nCongaree River At Congaree National Park-Gadsden affecting\nCalhoun and Richland Counties.\nNorth Fork Edisto River At Orangeburg affecting Orangeburg County.\n...The Flood Warning is now in effect until Thursday morning...\nThe Flood Warning continues for\nthe Congaree River At Carolina Eastman.\n* Until Thursday morning.\n* At 9:28 PM EST Tuesday the stage was 115.6 feet.\n* Flood stage is 115.0 feet.\n* Minor flooding is occurring and minor flooding is forecast.\n* Recent Activity...The maximum river stage in the 24 hours ending\nat 9:28 PM EST Tuesday was 118.2 feet.\n* Forecast...The river will rise to 115.7 feet just after midnight\ntonight. It will then fall below flood stage tomorrow morning to\n114.2 feet and begin rising again tomorrow evening. It will rise\nto 114.3 feet early Thursday morning. It will then fall again and\nremain below flood stage.\n* Impact...At 115.0 feet, Flooding occurs in low lying areas of the\nCarolina Eastman Facility and at the Congaree National Park.\n* Flood History...This crest compares to a previous crest of 116.3\nfeet on 12/03/2020.\n&&",
        "instruction":"A Flood Warning means that flooding is imminent or occurring. All\ninterested parties should take necessary precautions immediately.\nMotorists should not attempt to drive around barricades or drive\ncars through flooded areas.\nCaution is urged when walking near riverbanks.\nAdditional information is available at www.weather.gov.\nThe next statement will be issued Wednesday morning at 1000 AM EST."
        },
        {
        "headline":"Flood Warning issued January 05 at 9:47PM EST until January 09 at 4:00AM EST by NWS",
        "msgtype":"Alert",
        "severity":"Moderate",
        "urgency":"Expected",
        "areas":"Calhoun; Richland",
        "category":"Met",
        "certainty":"Likely",
        "event":"Flood Warning",
        "note":"Alert for Calhoun; Richland (South Carolina) Issued by the National Weather Service",
        "effective":"2021-01-05T21:47:00-05:00",
        "expires":"2021-01-09T04:00:00-05:00",
        "desc":"...The Flood Warning continues for the following rivers in South\nCarolina...\nCongaree River At Carolina Eastman affecting Richland, Calhoun\nand Lexington Counties.\nCongaree River At Congaree National Park-Gadsden affecting\nCalhoun and Richland Counties.\nNorth Fork Edisto River At Orangeburg affecting Orangeburg County.\n...The Flood Warning is now in effect until early Saturday morning...\nThe Flood Warning continues for\nthe Congaree River At Congaree National Park-Gadsden.\n* Until late Friday night.\n* At 9:00 PM EST Tuesday the stage was 16.5 feet.\n* Flood stage is 15.0 feet.\n* Minor flooding is occurring and minor flooding is forecast.\n* Recent Activity...The maximum river stage in the 24 hours ending\nat 9:00 PM EST Tuesday was 17.2 feet.\n* Forecast...The river is expected to fall below flood stage early\nFriday morning and continue falling to 12.4 feet Sunday evening.\n* Impact...At 15.0 feet, Flooding begins in the Congaree National\nPark. This will begin to produce flooding of portions of the lower\nboardwalk.\n* Impact...At 17.0 feet, The access road to the Sandy Run\nsubdivision becomes flooded. The lower boardwalk in the Congaree\nNational Park becomes flooded by Cedar Creek.\n* Impact...At 18.0 feet, Several homes in the Sandy Run subdivision\nalong the river become flooded. At 18 feet the river covers the\nWeston Lake overlook in the Congaree National Park. Between 18 and\n18.5 feet the river begins to cover sections of the elevated\nboardwalk.\n* Flood History...This crest compares to a previous crest of 16.3\nfeet on 12/03/2020.\n&&",
        "instruction":"A Flood Warning means that flooding is imminent or occurring. All\ninterested parties should take necessary precautions immediately.\nMotorists should not attempt to drive around barricades or drive\ncars through flooded areas.\nCaution is urged when walking near riverbanks.\nAdditional information is available at www.weather.gov.\nThe next statement will be issued Wednesday morning at 1000 AM EST."
        }
    ]
}
                            
                        

Air Quality Data

Air Quality data is returned in the Forecast API, History API and Realtime API response. Depending upon your subscription plan we provide historical (from 1^st March 2021 onwards), current and 3 day air quality data for the given location in json and xml.

It provides air quality index (see below) data on major pollutant gases like Carbon monoxide (CO), Ozone (O3), Nitrogen dioxide (NO2), Sulphur dioxide (SO2), PM 2.5 and PM 10.

By default air quality data is not returned. To get air quality data back in the response from Forecast API, History API and Realtime API, pass the parameter aqi=yes.

Bulk Request

If you are on Pro+, Business or Enterprise plan then you may use our bulk weather option to send multiple locations to get weather for all the locations sent in a single request.

Each location sent in bulk operation is counted as 1 call. It works for all the API methods except Search API.

For bulk you need to pass in the querysting q=bulk and then pass a json body as POST method with utf-8 encoding. All the the other request parameters will be passed as query as usual.

Thanks to Dzebo Elvis for pointing out that the POST method should be used and not GET.

Json format for sending multiple locations in the POST body.

                            {
    "locations": [
        {
            "q": "53,-0.12",
            "custom_id": "my-id-1"
        },
        {
            "q": "London",
            "custom_id": "any-internal-id"
        },
        {
            "q": "90201",
            "custom_id": "us-zipcode-id-765"
        }
    ]
}
                            
                        

Json format explanation

Bulk Request Example

                        
curl --location --request POST 'http://api.weatherapi.com/v1/current.json?key=YOUR_API_KEY&q=bulk' \
--header 'Content-Type: application/json' \
--data '{
    "locations": [
        {
            "q": "53,-0.12",
            "custom_id": "my-id-1"
        },
        {
            "q": "London",
            "custom_id": "any-internal-id"
        },
        {
            "q": "90201",
            "custom_id": "us-zipcode-id-765"
        }
    ]
}'
                        
                        

Bulk Response

                            {
    "bulk": [
        {
            "query": {
                "custom_id": "my-id-1",
                "q": "53,-0.12",
                "location": {
                    "name": "Boston",
                    "region": "Lincolnshire",
                    "country": "United Kingdom",
                    "lat": 53.0,
                    "lon": -0.12,
                    "tz_id": "Europe/London",
                    "localtime_epoch": 1673620218,
                    "localtime": "2023-01-13 14:30"
                },
                "current": {
                    "last_updated_epoch": 1673620200,
                    "last_updated": "2023-01-13 14:30",
                    "temp_c": 8.7,
                    "temp_f": 47.7,
                    "is_day": 1,
                    "condition": {
                        "text": "Partly cloudy",
                        "icon": "//cdn.weatherapi.com/weather/64x64/day/116.png",
                        "code": 1003
                    },
                    "wind_mph": 24.2,
                    "wind_kph": 38.9,
                    "wind_degree": 260,
                    "wind_dir": "W",
                    "pressure_mb": 1005.0,
                    "pressure_in": 29.68,
                    "precip_mm": 0.0,
                    "precip_in": 0.0,
                    "humidity": 74,
                    "cloud": 75,
                    "feelslike_c": 4.4,
                    "feelslike_f": 39.9,
                    "vis_km": 10.0,
                    "vis_miles": 6.0,
                    "uv": 2.0,
                    "gust_mph": 33.1,
                    "gust_kph": 53.3
                }
            }
        },
        {
            "query": {
                "custom_id": "any-internal-id",
                "q": "London",
                "location": {
                    "name": "London",
                    "region": "City of London, Greater London",
                    "country": "United Kingdom",
                    "lat": 51.52,
                    "lon": -0.11,
                    "tz_id": "Europe/London",
                    "localtime_epoch": 1673620218,
                    "localtime": "2023-01-13 14:30"
                },
                "current": {
                    "last_updated_epoch": 1673620200,
                    "last_updated": "2023-01-13 14:30",
                    "temp_c": 11.0,
                    "temp_f": 51.8,
                    "is_day": 1,
                    "condition": {
                        "text": "Partly cloudy",
                        "icon": "//cdn.weatherapi.com/weather/64x64/day/116.png",
                        "code": 1003
                    },
                    "wind_mph": 23.0,
                    "wind_kph": 37.1,
                    "wind_degree": 270,
                    "wind_dir": "W",
                    "pressure_mb": 1010.0,
                    "pressure_in": 29.83,
                    "precip_mm": 0.0,
                    "precip_in": 0.0,
                    "humidity": 58,
                    "cloud": 75,
                    "feelslike_c": 8.1,
                    "feelslike_f": 46.5,
                    "vis_km": 10.0,
                    "vis_miles": 6.0,
                    "uv": 2.0,
                    "gust_mph": 22.4,
                    "gust_kph": 36.0
                }
            }
        },
        {
            "query": {
                "custom_id": "us-zipcode-id-765",
                "q": "90201",
                "location": {
                    "name": "Bell",
                    "region": "California",
                    "country": "USA",
                    "lat": 33.97,
                    "lon": -118.17,
                    "tz_id": "America/Los_Angeles",
                    "localtime_epoch": 1673620220,
                    "localtime": "2023-01-13 6:30"
                },
                "current": {
                    "last_updated_epoch": 1673620200,
                    "last_updated": "2023-01-13 06:30",
                    "temp_c": 10.0,
                    "temp_f": 50.0,
                    "is_day": 0,
                    "condition": {
                        "text": "Clear",
                        "icon": "//cdn.weatherapi.com/weather/64x64/night/113.png",
                        "code": 1000
                    },
                    "wind_mph": 2.2,
                    "wind_kph": 3.6,
                    "wind_degree": 10,
                    "wind_dir": "N",
                    "pressure_mb": 1020.0,
                    "pressure_in": 30.13,
                    "precip_mm": 0.0,
                    "precip_in": 0.0,
                    "humidity": 74,
                    "cloud": 0,
                    "feelslike_c": 10.3,
                    "feelslike_f": 50.5,
                    "vis_km": 16.0,
                    "vis_miles": 9.0,
                    "uv": 1.0,
                    "gust_mph": 3.6,
                    "gust_kph": 5.8
                }
            }
        }
    ]
}
                            
                        

API Error Codes

If there is an error, API response contains error message including error code for following 4xx HTTP Status codes.

Realtime API

Current weather or realtime weather API method allows a user to get up to date current weather information in json and xml. The data is returned as a Current Object.

Current object contains current or realtime weather information for a given city.

Forecast API

Forecast weather API method returns, depending upon your price plan level, upto next 14 day weather forecast and weather alert as json or xml. The data is returned as a Forecast Object.

Forecast object contains astronomy data, day weather forecast and hourly interval weather information for a given city.

forecastday: Parent element

forecastday -> day: 'day' element inside forecastday contains max/min temperature, average temperature

forecastday -> astro
forecastday -> hour:

History API

History weather API method returns, depending upon your subscription plan level, historical weather for a date on or after 1st Jan, 2010 as json and xml. The data is returned as a Forecast Object.

For Enterprise plan users we also return historical Solar Irradiance (from 1^st Jan 2010 onwards), Evapotranspiration (from 1^st Jan 2010 onwards) and Air Quality data (from 1^st March 2021 onwards).

Forecast object contains astronomy data, day weather forecast and hourly interval weather information for a given city.

forecastday: Parent element

forecastday -> day: 'day' element inside forecastday contains max/min temperature, average temperature

forecastday -> astro
forecastday -> hour:

Marine Weather API

Marine weather API method returns upto next 7 day (depending upon your subscription plan level) marine and sailing weather forecast and tide data (depending upon your price plan level) as json or xml. The data is returned as a Marine Object.

Marine object, depending upon your price plan level, contains astronomy data, day weather forecast and hourly interval weather information and tide data for a given sea/ocean point.

forecastday: Parent element

forecastday -> day: 'day' element inside forecastday contains max/min temperature, average temperature

forecastday -> astro
forecastday -> tide
forecastday -> hour:

Future Weather API

Future weather API method returns weather in a 3 hourly interval in future for a date between 14 days and 300 days from today in the future.

Forecast object contains astronomy data, day weather forecast and hourly interval weather information for a given city.

forecastday: Parent element

forecastday -> day: 'day' element inside forecastday contains max/min temperature, average temperature

forecastday -> astro
forecastday -> hour:

Search/Autocomplete API

WeatherAPI.com Search or Autocomplete API returns matching cities and towns as an array of Location object.

IP Lookup API

IP Lookup API method allows a user to get up to date information for an IP address in json and xml.

Astronomy API

Astronomy API method allows a user to get up to date information for sunrise, sunset, moonrise, moonset, moon phase and illumination in json and xml.

Time Zone API

Time Zone API method allows a user to get up to date time zone and local time information in json and xml.

Sports API

Sports API method allows a user to get listing of all upcoming sports events for football, cricket and golf in json and xml.

Example

WeatherAPI.com API is so easy to implement. Look at following examples on how you can form a request to get data either through a web browser or in your application.

1. So to get current weather for London: JSON: http://api.weatherapi.com/v1/current.json?key=<YOUR_API_KEY>&q=London

XML: http://api.weatherapi.com/v1/current.xml?key=<YOUR_API_KEY>&q=London

2. To get 7 day weather for US Zipcode 07112: JSON: http://api.weatherapi.com/v1/forecast.json?key=<YOUR_API_KEY>&q=07112&days=7

XML: http://api.weatherapi.com/v1/forecast.xml?key=<YOUR_API_KEY>&q=07112&days=7

3. Search for cities starting with Lond: JSON: http://api.weatherapi.com/v1/search.json?key=<YOUR_API_KEY>&q=lond
   XML: http://api.weatherapi.com/v1/search.xml?key=<YOUR_API_KEY>&q=lond

Integrations

We also have SDK for popular framework/languages available on Github for quick integrations.

Weather Icons and Codes

In the JSON response we return a condition:code which is a code for describing weather. For example clear, sunny, etc.

You may retrieve the whole condition list as JSON to implement different weather icons or apply other logic to your application. It also includes multi-language translations of weather condition text.

Multilingual Condition list URL: https://www.weatherapi.com/docs/conditions.json

English Condition list URL (CSV): https://www.weatherapi.com/docs/weather_conditions.csv

English Condition list URL (JSON): https://www.weatherapi.com/docs/weather_conditions.json

English Condition list URL (XML): https://www.weatherapi.com/docs/weather_conditions.xml

Please download the list and use it offline instead of directly linking into your application.

Weather Icons

You are also free to download WeatherAPI.com weather icons and use it in your application or website.
Download Weather Icons (.zip)

Link Back

If you are on our free plan we would appreciate if you could provide a link back to our service.

HTML LINK BACK CODE EXAMPLES

You may choose any of the below HTML code and place it on the website you have provided during the Free plan upgrade.