data

Curated cities ranked by a composite desirability score

Filtered by country (iso_alpha2) and minimum score (min_score). The child_city_count and aggregates_neighborhoods markers indicate which rows are megacity rollups (NYC, London, Paris, Tokyo). tier_version pins against a specific quarterly snapshot for reproducibility (default = current; see /v1/cities/tier-versions).

get/v1/cities

Request

  • Base URL: https://api.travelminds.ai
  • URL: https://api.travelminds.ai/v1/cities
  • Auth: none declared

Query parameters

limitinteger
offsetinteger
iso_alpha2string nullable
min_scorenumber nullable
tier_versioninteger nullable

Headers

authorizationstring nullable
x-rapidapi-proxy-secretstring nullable
x-rapidapi-userstring nullable
x-tmai-proxy-secretstring nullable
x-tmai-proxy-providerstring nullable
x-tmai-proxy-userstring nullable

Response

Successful Response

idstring required

Canonical city UUID. Stable across reads.

namestring required

City name in source script (en preferred when both exist).

iso_alpha2string nullable

ISO-3166 alpha-2 country code, uppercase (e.g. 'IN', 'JP').

populationinteger nullable

Latest known population from source metadata.

latitudestring nullable

Decimal degrees, signed (string for arbitrary precision).

longitudestring nullable

Decimal degrees, signed (string for arbitrary precision).

master_scorestring nullable

Composite TMAIV2 master score, rounded to 2dp. Range 0-1.

tierstring nullable

Internal classification tier (e.g. 'tier-1', 'tier-2').

child_city_countinteger nullable

Number of child neighborhoods/boroughs aggregated under this row (W52 rollup).

aggregates_neighborhoodsboolean

True when this is a megacity row that rolls up child neighborhoods (NYC, London, Paris, Tokyo).

licensestring nullable

License id from the registry (D7 posture). See GET /v1/licenses.

license_urlstring nullable

Public URL of the license text.

attribution_requiredboolean nullable

True if downstream use must cite TravelMindsAI / the upstream source.

Changes

No recorded changes to this operation across all 1 revision of this API.