World Postal Codes
Worldwide postal code search REST API. Nearest postal codes within a given distance. Find zip / postal code for a given place.
€59 / Month Login to upgrade
Find a street address
1 · Country *
2 · County / State
3 · City *
4 · Street
Start anywhere — pick a city or a street and everything above it fills itself in. Every suggestion is a name that exists.
Remaining Hits: 474 (this month from your IP)
API Key Info
Get nearby locations for given lat,long coordinates
What is it ?
Returns all neighbouring locations worldwide for a given pair of lat,long coordinates.
Example API call (click, don't be shy):
http://ezcmd.com/apps/api_ezip_locator/nearby_locations_by_coords/[API_KEY]/[USER_ID]
GET Parameters:
Mandatory:
coords=41.701627,-87.698364 // Latitude and Longitude pair of coordinates separated by comma.
Optional:
within=150 // The distance radius to search for neighbouring places within.
unit=Miles // Either Miles or Km (please mind the upper-case M and K).
group=place_name // Avoid duplicate results by grouping your results by any of the returned fields. Default grouping is by place_name. Group by id to get all zip codes.
start=0 // The results are paginated. The start offset. Limit is always 100.
Get nearby locations for MANY lat,long pairs in one call (bulk)
What is it ?
The same as above, for up to 50 coordinate pairs per call. Each pair answers on its own under results, keyed by the pair as you sent it, with its own success. Each pair counts as one lookup.
Example API call:
POST http://ezcmd.com/apps/api_geo_postal_codes/nearby_locations_by_coords_bulk/[API_KEY]/[USER_ID]
Parameters (POST or GET):
Mandatory:
coords=41.701627,-87.698364;44.4268,26.1025 // Pairs separated by ; (or | or a new line). coords[] as an array works too.
Optional:
within=25 // The distance radius to search within (max 100).
unit=Km // Either Miles or Km (please mind the upper-case M and K).
limit=5 // Places returned per pair, nearest first (1..20).
Get nearby locations for given zip / postal code
What is it ?
Returns all neighbouring locations worldwide for a given zip / postal code and country code.
Example API call (click, don't be shy):
http://ezcmd.com/apps/api_geo_postal_codes/nearby_locations_by_zip_code/[API_KEY]/[USER_ID]
GET Parameters:
Mandatory:
zip_code=75050 // The zip code you want to get neighbours for
country_code=US // The country code you want to get neighbours for
Optional:
within=150 // The distance radius to search for neighbouring places within.
unit=Miles // Either Miles or Km (please mind the upper-case M and K).
group=place_name // Avoid duplicate results by grouping your results by any of the returned fields. Default grouping is by place_name. Group by id to get all zip codes.
start=0 // The results are paginated. The start offset. Limit is always 100.
Address & Postal Code Search
What is it ?
Finds a street address, and the postal codes of the town it is in, by naming the parts.
Country and city are filters, so the street is found exactly instead of guessed at.
Street-level results come back in address_results, postal codes in search_results.
Example API call (click, don't be shy):
http://ezcmd.com/apps/api_geo_postal_codes/search/[API_KEY]/[USER_ID]?country=RO&state=Bacau&city=Bacau&street=Strada Mioritei
GET Parameters:
Mandatory:
country=RO // Country code or country name.
city=Bacau // Town or city. Matched whole, in any spelling, with or without diacritics.
Optional:
state=Bacau // County or state. Narrows the town, and settles it when two towns share a name.
street=Strada Mioritei // Matched exactly, as a whole street name.
Legacy:
zip_query=Santa Clara California US // One box of words, kept working for callers written against it. It cannot tell a town from a street that shares its name, so name the parts instead.
Suggestions, for building a form (click):
http://ezcmd.com/apps/app_geo_postal_codes/suggest?field=city&term=bac&country=RO
field = country | city | state | street. Every name it offers is one that exists in the index. Not billed.
Place Search (by name, anywhere)
What is it ?
Finds places by name from one box of text: towns, villages, counties and countries, worldwide.
Names match as they are typed, with or without diacritics, and in any language the place is known by, so zala already finds Zalău.
The biggest place comes first, and every result carries its coordinates, so a map can fly straight to it.
Example API call (click, don't be shy):
http://ezcmd.com/apps/api_geo_postal_codes/search_places/[API_KEY]/[USER_ID]?q=zalau
GET Parameters:
Mandatory:
q=zalau // The name, or the beginning of the name, of a place.
Optional:
country=RO // Two-letter country code, to search inside one country only.
limit=10 // How many places to return, 1 to 25. Ten by default.
Answers with:
place_results // name, state, province, country_name, country_code, lat, lon, feature_code, population, timezone.
Limits:
| Guest Lookups: | 1,000 / Month |
| FREE User Lookups: | 100,000 / Month |
| Premium User Lookups: | 999,999,000,000 / Month
€59 / Month Login to upgrade
|