GOgojinko
Demand

Rank origin markets feeding a destination

Ranks origin markets by current demand share (a point-in-time snapshot). Requires destination. Optional origin_country (a Country:<code> selector, allowed only with level=city) narrows the ranking to that country’s origin cities.

get/v1/market

Request

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

Query parameters

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
level'country' | 'city'

Ranked output granularity: country (default) or city. Applies to destination/market (not audience).

Example:city
origin_countrystring

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.

Example:Country:US

Response

Market demand ranking

Example response

{
  "rows": [
    {
      "rank": 1,
      "market": "Country:US",
      "share": 0.214
    }
  ]
}

Changes

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