UnifyAPI
← Back to catalog

geonames.postal.lookup

mock data$0.001 / call

GeoNames Postal Code Lookup

Look up postal / ZIP codes and their place names across 100+ countries using the GeoNames database. Search by postal code (e.g. "10001" for NYC, "SW1A 1AA" for London, "75001" for Paris) or by place name. Returns matching postal codes with lat/lng, admin area names, and ISO-3166-2 subdivision codes. Use the country filter (ISO-3166 2-letter) to narrow results. Covers US, UK, Germany, France, Australia, Canada, Japan, India, Brazil, and 90+ more. CC BY 4.0 open data, no upstream cost.

Geo & Mapsprovider: Geonames#geonames#geo

Input schema

country

ISO-3166 2-letter country code to restrict the postal code search (e.g. "US", "GB", "DE")

string
max_rows

Maximum number of results to return (default 10, max 1000)

integer
place_name

Place or city name to search postal codes for (e.g. "Berlin", "Sydney"). Use with country for best results.

string
postal_code

Postal / ZIP code to look up (e.g. "10001" for New York, "SW1A 1AA" for London)

string

Call via REST

curl -X POST https://unifyapi.pro/api/call/geonames.postal.lookup \
  -H "Authorization: Bearer uak_live_..." \
  -H "Content-Type: application/json" \
  -d '{"country":"<country>","max_rows":0,"place_name":"<place_name>","postal_code":"<postal_code>"}'

Try it

Paste a UnifyAPI key (create one in the dashboard) and run a real call.