destination
Rank the top destinations by travel demand
destination_country (a Country:<code> selector, allowed only with level=city) narrows the ranking to that country’s destination cities.Authorizations
Query Parameters
Origin selector <Level>:<Code> (e.g. Country:US), or global for all origins.
"Country:US"
Start of the departure window (YYYY-MM-DD). Supply together with departure_date_to; omit both for no departure-date filter (all departure dates).
^\d{4}-\d{2}-\d{2}$"2026-07-01"
End of the departure window (YYYY-MM-DD). Supply together with departure_date_from; omit both for no departure-date filter (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 (return_date − dep_date). Round-trips only.
x >= 05
Maximum trip length in nights (must be >= trip_duration_min).
x >= 09
Minimum advance-purchase window in days (dep_date − search_date): keep demand from searches made at least this many days before departure.
x >= 07
Maximum advance-purchase window in days (must be >= search_window_min).
x >= 030
Number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days).
2 <= x <= 9030
Maximum number of result rows. Default 20, max 200.
1 <= x <= 20020
Ranked output granularity: country (default) or city. Applies to destination/market (not audience).
country, city "city"
Destination country selector Country:<code> (e.g. Country:FR). Optional and allowed ONLY together with level=city: it scopes the ranked destinations to a single country so that country’s cities are ranked. Must be a country — a City selector is rejected.
"Country:FR"
Response
Destination demand ranking
