cities

4 endpoints at a glance

Method	Path	Summary
GET	/locations/cities	List Cities
GET	/locations/cities/{geoname_id}	Get City
GET	/locations/cities/{geoname_id}/history	Get City History
GET	/locations/cities/countries	List Country Counts

cities

---

List Cities

GET

/locations/cities

Paginated city search. Returns {rows, total, limit, offset}.

Parameters

Header Parameters

authorization

Query Parameters

q

country

admin1

min_population

limit

Type

integer

Maximum

200

Minimum

1

Default

25

offset

Type

integer

Minimum

0

Default

0

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/locations/cities

Playground

Headers

authorization

Variables

Key

Value

q

country

admin1

min_population

limit

offset

Samples

---

List Country Counts

GET

/locations/cities/countries

[{country_code, count}] for the country dropdown.

Parameters

Header Parameters

authorization

Responses

Successful Response

Content-Type

application/json

[

  

{

  

  

"additionalProperties": "string"

  

}

]

GET

/locations/cities/countries

Playground

Headers

authorization

Samples

---

Get City

GET

/locations/cities/{geoname_id}

One city plus its nearest neighbours (self excluded).

Parameters

Header Parameters

authorization

Path Parameters

geoname_id*

Type

integer

Required

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/locations/cities/{geoname_id}

Playground

Headers

authorization

Variables

Key

Value

geoname_id*

Samples

---

Get City History

GET

/locations/cities/{geoname_id}/history

Per-city change history (most recent first).

Parameters

Header Parameters

authorization

Path Parameters

geoname_id*

Type

integer

Required

Query Parameters

skip

Type

integer

Minimum

0

Default

0

limit

Type

integer

Maximum

500

Minimum

1

Default

100

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/locations/cities/{geoname_id}/history

Playground

Headers

authorization

Variables

Key

Value

geoname_id*

skip

limit

Samples

---