GOgojinko
Demand

Rank traveler audiences for a destination

Ranks traveler audiences by current demand share (a point-in-time snapshot). Requires destination.

get/v1/audience

Request

  • Base URL
    https://api.gojinko.com
  • URL
    https://api.gojinko.com/v1/audience
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Query parameters

originstring

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

Example:Country:US
destinationstring required

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

Example:City:PAR
departure_date_fromstring

Start of the departure window (YYYY-MM-DD). Supply together with departure_date_to; omit both for no departure-date filter (all departure dates).

Example:2026-07-01
departure_date_tostring

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

Example:2026-07-31
traveler_type'Solo' | 'Couple' | 'Group' | 'Family'
Example:Couple
trip_type'oneway' | 'roundtrip'
Example:roundtrip
trip_duration_mininteger nullable

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

Example:5
trip_duration_maxinteger nullable

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

Example:9
search_window_mininteger nullable

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

Example:7
search_window_maxinteger nullable

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

Example:30
snapshot_window_daysinteger

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; data is kept for 90 days).

Example:30
limitinteger

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

Example:20

Response

Audience demand ranking

Example response

{
  "rows": [
    {
      "rank": 1,
      "audience": "Couple",
      "share": 0.37
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.