API reference/Geo & Places/Geocode

Geocode

freeLive data

Coordinates, population, time zone and admin areas for a place name.

GET/api/v1/geo/geocode

Data source

  • Open-MeteoOpen-Meteo · CC-BY-4.0 · updates Hourly
  • GeoNamesGeoNames · CC-BY-4.0 · updates Daily

Query parameters

ParameterDescriptionTry value
q
string required
Place name
country
string
ISO code filter
limit
number
1–20 (default 5)
apikey
string required
Your API key. Can also be sent as the X-API-Key header.demo key used here

Response envelope

Success: { data, meta: { sources, fetchedAt, cached } }. Errors: { error: { code, message } } with HTTP 400, 401, 404, 502, 503 or 504.