Can I use the Geocoding API for commercial purposes?

Yes, but you must have a premium subscription. Commercial use of the Geocoding API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.

How do I get an API key and start using the Geocoding API?

Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.

What happens if I exceed my quota for the month?

Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page .

What happens if a request to the Geocoding API fails?

The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.

What are some use cases for the Reverse Geocoding API?

It is ideal for translating raw GPS or device lat / lon coordinates into human-readable place names for ride-sharing apps, delivery tracking, store locators, and analytics dashboards. For the opposite direction (turning a place name into coordinates), use the Geocoding API .

How do I query a location by coordinates?

Send a GET request to the /v1/reversegeocoding endpoint with the required lat and lon query parameters, for example ?lat=40.7128&lon=-74.0060 . See the pricing page for request limits per plan.

What does the Reverse Geocoding API response include?

It returns the nearest place to your coordinates: its name , administrative regions, country details, timezone, population, elevation and more, all in one response. See the Response section above for the full field list.

Can I get coordinates from an IP address or find the time zone for a location?

Every Geocoding and Reverse Geocoding result already includes the location's timezone . To start from a visitor's IP address instead of coordinates, use the IP Lookup API .

How do I disambiguate a city when the same name exists in multiple countries?

Pass the country parameter alongside city — it accepts a country name, a 2-letter ISO code, or a 3-letter ISO code (for example country=GB for London). For United States cities you can further narrow results with the state parameter or a 5-digit zipcode . Browse related location tools in the API catalog .

What fields does the Geocoding response include?

Each result includes the place name , latitude and longitude , enriched with administrative regions, country details, timezone, population and more. See the Response section above for the full field list; failed requests return an error as described in our error codes documentation.

How do I convert coordinates back into a city name?

Use the /v1/reversegeocoding endpoint with lat and lon ; it returns the nearest place with the same enriched fields as forward geocoding.

Can I get more detail about a city beyond its coordinates?

Yes. Every result is enriched with administrative regions, country details, timezone, population, elevation and more, so you usually don't need a second lookup. See the Response section above for the full field list.

Geocoding & Reverse Geocoding API

The Geocoding API converts between place names and geographic coordinates in both directions. It resolves cities, towns, and US ZIP codes — not street addresses.

Every lookup returns the administrative hierarchy with ISO 3166-2 codes, IANA timezone, population and elevation, and country context such as currency, calling code, languages and EU/EEA membership — plus alternative coordinate formats including Plus Codes and geohash. Premium subscribers additionally receive climate zone, degree of urbanisation and the nearest airport.

Available endpoints:

/v1/geocoding - Convert a city, state, or US ZIP code to latitude and longitude coordinates
/v1/reversegeocoding - Convert latitude and longitude coordinates to the nearest city, state, and country

Online

(4.5)

From 2,473 users

700+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average	P50	P75	P90	P95
194ms	239ms	287ms	671ms	873ms

Similar APIs

City Zip Code Timezone Country

Didn't find what you were looking for? Suggest an improvement

2 endpoints

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

Get current city coordinates by city and country name.

Parameters

At least one of the following parameters must be set:

city required
City name.
state optional
US state (for United States cities only).
country optional
Country name, 2-letter ISO country code, or 3-letter ISO country code.
zipcode optional
5-digit zipcode (for United States cities only).

Headers

X-Api-Key required
API Key associated with your account.

Response

The /v1/geocoding endpoint returns a JSON array of objects, each with the following fields, or an error if the request is unsuccessful.

Core

name
The name of the matched place.
latitude
Latitude coordinate in WGS 84 decimal degrees.
longitude
Longitude coordinate in WGS 84 decimal degrees.
country
2-letter ISO 3166-1 alpha-2 country code.
state
State, province or region of the place.

Place

