---
title: "Rank traveler audiences for a destination"
method: GET
path: "/v1/audience"
tags: ["Demand"]
---

# Rank traveler audiences for a destination

`GET /v1/audience`

## Request

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

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

## Query parameters

- `origin` string: Origin selector `<Level>:<Code>` (e.g. `Country:US`), or `global` for all origins. Required for the destination endpoints.
- `destination` string, required: Destination selector `<Level>:<Code>`. Required for this endpoint.
- `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.

## Response `200`

Audience demand ranking

- AudienceResponse
  - `rows` AudienceSnapshotRow[], required
    - `rank` number
    - `audience` 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)