data

Points of interest, ranked by quality, significance, and knowledge-base grounding

Returns curated POIs (utility/duplicate/tribute/corrupted classes filtered out). Ordering is internal: editorial quality, then significance (world-heritage > national > regional), then strength of knowledge-base grounding, then rating. When city_id is a megacity that has neighborhood children (e.g. New York City), results are automatically rolled up from those children. With no city_id or iso_alpha2 filter, returns a curated sample of verified heritage POIs (scope by city_id or iso_alpha2 for full results).

get/v1/pois

Request

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

Query parameters

city_idstring nullable
iso_alpha2string nullable
has_qidboolean nullable
limitinteger
offsetinteger

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 POI UUID.

namestring required

POI name in source script.

city_idstring required

Parent city UUID. Megacity rollup applies on city_id queries.

city_namestring nullable

Parent city name (denormalised for convenience).

iso_alpha2string nullable

Country code of the parent city.

ratingstring nullable

Source-provided rating (string-typed; precision varies by source).

fsq_categoriesstring nullable

Raw upstream category labels. Deprecated 2026-07-21 — switch to category_normalized.

category_normalizedstring[] nullable

Ordered, deduplicated list of in-house category slugs (e.g. ['do.beach', 'eat.cafe']). First element is the primary category. ~64 leaves across 8 domains (eat / sleep / see / do / shop / move / live / geo). See https://travelminds.ai/docs/category-normalized for the full taxonomy.

wikidata_qidstring nullable

Wikidata QID (e.g. 'Q243') if the POI is grounded.

wikipedia_enstring nullable

English Wikipedia article slug if known.

wikidata_labelstring nullable

Wikidata label used for matching.

sourcestring nullable

Upstream data source (e.g. 'foursquare', 'osm', 'wikidata').

licensestring nullable

License id from the registry (D7 posture).

license_urlstring nullable

Public URL of the license text.

attribution_requiredboolean nullable

True if downstream use must cite the upstream source.

Changes

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