# GeoDB Cities API

**Provider:** GeoDB Cities
**Category:** maps
**Base URL:** `https://wft-geo-db.p.rapidapi.com/v1`
**Auth:** api-key — `x-rapidapi-key: YOUR_API_KEY`
**Rate Limit:** 10 req/s (free tier via RapidAPI)
**Free Tier:** Yes — available
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://wft-geo-db.p.rapidapi.com/v1

## Description

The GeoDB API focuses on getting global city and region data. Easily obtain country, region, and city data for use
in your apps! 
<ul>
  <li>Filter cities by name prefix, country, location, time-zone, and even minimum population.</li>
  <li>Sort cities by name, country code, elevation, and populatio

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://wft-geo-db.p.rapidapi.com/v1/geo/adminDivisions` | Find administrative divisions |
| GET | `https://wft-geo-db.p.rapidapi.com/v1/geo/adminDivisions/{divisionId}` | Get administrative division details |
| GET | `https://wft-geo-db.p.rapidapi.com/v1/geo/adminDivisions/{divisionId}/nearbyCities` | Find cities near division |
| GET | `https://wft-geo-db.p.rapidapi.com/v1/geo/adminDivisions/{divisionId}/nearbyDivisions` | Find divisions near division |
| GET | `https://wft-geo-db.p.rapidapi.com/v1/geo/cities` | Find cities |
| GET | `https://wft-geo-db.p.rapidapi.com/v1/geo/cities/{cityId}` | Get city details |
| GET | `https://wft-geo-db.p.rapidapi.com/v1/geo/cities/{cityId}/dateTime` | Get city date-time |
| GET | `https://wft-geo-db.p.rapidapi.com/v1/geo/cities/{cityId}/distance` | Get city distance |

## Authentication

API key in the request header (x-rapidapi-key)

```
x-rapidapi-key: YOUR_API_KEY
```

## Sample Request

```bash
curl -X GET 'https://wft-geo-db.p.rapidapi.com/v1/geo/adminDivisions' \
  -H 'x-rapidapi-key: YOUR_API_KEY'
```

## Sample Response

```json
{}
```

## Pricing Details

City and region data (GeoDB). Free: 10 requests/s via RapidAPI (limited data). Basic $0-10/mo on RapidAPI. Uses GraphQL. Backed by GeoDB.io.

---

*Source: [API Map](https://apimap.dev/apis/geodb-cities/) — CC BY 4.0*