market trend
Demand time series for the top-N source markets
destination. Optional origin_country (a Country:<code> selector, allowed only with level=city) narrows the ranking to that country’s origin cities.Authorizations
Query Parameters
Destination selector <Level>:<Code>. Required for this endpoint.
1"City:PAR"
Start of the departure window (YYYY-MM-DD). Supply together with departure_date_to; omit both (recommended) for no departure-date filter — each bucket then counts searches for all departure dates. A window anchored at the query date counts only long-advance-purchase searches in old buckets and near-departure searches in recent ones, ramping the curve artificially.
^\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.
^\d{4}-\d{2}-\d{2}$"2026-07-31"
Solo, Couple, Group, Family "Couple"
One-Way, Round-Trip "Round-Trip"
x >= 05
x >= 09
x >= 07
x >= 030
Number of buckets N, in the chosen granularity unit (min 2; max depends on granularity: day <= 60, week <= 52, month <= 12; default 12). The series spans the last N complete buckets, excluding the in-progress one (day: last N days ending yesterday; week: last N full Monday-Sunday weeks; month: last N full calendar months).
x >= 212
Bucket size for the returned series: week (default), day, or month.
day, week, month "week"
Ranked output granularity: country (default) or city. Applies to destination/market (not audience).
country, city "city"
Maximum number of series (top-N keys). Default 10, max 50.
1 <= x <= 5010
Origin country selector Country:<code> (e.g. Country:US). Optional and allowed ONLY together with level=city: it scopes the ranked origin markets to a single country so that country’s cities are ranked. Must be a country — a City selector is rejected.
"Country:US"