admin1_name
First-level administrative division — state, province or region (e.g. England).
admin1_iso
ISO 3166-2 code for that division (e.g. GB-ENG).
admin2_name
Second-level division — county or equivalent.
timezone
IANA timezone name (e.g. Europe/London).
population
Population of the matched place.
elevation_m
Elevation of the matched place in metres.

Country

country_name
Full country name.
iso3
ISO 3166-1 alpha-3 country code.
iso_numeric
ISO 3166-1 numeric country code.
capital
Capital city.
continent
Two-letter continent code.
region
UN M49 region name.
subregion
UN M49 sub-region name.
currency
ISO 4217 currency code.
currency_name
Currency name.
calling_code
International dialling prefix (e.g. +44).
languages
Comma-separated BCP-47 language tags.
tld
Country-code top-level domain.
driving_side
left or right.
is_eu
Whether the country is an EU member state.
is_eea
Whether the country is in the European Economic Area.

Coordinate formats

plus_code
Open Location Code (Plus Code) for the coordinate.
geohash
9-character geohash.
dms
Degrees/minutes/seconds strings for latitude and longitude.
mercator
Web Mercator (EPSG:3857) x and y in metres.
antipode
The point diametrically opposite on the globe.
hemisphere
North/south and east/west indicators.
qibla_degrees
Bearing to the Kaaba in Mecca, degrees clockwise from true north.
sun
Sunrise, sunset, solar noon and twilight times for today (UTC).

Environment

climate_zone Premium only
Köppen-Geiger climate code (e.g. Cfb).
climate_zone_name Premium only
Human-readable climate classification.
urbanisation Premium only
GHSL degree-of-urbanisation class, from URBAN_CENTRE through VERY_LOW_DENSITY_RURAL to WATER.
urbanisation_name Premium only
Human-readable urbanisation class.
is_land Premium only
Whether the coordinate is on land. Inland water counts as not land.
nearest_airport Premium only
Nearest IATA-coded airport, with distance and bearing.

United States only

county Premium only
US county.
zip_code Premium only
US ZIP code of the matched place. See zip_code_accuracy; this is not a point-in-polygon result.
zip_code_accuracy Premium only
How zip_code was derived: exact, place_centroid or nearest.
area_codes Premium only
US telephone area codes serving the location.

Live Demo

Live demo · no API key required

Query parameters

city

state

country

zipcode

Get a free API key to get started — no credit card required.

Headers

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

GET

https://api.api-ninjas.com/v1/geocoding?city=London&country=GB

Sample response

[

{

"name": "London",

"latitude": 51.5074456,

"longitude": -0.1277653,

"country": "GB",

"state": "England",

"admin1_name": "England",

"admin1_iso": "GB-ENG",

"admin2_name": "Greater London",

"timezone": "Europe/London",

"population": 8961989,

"elevation_m": 25,

"country_name": "United Kingdom",

"iso3": "GBR",

"capital": "London",

"continent": "EU",

"region": "Europe",

"currency": "GBP",

"calling_code": "+44",

"languages": "en-GB,cy-GB,gd",

"driving_side": "left",

"is_eu": false,

"plus_code": "9C3XGV4C+XV",

"geohash": "gcpvj0duw",

"climate_zone": "Cfb",

"climate_zone_name": "Temperate, no dry season, warm summer",

"urbanisation": "URBAN_CENTRE",

"is_land": true,

"nearest_airport": {

"name": "London City Airport",

"iata": "LCY",

"icao": "EGLC",

"country": "GB",

"municipality": "London",

"type": "medium_airport",

"scheduled_service": true,

"latitude": 51.505299,

"longitude": 0.055278,

"elevation_m": 6,

"distance_km": 12.67,

"bearing_degrees": 91

"county": null,

"zip_code": null,

"zip_code_accuracy": null,

"area_codes": null

}

]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/geocoding?city=London&country=GB" \
  -H "X-Api-Key: YOUR_API_KEY"

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.

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

Returns a list of cities that contain a given latitude and longitude.