WeatherAPI.com provides access to weather and geo data via a JSON/XML restful API. It allows developers to create desktop, web and mobile applications using this data very easy.
We provide following data through our API:
- Real-time weather
- 14 day weather forecast
- Historical Weather
- Marine Weather and Tide Data
- Future Weather (Upto 365 days ahead)
- Daily and hourly intervals
- 15 min interval (Enterprise only)
- Astronomy
- Time zone
- Location data
- Sports
- Search or Autocomplete API
- Weather Alerts
- Air Quality Data
- Bulk Request
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.
We also have SDK for popular framework/languages available on Github for quick integrations.
If you find any features missing or have any suggestions, please contact us.
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=YOUR API KEY
Python 2.7 and 3.4+
If the python package is hosted on Github, you can install directly from Github
pip install git+https://github.com/weatherapicom/python.git#egg=weatherapipython(you may need to run pip with root permission: sudo pip install git+https://github.com/weatherapicom/python.git#egg=weatherapipython)
Then import the package:
import weatherapi Install via Setuptools.
python setup.py install --user(or sudo python setup.py install to install the package for all users)
Then import the package:
import weatherapiPlease follow the installation procedure and then run the following:
from __future__ import print_function
import time
import weatherapi
from weatherapi.rest import ApiException
from pprint import pprint
# Configure API key authorization: ApiKeyAuth
configuration = weatherapi.Configuration()
configuration.api_key['key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['key'] = 'Bearer'
# create an instance of the API class
api_instance = weatherapi.APIsApi(weatherapi.ApiClient(configuration))
q = 'q_example' # str | Pass US Zipcode, UK Postcode, Canada Postalcode, IP address, Latitude/Longitude (decimal degree) or city name. Visit [request parameter section](https://www.weatherapi.com/docs/#intro-request) to learn more.
dt = '2013-10-20' # date | Date on or after 1st Jan, 2015 in yyyy-MM-dd format
try:
# Astronomy API
api_response = api_instance.astronomy(q, dt)
pprint(api_response)
except ApiException as e:
print("Exception when calling APIsApi->astronomy: %s\n" % e)All URIs are relative to https://api.weatherapi.com/v1
| Class | Method | HTTP request | Description |
|---|---|---|---|
| APIsApi | astronomy | GET /astronomy.json | Astronomy API |
| APIsApi | forecast_weather | GET /forecast.json | Forecast API |
| APIsApi | future_weather | GET /future.json | Future API |
| APIsApi | history_weather | GET /history.json | History API |
| APIsApi | ip_lookup | GET /ip.json | IP Lookup API |
| APIsApi | marine_weather | GET /marine.json | Marine Weather API |
| APIsApi | realtime_weather | GET /current.json | Realtime API |
| APIsApi | search_autocomplete_weather | GET /search.json | Search/Autocomplete API |
| APIsApi | time_zone | GET /timezone.json | Time Zone API |
- Alerts
- AlertsAlert
- ArrayOfSearch
- Astronomy
- AstronomyAstro
- Current
- CurrentAirQuality
- CurrentCondition
- Error400
- Error401
- Error403
- Forecast
- ForecastAstro
- ForecastCondition
- ForecastDay
- ForecastDayCondition
- ForecastForecastday
- ForecastHour
- Ip
- Location
- Marine
- MarineForecastday
- MarineHour
- Search
- Type: API key
- API key parameter name: key
- Location: URL query string