market trend
Market demand as a time series. Observe how demand from the top source markets varies by day, week, or month
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 (recommended) so every bucket counts searches for all departure dates. Anchoring a window at the query date makes older buckets count only searches made far ahead of travel and recent buckets count only searches made close to travel, which ramps the curve artificially.
^\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"
x >= 05
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 buckets to return, in the chosen granularity unit (minimum 2, default 12). The maximum depends on granularity: up to 60 for day, 52 for week, and 12 for month. The series covers the last complete buckets and skips the one still in progress (day: the last N days ending yesterday; week: the last N full weeks running Monday to Sunday; month: the last N full calendar months).
x >= 212
Size of each bucket in the returned series: week (the default), day, or month.
day, week, month "week"
Granularity of the ranked results: country (the default) or city. Applies to destination and market results, not audience.
country, city "city"
Maximum number of series to return. Default 10, maximum 50.
1 <= x <= 5010
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"
