GOgojinko
Demand

Demand time series for explicit origin/destination pairs

Deep dive: returns one de-sampled search-volume series per (origin, destination) pair. v1 allows a list on only one side (a single origin OR a single destination).

get/v1/trend

Request

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

Query parameters

originsstring required

Comma-separated origin selectors <Level>:<Code> (e.g. Country:US,Country:CA). v1: at most one of origins/destinations may have more than one entry.

Example:Country:US
destinationsstring required

Comma-separated destination selectors <Level>:<Code> (e.g. Country:FR).

Example:Country:FR,Country:DE,Country:GB
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

Response

Per-pair demand 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.