Find Destination - Jinko Platform

Surface inspiration when a user knows where they want to leave from but not where they want to go. Typical prompts include “cheap beach getaways from New York” or “weekend trips out of London under €200”. Results come back ranked by lowest available fare so the user can compare options before committing to a route.

Tool description (what the LLM sees)

Discover travel destinations accessible from your departure airports.

Search globally or filter to specific regions. Returns destinations sorted by cheapest available flight.

IMPORTANT: Use airport codes (CDG, ORY, JFK), NOT city codes (PAR, NYC). Include all nearby airports for best results (e.g., CDG + ORY for Paris).

Next step: Use flight_calendar with the destination to get specific flights with offer_tokens for pricing.

Parameters

Name	Type	Required	Description
`origins`	`array<string>`	Yes	Origin airport IATA codes or city codes (3 letters). Include all nearby airports. Examples: [“JFK”, “LGA”, “EWR”] for NYC.
`destinations`	`array<string>`	No	Filter to specific destination IATA codes. Omit for global discovery mode.
`trip_type`	`enum ("oneway" \| "roundtrip")`	Yes	Trip type: “oneway” or “roundtrip”.
`departure_dates`	`array<string>`	No	Specific departure dates (YYYY-MM-DD). Multiple dates searched with OR logic.
`departure_date_ranges`	`array<object>`	No	Departure date ranges for flexible search.
`return_dates`	`array<unknown>`	No	Specific return dates (YYYY-MM-DD) for round-trip flights.
`return_date_ranges`	`array<unknown>`	No	Return date ranges for flexible round-trip search.
`stay_days`	`integer`	No	Exact stay duration in days.
`stay_days_range`	`object`	No	Flexible stay duration range. Example: {min: 5, max: 10}
`stay_days_range.min`	`integer`	Yes	Minimum stay duration in days
`stay_days_range.max`	`integer`	Yes	Maximum stay duration in days
`direct_only`	`boolean`	No	Only return nonstop flights.
`cabin_class`	`enum ("economy" \| "premium_economy" \| "business" \| "first")`	No	Cabin class filter.
`max_total`	`number`	No	Maximum total price for the trip (canonical name). Preferred over max_price.
`max_price`	`number`	No	Deprecated alias for max_total. Use max_total instead.
`sort_by`	`enum ("lowest" \| "recommendation")`	No	Sort order. Default: “lowest” (cheapest first).
`limit`	`integer`	No	Max destinations to return per page (1-100). Default 20.
`offset`	`integer`	No	Number of destinations to skip, for pagination. Default 0.
`currency`	`string`	No	ISO 4217 currency code. Defaults to “USD”.
`locale`	`string`	No	BCP 47 locale. Defaults to “en-US”.
`format`	`enum ("text" \| "json")`	No	Response format. “text” returns plain text for LLMs. “json” returns structured JSON.

Examples

Explore destinations under $500 from New York in June:

{
  "name": "find_destination",
  "arguments": {
    "origins": ["JFK", "LGA", "EWR"],
    "trip_type": "roundtrip",
    "departure_date_ranges": [{ "start": "2026-06-01", "end": "2026-06-30" }],
    "stay_days_range": { "min": 5, "max": 10 },
    "max_price": 500,
    "currency": "USD"
  }
}

Europe from Paris in spring, direct only:

{
  "name": "find_destination",
  "arguments": {
    "origins": ["CDG", "ORY"],
    "destinations": ["LHR", "AMS", "FRA", "MAD", "BCN", "ROM"],
    "trip_type": "roundtrip",
    "departure_date_ranges": [{ "start": "2026-04-01", "end": "2026-05-31" }],
    "stay_days": 3,
    "direct_only": true,
    "currency": "EUR"
  }
}

The response is a list of destinations sorted by cheapest found price, each with an offer_token you can pass into flight_search for live pricing.

​Parameters

​Examples

Parameters

Examples