market
For a given destination (city or country), where the demand comes from (city or country), as a % share of total demand
destination. The optional origin_country selector (Country:<code>, allowed only when level=city) narrows the ranking to the cities of that country.Authorizations
Query Parameters
Where travelers want to go. Accepts a city or a country as <Level>:<Code> (for example City:PAR or Country:FR). Required for this endpoint.
1"City:PAR"
Start of the departure window, written as YYYY-MM-DD. Provide it together with departure_date_to, or omit both to include all departure dates.
^\d{4}-\d{2}-\d{2}$"2026-07-01"
End of the departure window, written as YYYY-MM-DD. Provide it together with departure_date_from, or omit both to include all departure dates.
^\d{4}-\d{2}-\d{2}$"2026-07-31"
Solo, Couple, Group, Family "Couple"
One-Way, Round-Trip "Round-Trip"
Minimum trip length, in nights between departure and return. Applies to round trips only.
x >= 05
Maximum trip length in nights. Must be greater than or equal to trip_duration_min.
x >= 09
The search window is how many days before the departure date a search was made. Sets the lower bound: keeps only demand from searches made at least this many days before departure.
x >= 07
The search window is how many days before the departure date a search was made. Sets the upper bound: keeps only demand from searches made at most this many days before departure. Must be greater than or equal to search_window_min.
x >= 030
Number of recent days of search activity combined into the demand figure (minimum 2, default 7, maximum 90). A single day covers just the current day, whose data is still incomplete. Up to 90 days of history are available.
2 <= x <= 9030
Maximum number of result rows to return. Default 20, maximum 200.
1 <= x <= 20020
Granularity of the ranked results: country (the default) or city. Applies to destination and market results, not audience.
country, city "city"
Restricts the ranked origin markets to the cities of a single country, given as Country:<code> (for example Country:US). Optional, and allowed only when level=city. Must be a country; a city selector is rejected.
"Country:US"
Response
Market demand ranking
