Skip to content

Static content

Reference lookups for building a search UI and for storing our hotel catalogue by city: airports, airlines, cities and hotels.

  1. Endpoints
  2. Caching

Endpoints

GET /v1/content/airports, /v1/content/airlines and /v1/content/cities accept a search term, a country filter and paging — handy for typeahead and for turning a city into its cityCode. GET /v1/content/hotels lists a city’s properties by cityCode (and optionally a name of at least three characters), 50 per page, at most 20 pages per query — page through the cities you sell and store the hotelCodes; there is no whole-country or whole-catalogue listing. All require the content.read scope, which every key has, and count against your rate limit and daily quota like any other call.

Caching

Airports, airlines and cities change slowly — cache them for a day if you use them. The hotel list per city is yours to store and to match names against; refresh it periodically so new properties and code changes reach you. The catalogue and its images are licensed to us and stay ours.