Geo Lookup DB
A fast, global geographic data API providing access to over 9 million places worldwide. Built on the GeoNames database, Geo Lookup DB delivers geographic data including cities, countries, administrative divisions, timezones, postal codes and natural features like mountains, lakes, streams and hills across the world. --- ## Features - Access over 4 million cities, towns, and villages worldwide -…
Geo Lookup DB endpoints
| Method | Endpoint | Description |
|---|---|---|
| Cities | ||
| GET |
Cities /api/v1/cities |
Search and filter cities (populated places) by name, country, population, or geographic location. Supports prefix search, contains search, and radius-based geographic filtering. |
| GET |
City by ID /api/v1/cities/{id} |
Retrieve detailed information for a specific city by its GeoNames ID |
| GET |
Region by City /api/v1/cities/{id}/region |
Retrieve the region (state, province, admin division 1) that contains a specific city |
| GET |
Admin Divisions by City /api/v1/cities/{id}/admin-divisions |
Retrieve all administrative divisions (ADM1-4) that contain a specific city, ordered by level (ADM1 first) |
| Admin Divisions | ||
| GET |
Admin Divisions /api/v1/admin-divisions |
Search and filter administrative divisions (states, provinces, counties, districts) by name, country, population, type, or geographic location. |
| GET |
Admin Division by ID /api/v1/admin-divisions/{id} |
Retrieve detailed information for a specific administrative division by its GeoNames ID |
| GET |
Cities by Admin Division /api/v1/admin-divisions/{id}/cities |
Retrieve all cities within a specific administrative division (state, province, county, etc.) |
| Countries | ||
| GET |
Countries /api/v1/countries |
Retrieve a paginated list of countries with optional filtering by name prefix or continent. |
| GET |
Country by ID /api/v1/countries/{id} |
Retrieve detailed information about a single country by its ISO2 code, including capital, currency, phone code, and neighboring countries. |
| GET |
Regions by Country /api/v1/countries/{id}/regions |
Retrieve a paginated list of administrative regions (states, provinces, etc.) within a country. |
| GET |
Cities by Country /api/v1/countries/{id}/cities |
Retrieve a paginated list of all cities within a country, with optional filtering by name, population, proximity, and sorting. |
| GET |
Admin Divisions by Country Region /api/v1/countries/{id}/regions/{region}/admin-divisions |
Retrieve a paginated list of administrative divisions (counties, districts, etc.) within a specific region of a country. |
| GET |
Cities by Country Region /api/v1/countries/{id}/regions/{region}/cities |
Retrieve a paginated list of cities within a specific region of a country. |
| GET |
Timezones by Country /api/v1/countries/{id}/timezones |
Retrieve a paginated list of timezones within a specific country, with optional filtering by timezone ID or UTC offset range. |
| Postal Codes | ||
| GET |
Postal Codes /api/v1/postal-codes |
Search postal codes worldwide with filtering by country, postal code prefix, place name, and admin divisions. Supports sorting and pagination. |
| Places | ||
| GET |
Places Within Bounds /api/v1/places/within-bounds |
Search for geographic places within a rectangular bounding box defined by min/max latitude and longitude. Maximum bounding box area depends on your subscription tier: PRO (10,000… |
| GET |
Nearby Places /api/v1/places/nearby |
Search for geographic places within a radius of a given point. Returns places sorted by distance from the center point. |
| Timezones | ||
| GET |
Timezone by IANA ID /api/v1/timezones/iana/{timezone_id} |
Retrieve detailed information about a timezone using its IANA timezone identifier (e.g., America/New_York, Europe/London). |
| GET |
Timezones /api/v1/timezones |
Retrieve a paginated list of timezones with optional filtering by country, timezone ID, or UTC offset range. |
Geo Lookup DB pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $15 / month | 5 / second |
|
| ULTRA | $50 / month | 10 / second |
|
| MEGA | $100 / month | 20 / second |
|