Timezone API

The Timezone API provides timezone and time offset data for any latitude/longitude coordinates or city in the world.

/v1/timezone GET

https://api.api-ninjas.com/v1/timezone

Get timezone info by city/state/country or location coordinates (latitude/longitude). Returns the timezone name of the specified input location and the time offset in seconds.


Parameters

  • lat  required

    Latitude of desired location.

  • lon  required

    Longitude of desired location.

  • — or —
  • city  required premium

    City name.

  • state  optional premium

    US state (for United States cities only).

  • country  optional premium

    Country name.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

city
https://api.api-ninjas.com/v1/timezone?city=London

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 { "timezone": "Europe/London", "utc_offset": 0, "city": "london" }

Code Examples

1 2 3 4 5 6 7 8 9 import requests city = 'london' api_url = 'https://api.api-ninjas.com/v1/timezone?city={}'.format(city) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.