Skip to main content
GET
/
cities
/
nearby
Find cities near a coordinate
curl --request GET \
  --url https://api.ceibo.me/v1/cities/nearby \
  --header 'x-api-key: <api-key>'
[
  {
    "id": 1,
    "name": "Buenos Aires",
    "countryId": 10,
    "location": {
      "latitude": -34.603722,
      "longitude": -58.381592
    },
    "zoom": 12,
    "isCapital": true,
    "createdAt": "2024-01-15T10:30:00.000Z",
    "description": "Capital and largest city of Argentina",
    "imageUrl": "https://cdn.ceibo.me/cities/buenos-aires.jpg",
    "timezone": "America/Argentina/Buenos_Aires"
  }
]

Authorizations

​
x-api-key
string
header
required

API key minted at developer.ceibo.me. Send on every request.

Query Parameters

​
latitude
number<double>
required
​
longitude
number<double>
required
​
radiusKm
number
default:50
Required range: 0.1 <= x <= 500
​
limit
integer
default:20
Required range: 1 <= x <= 100

Response

Cities within range, ordered by distance.

​
id
integer
required
Example:

1

​
name
string
required
Example:

"Buenos Aires"

​
countryId
integer
required
Example:

10

​
location
object
required
​
zoom
integer
required
Example:

12

​
isCapital
boolean
required
Example:

true

​
createdAt
string<date-time>
required
Example:

"2024-01-15T10:30:00.000Z"

​
description
string | null
Example:

"Capital and largest city of Argentina"

​
imageUrl
string | null
Example:

"https://cdn.ceibo.me/cities/buenos-aires.jpg"

​
timezone
string | null
Example:

"America/Argentina/Buenos_Aires"