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.
| Endpoint | Cache | Typical latency |
|---|---|---|
| /place | 24 h | 35 ms |
| /postal | 24 h | 30 ms |
| /timezone | 7 d | 20 ms |
Response fields
All responses include request_id and cached. Field names are stable; new fields may be added without notice, so parse defensively.