Skip to main content
GET
Rank traveler audiences for a destination
Ranks traveler audiences by current demand share (a point-in-time snapshot). 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 for no departure-date filter (all departure dates).

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 (all departure dates).

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

Minimum trip length in nights (return_date − dep_date). Round-trips only.

Required range: x >= 0
Example:

5

trip_duration_max
integer | null

Maximum trip length in nights (must be >= trip_duration_min).

Required range: x >= 0
Example:

9

search_window_min
integer | null

Minimum advance-purchase window in days (dep_date − search_date): keep demand from searches made at least this many days before departure.

Required range: x >= 0
Example:

7

search_window_max
integer | null

Maximum advance-purchase window in days (must be >= search_window_min).

Required range: x >= 0
Example:

30

snapshot_window_days
integer

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

Required range: 2 <= x <= 90
Example:

30

limit
integer
default:20

Maximum number of result rows. Default 20, max 200.

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

20

Response

Audience demand ranking

rows
object[]
required