Skip to main content
GET
Demand time series per traveler-type segment
Returns a series for each traveler-type segment (excluding Unknown) for the given destination. Requires destination.

Authorizations

X-API-Key
string
header
required

Query Parameters

origin
string

Origin selector <Level>:<Code> (e.g. Country:US), or global for all origins.

Example:

"Country:US"

destination
string
required

Destination selector <Level>:<Code>. Required for this endpoint.

Minimum string length: 1
Example:

"City:PAR"

departure_date_from
string

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.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-07-01"

departure_date_to
string

End of the departure window (YYYY-MM-DD). Supply together with departure_date_from; omit both for no departure-date filter.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-07-31"

traveler_type
enum<string>
Available options:
Solo,
Couple,
Group,
Family
Example:

"Couple"

trip_type
enum<string>
Available options:
One-Way,
Round-Trip
Example:

"Round-Trip"

trip_duration_min
integer | null
Required range: x >= 0
Example:

5

trip_duration_max
integer | null
Required range: x >= 0
Example:

9

search_window_min
integer | null
Required range: x >= 0
Example:

7

search_window_max
integer | null
Required range: x >= 0
Example:

30

trend_window
integer

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).

Required range: x >= 2
Example:

12

granularity
enum<string>

Bucket size for the returned series: week (default), day, or month.

Available options:
day,
week,
month
Example:

"week"

limit
integer
default:10

Maximum number of series (top-N keys). Default 10, max 50.

Required range: 1 <= x <= 50
Example:

10

Response

Per-segment time series

granularity
string
required
Example:

"week"

from
string
required
Example:

"2026-06-19"

to
string
required
Example:

"2026-06-25"

series
object[]
required