Endpoints

GET /place

Looks up a settlement by name. Parameters: q (required), country (optional, ISO-3166 alpha-2), limit (default 10, max 50).

GET /postal

Resolves a postal code to place and region. Parameters: code, country.

GET /timezone

Returns the IANA time zone for a place or coordinate pair. Parameters: place or lat+lon.

EndpointCacheTypical latency
/place24 h35 ms
/postal24 h30 ms
/timezone7 d20 ms

Response fields

All responses include request_id and cached. Field names are stable; new fields may be added without notice, so parse defensively.