> ## Documentation Index > Fetch the complete documentation index at: https://docs.dev.gojinko.com/llms.txt > Use this file to discover all available pages before exploring further. # market > For a given destination (city or country), where the demand comes from (city or country), as a % share of total demand Ranks the origin markets feeding a destination by their current share of travel demand as a point in time snapshot. Requires `destination`. The optional `origin_country` selector (`Country:`, allowed only when `level=city`) narrows the ranking to the cities of that country. ## OpenAPI ````yaml api-reference/public-api.yaml GET /v1/market openapi: 3.0.0 info: title: Jinko Public API version: 0.1.0 description: >- Curated public REST surface for Jinko. Authenticated with jnk_ API keys. See https://docs.gojinko.com for guides. servers: [] security: [] paths: /v1/market: get: tags: - Demand summary: Rank origin markets feeding a destination description: >- Ranks the origin markets feeding a destination by their current share of travel demand as a point in time snapshot. Requires destination. The optional origin_country selector (`Country:`, allowed only when level=city) narrows the ranking to the cities of that country. parameters: - schema: type: string minLength: 1 description: >- Where travelers want to go. Accepts a city or a country as `:` (for example `City:PAR` or `Country:FR`). Required for this endpoint. example: City:PAR required: true name: destination in: query - schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: >- Start of the departure window, written as YYYY-MM-DD. Provide it together with departure_date_to, or omit both to include all departure dates. example: '2026-07-01' required: false name: departure_date_from in: query - schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: >- End of the departure window, written as YYYY-MM-DD. Provide it together with departure_date_from, or omit both to include all departure dates. example: '2026-07-31' required: false name: departure_date_to in: query - schema: type: string enum: - Solo - Couple - Group - Family example: Couple required: false name: traveler_type in: query - schema: type: string enum: - One-Way - Round-Trip example: Round-Trip required: false name: trip_type in: query - schema: type: integer nullable: true minimum: 0 description: >- Minimum trip length, in nights between departure and return. Applies to round trips only. example: 5 required: false name: trip_duration_min in: query - schema: type: integer nullable: true minimum: 0 description: >- Maximum trip length in nights. Must be greater than or equal to trip_duration_min. example: 9 required: false name: trip_duration_max in: query - schema: type: integer nullable: true minimum: 0 description: >- The search window is how many days before the departure date a search was made. Sets the lower bound: keeps only demand from searches made at least this many days before departure. example: 7 required: false name: search_window_min in: query - schema: type: integer nullable: true minimum: 0 description: >- The search window is how many days before the departure date a search was made. Sets the upper bound: keeps only demand from searches made at most this many days before departure. Must be greater than or equal to search_window_min. example: 30 required: false name: search_window_max in: query - schema: type: integer minimum: 2 maximum: 90 description: >- Number of recent days of search activity combined into the demand figure (minimum 2, default 7, maximum 90). A single day covers just the current day, whose data is still incomplete. Up to 90 days of history are available. example: 30 required: false name: snapshot_window_days in: query - schema: type: integer minimum: 1 maximum: 200 default: 20 description: Maximum number of result rows to return. Default 20, maximum 200. example: 20 required: false name: limit in: query - schema: type: string enum: - country - city description: >- Granularity of the ranked results: country (the default) or city. Applies to destination and market results, not audience. example: city required: false name: level in: query - schema: type: string description: >- Restricts the ranked origin markets to the cities of a single country, given as `Country:` (for example `Country:US`). Optional, and allowed only when level=city. Must be a country; a city selector is rejected. example: Country:US required: false name: origin_country in: query responses: '200': description: Market demand ranking content: application/json: schema: $ref: '#/components/schemas/MarketResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: BAD_REQUEST message: Malformed JSON in request body. doc_url: https://docs.gojinko.com/concepts/errors '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: AUTH_REQUIRED message: Invalid or expired API key. doc_url: https://docs.gojinko.com/api-reference/authentication '422': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: BAD_REQUEST message: >- origins: origins is required; trip_type: trip_type is required doc_url: https://docs.gojinko.com/concepts/errors '429': description: Rate limit or quota exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: RATE_LIMITED message: Rate limit or quota exceeded. doc_url: https://docs.gojinko.com/concepts/errors '502': description: Upstream service error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: UPSTREAM_ERROR message: Upstream travel provider returned an error. Please retry. doc_url: https://docs.gojinko.com/concepts/errors security: - ApiKeyAuth: [] - BearerAuth: [] components: schemas: MarketResponse: type: object properties: rows: type: array items: $ref: '#/components/schemas/MarketSnapshotRow' required: - rows ErrorResponse: type: object properties: error: type: object properties: code: type: string message: type: string doc_url: type: string required: - code - message required: - error MarketSnapshotRow: type: object properties: rank: type: number example: 1 market: type: string example: Country:US share: type: number example: 0.214 securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key BearerAuth: type: http scheme: bearer ````