World Cities & Countries


Get main and sub-division geo-entities via REST APIs. Get all states, regions and cities in any country worldwide.


€59 / Month Login to upgrade
Remaining Hits: 1,000 (this month from your IP)







            

API Key Info

API KEY:

GUEST_USER

User ID:

-1

Remaining Hits:

1,000 / 1,000 (requests per month)

€59 / Month Login to upgrade

Get Information

Example API call (click, don't be shy):



Get information about a specific subdivision ID. Could also be a direct country code.
https://ezcmd.com/apps/api_ezhigh/get_info/[API_KEY]/[USER_ID]

Get information about a subdivision by entering the lat/lon obtained by the get hierarchy API.
https://ezcmd.com/apps/api_ezhigh/get_info/[API_KEY]/[USER_ID]

GET Parameters:


Mandatory:


country_code=US // A country code. This is the country to get the info for, or designates that this is the country of the subdivision defined by the lat, lon coordinates, obtained by the get hierarchy or get countries APIs.
is_country=true // True or False (lowercase). Designates whether, we're looking for info on a top-level country, or a subdivision of that country.
lon=-121.95418 // Longitude coordinate obtained from the get hierarchy API
lat=37.28033 // Latitude coordinate obtained from the get hierarchy API
q=City of Campbell // A city query (poi_name), helps us to better identify the location to get the info for. You get this from the poi_name parameter on the get hierarchy API.


Optional:


q=City of Campbell // While optional, a city query (poi_name), helps us to better identify the location to get the info for. You get this from the poi_name parameter on the get hierarchy API.

Get Countries

Example API call (click, don't be shy):


Get a list of countries by an optional query

https://ezcmd.com/apps/api_ezhigh/get_countries/[API_KEY]/[USER_ID]

GET Parameters:


Optional:


q=United // A country name or part of a country name, used as search query. If no query is given, returns all countries.

Get Hierarchy Subdivisions

Example API call (click, don't be shy):


Get a list of subdivision hierarchies within a specified parent id and query

Level 1, directly under USA:
https://ezcmd.com/apps/api_ezhigh/get_hierarchy/[API_KEY]/[USER_ID]

Level 2, directly under California: (we're using the California ID we got in the first response)
https://ezcmd.com/apps/api_ezhigh/get_hierarchy/[API_KEY]/[USER_ID]

Level 3, directly under Santa Clara County: (we're using the Santa Clara ID we got in the second response)
https://ezcmd.com/apps/api_ezhigh/get_hierarchy/[API_KEY]/[USER_ID]

Level 3, with a search query: (you can use search queries at any level)
https://ezcmd.com/apps/api_ezhigh/get_hierarchy/[API_KEY]/[USER_ID]

GET Parameters:


Mandatory:


country_code=US // A country code, as returned from Get Countries.
level=1 // Subdivision level. For example a state in the US, is a level 1. Each subdivision will have an ID, and that has to be used as the optional parent_id for subsequent lower level subdivisions.
q=California // A query to search for the subdivision name. If no query is given, returns all subdivisions within the parent


Optional:


parent_id=5332921 // The parent id as returned from calling this API with level=1.

Limits:

Guest Lookups: 1,000 / Month
FREE User Lookups: 10,000 / Month
Premium User Lookups: 999,999,000,000 / Month
€59 / Month Login to upgrade