---
title: "Rank the top destinations by travel demand"
method: GET
path: "/v1/destination"
tags: ["Demand"]
---

# Rank the top destinations by travel demand

`GET /v1/destination`

## Request

- Base URL: `https://api.gojinko.com`
- URL: `https://api.gojinko.com/v1/destination`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

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

## Query parameters

- `origin` string: Origin selector `<Level>:<Code>` (e.g. `Country:US`), or `global` for all origins. Required for the destination endpoints.
- `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).
- `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).
- `traveler_type` 'Solo' | 'Couple' | 'Group' | 'Family'
- `trip_type` 'oneway' | 'roundtrip'
- `trip_duration_min` integer, nullable: Minimum trip length in nights (return_date − dep_date). Round-trips only.
- `trip_duration_max` integer, nullable: Maximum trip length in nights (must be >= trip_duration_min).
- `search_window_min` integer, nullable: Minimum advance-purchase window in days (dep_date − search_date): keep demand from searches made at least this many days before departure.
- `search_window_max` integer, nullable: Maximum advance-purchase window in days (must be >= search_window_min).
- `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; data is kept for 90 days).
- `limit` integer: Maximum number of result rows. Default 20, max 200.
- `level` 'country' | 'city': Ranked output granularity: country (default) or city. Applies to destination/market (not audience).
- `destination_country` string: 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.

## Response `200`

Destination demand ranking

- DestinationResponse
  - `rows` DestinationSnapshotRow[], required
    - `rank` number
    - `destination` string
    - `share` number

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `402`: Payment required — organization balance exhausted
- `404`: Resource not found
- `409`: The operation conflicts with the current state of the resource
- `410`: The resource this request names no longer exists
- `422`: Validation error
- `429`: Rate limit or quota exceeded
- `502`: The travel provider rejected the request, or an upstream call failed
- `503`: No travel provider can serve the request right now
- `504`: The travel provider did not answer in time

---

[API](https://skmtc.dev/gojinko/apis/jinko-public-api.md) - [All operations](https://skmtc.dev/gojinko/apis/jinko-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gojinko/apis/jinko-public-api/revisions/ac5046767e4c?raw)