GOgojinko
Demand

Demand time series for the top-N destinations

Ranks destinations reachable from origin by within-window growth, then returns each top-N destination’s series. Optional destination_country (a Country:<code> selector, allowed only with level=city) narrows the ranking to that country’s destination cities.

get/v1/destination/trend

Request

  • Base URL
    https://api.gojinko.com
  • URL
    https://api.gojinko.com/v1/destination/trend
  • 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
departure_date_fromstring

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.

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.

Example:2026-07-31
traveler_type'Solo' | 'Couple' | 'Group' | 'Family'
Example:Couple
trip_type'oneway' | 'roundtrip'
Example:roundtrip
trip_duration_mininteger nullable
Example:5
trip_duration_maxinteger nullable
Example:9
search_window_mininteger nullable
Example:7
search_window_maxinteger nullable
Example:30
trend_windowinteger

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

Example:12
granularity'day' | 'week' | 'month'

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

Example:week
level'country' | 'city'

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

Example:city
limitinteger

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

Example:10
destination_countrystring

Destination country selector Country:<code> (e.g. Country:FR). Optional and allowed ONLY together with level=city: it scopes the ranked destinations to a single country so that country’s cities are ranked. Must be a country — a City selector is rejected.

Example:Country:FR

Response

Top-N destination time series

granularitystring required
fromstring required
tostring required

Example response

{
  "granularity": "week",
  "from": "2026-06-19",
  "to": "2026-06-25",
  "series": [
    {
      "label": "FR",
      "origin": "Country:US",
      "destination": "Country:FR",
      "series": [
        {
          "date": "2026-06-20",
          "value": 1234
        }
      ],
      "summary": {
        "total": 34567,
        "avg_per_day": 1191,
        "growth_pct": 12.3,
        "peak_date": "2026-06-14",
        "peak_value": 1890
      }
    }
  ]
}

Changes

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