Cities

List Global Cities Directory records

List Global Cities Directory records with optional filters and pagination.

Source: Data from GeoNames (geonames.org) via the datasets/world-cities project, licensed CC BY 4.0 (CC BY 4.0).

Fields returned:

  • geonameid (int) — GeoNames unique identifier for the city
  • name (str) — City name
  • country (str) — Country name
  • subcountry (str) — State, province or region

Example: GET /v1/data/global-cities-directory?limit=10&country=example

get/v1/data/global-cities-directory

Request

  • Base URL: https://api.aristocles.com.au (the document declares no server; this is the origin it was published from)
  • URL: https://api.aristocles.com.au/v1/data/global-cities-directory
  • Auth: none declared. Required headers: X-API-Key

Query parameters

limitinteger

Max records to return (1-100).

offsetinteger

Records to skip, for pagination.

countrystring nullable

Country name

Example:example
subcountrystring nullable

State, province or region

Example:example

Headers

X-API-Keystring required

Response

A page of Global Cities Directory records with pagination metadata.

unknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.