Search tours
search_toursRead-onlyIdempotent
Lists and filters published tours by free text, destination, maximum from-price, departure date range and sort. Prices are "from" prices with their basis, not fixed prices. Returns an empty list with emptyReason when nothing matches. Tours only: no hotels, experiences or visas.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City slug. | |
| sort | No | Default newest. | |
| limit | No | Default 10. | |
| query | No | Free text: country, city or tour name (example: "Japan"). | |
| offset | No | ||
| country | No | Country slug. | |
| currency | Yes | Price currency. | |
| language | Yes | Catalogue language. | |
| maxPrice | No | Maximum from-price in the unit of priceFrom.amount (minor units: 15000 for EUR 150) and in the chosen currency. | |
| departureTo | No | Tours with a departure on or before this date (YYYY-MM-DD) | |
| departureFrom | No | Tours with a departure on or after this date (YYYY-MM-DD) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | ||
| tours | Yes | ||
| deepLink | Yes | ||
| disclaimer | No | ||
| emptyReason | Yes | ||
| generatedAt | No | ||
| catalogueRefreshedAt | No |