Aggregated travel MCP — flights, tours, activities, price checks, visas, and more.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Look up an airline by IATA (2-char) or ICAO (3-char) code.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Look up an airline by IATA (2-char) or ICAO (3-char) code.
| Argument | Type | Description |
|---|---|---|
| code* | string |
{
"type": "object",
"title": "airlines_lookupArguments",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"title": "Code"
}
}
}Search airlines by name. Returns up to 20 results.
| Argument | Type | Description |
|---|---|---|
| query* | string | |
| country | any | |
| active_only | boolean |
{
"type": "object",
"title": "airlines_searchArguments",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"title": "Query"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country",
"default": null
},
"active_only": {
"type": "boolean",
"title": "Active Only",
"default": true
}
}
}Look up an airport by IATA (3-char) or ICAO (4-char) code. Returns full details including runways.
| Argument | Type | Description |
|---|---|---|
| code* | string |
{
"type": "object",
"title": "airports_lookupArguments",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"title": "Code"
}
}
}Find airports near a geographic point. Returns results sorted by distance.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| latitude* | number | |
| longitude* | number | |
| radius_km | number | |
| include_small | boolean |
{
"type": "object",
"title": "airports_nearArguments",
"required": [
"latitude",
"longitude"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 10
},
"latitude": {
"type": "number",
"title": "Latitude"
},
"longitude": {
"type": "number",
"title": "Longitude"
},
"radius_km": {
"type": "number",
"title": "Radius Km",
"default": 100
},
"include_small": {
"type": "boolean",
"title": "Include Small",
"default": false
}
}
}Search airports by name or city. Returns up to 20 results sorted by size.
| Argument | Type | Description |
|---|---|---|
| query* | string | |
| country | any | |
| type_filter | any |
{
"type": "object",
"title": "airports_searchArguments",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"title": "Query"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country",
"default": null
},
"type_filter": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Type Filter",
"default": null
}
}
}Check which static datasets (airports, airlines, visas) are loaded and their row counts.
No arguments.
{
"type": "object",
"title": "data_statusArguments",
"properties": {}
}[fcdo] List all countries with UK FCDO travel advice.
No arguments.
{
"type": "object",
"title": "fcdo_list_countriesArguments",
"properties": {}
}[fcdo] Get UK FCDO travel advice for a specific country. Includes safety, entry requirements, health, and warnings.
| Argument | Type | Description |
|---|---|---|
| country* | string |
{
"type": "object",
"title": "fcdo_travel_adviceArguments",
"required": [
"country"
],
"properties": {
"country": {
"type": "string",
"title": "Country"
}
}
}[ferryhopper] Find all direct ferry routes and reachable destination ports from a given origin port without layovers or transfers.
| Argument | Type | Description |
|---|---|---|
| portLocation* | string | Location name or search term used to find matching ports (not limited to exact port codes). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"portLocation"
],
"properties": {
"portLocation": {
"type": "string",
"description": "Location name or search term used to find matching ports (not limited to exact port codes)."
}
},
"additionalProperties": false
}[ferryhopper] Find all ferry travel disruptions, including delays, weather alerts, and strikes for a given date and country.
| Argument | Type | Description |
|---|---|---|
| country* | string | ISO 3166-1 alpha-2 country code to filter disruptions by country (e.g. "GR" for Greece). |
| tripDate* | string | Departure date in ISO format YYYY-MM-DD (e.g. 2026-03-15). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tripDate",
"country"
],
"properties": {
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code to filter disruptions by country (e.g. \"GR\" for Greece)."
},
"tripDate": {
"type": "string",
"description": "Departure date in ISO format YYYY-MM-DD (e.g. 2026-03-15)."
}
},
"additionalProperties": false
}[ferryhopper] Find ferry ports, harbors, maritime terminals, port IDs, codes, and geographic locations.
No arguments.
{
"type": "object",
"properties": {}
}[ferryhopper] Search ferry trips as an ordered chain of 1 to 5 legs. Takes human-readable location names (e.g. city or port name) for each leg, not port codes — no need to call get_ports first. Availability flags (cabin, vehicles, pets, e-ticket) are reported per segment. - One leg: a plain one-way search. - Two legs where leg 2 reverses leg 1 (e.g. leg 1 Piraeus→Mykonos, leg 2 Mykonos→Piraeus): a round trip. - Up to 5 legs otherwise (e.g. A to B, then B to C, then C to D): an island-hopping chain. Legs after the first must depart from the location the previous leg arrived at, and must be in chronological order (a later leg may share the same date as an earlier one, but may not precede it). The response returns each leg's available options independently (legs[].options) — options are never filtered against another leg's options. Consecutive legs must leave enough time between one leg's arrival and the next leg's departure to be a valid connection; this is not pre-filtered server-side or reflected in this output, so do not assume every combination of options across legs is a valid connection — the widget the user interacts with enforces this.
| Argument | Type | Description |
|---|---|---|
| legs* | array | An ordered chain of sailing legs. A one-way search is a single leg. A round trip is 2 legs where leg 2 reverses leg 1 (e.g. leg 1 Piraeus→Mykonos, leg 2 Mykonos→Piraeus). An island-hopping chain is up to 5 legs, e.g. A→B, then B→C, then C→D. Each leg after the first must depart from the location the previous leg arrived at. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"legs"
],
"properties": {
"legs": {
"type": "array",
"items": {
"type": "object",
"required": [
"departureLocation",
"arrivalLocation",
"departureDate"
],
"properties": {
"departureDate": {
"type": "string",
"format": "date",
"description": "Departure date for this leg in ISO format YYYY-MM-DD (e.g. 2026-06-21)."
},
"arrivalLocation": {
"type": "string",
"description": "Arrival location as a human-readable name or search term (e.g. city, port name), not a port code."
},
"departureLocation": {
"type": "string",
"description": "Departure location as a human-readable name or search term (e.g. city, port name), not a port code."
}
},
"additionalProperties": false
},
"maxItems": 5,
"minItems": 1,
"description": "An ordered chain of sailing legs. A one-way search is a single leg. A round trip is 2 legs where leg 2 reverses leg 1 (e.g. leg 1 Piraeus→Mykonos, leg 2 Mykonos→Piraeus). An island-hopping chain is up to 5 legs, e.g. A→B, then B→C, then C→D. Each leg after the first must depart from the location the previous leg arrived at."
}
},
"additionalProperties": false
}[ferryhopper] Deprecated: prefer search_ferry_trips, which covers this tool plus round-trip and multi-leg search and per-segment availability flags. Get a list of available one-way ferry trips between two ports on a specific date.
| Argument | Type | Description |
|---|---|---|
| date* | string | Departure date in ISO format YYYY-MM-DD (e.g. 2026-03-15). |
| arrivalLocation* | string | Arrival location as a human-readable name or search term (e.g. city, port name), not a port code. |
| departureLocation* | string | Departure location as a human-readable name or search term (e.g. city, port name), not a port code. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"departureLocation",
"arrivalLocation",
"date"
],
"properties": {
"date": {
"type": "string",
"description": "Departure date in ISO format YYYY-MM-DD (e.g. 2026-03-15)."
},
"arrivalLocation": {
"type": "string",
"description": "Arrival location as a human-readable name or search term (e.g. city, port name), not a port code."
},
"departureLocation": {
"type": "string",
"description": "Departure location as a human-readable name or search term (e.g. city, port name), not a port code."
}
},
"additionalProperties": false
}[ferryhopper] Get full details for a single sailing leg, looked up by the id of one of the options returned by search_ferry_trips (legs[].options[].id). Returns the trip's departure/arrival time, ports, and operating company, plus the vessel's technical specs, onboard amenities, and photos. Use this to answer questions about a vessel such as: does it have wifi / a restaurant / a snack bar / an open deck / a lift or elevator / wheelchair or disabled access / a designated smoking area? Is it pet-friendly, or does it allow pets on board? Does it have cabins, or a garage / vehicle deck for cars and motorbikes? How many passengers or vehicles does it carry (capacity)? How long is the vessel (length in meters)? What is its IMO number or MMSI (maritime identification numbers used for registry/tracking lookups)? Is this vessel accessible, family-friendly, or suitable for passengers who need mobility assistance? What does the vessel look like (photos)? If no detailed specs exist for the vessel in the source system, vessel.hasDetails is returned as false and every spec/amenity field is null — this means the data is unavailable, not that the vessel lacks that amenity. Also returns the trip's bookable accommodation tiers (seat/cabin classes) with their price and a photo of that accommodation, when available. Throws if the tripId is malformed or the trip is no longer bookable (e.g. it has already departed, was cancelled, or sold out) — re-run search_ferry_trips to get a fresh tripId in that case.
| Argument | Type | Description |
|---|---|---|
| tripId* | string | The trip identifier for a single sailing leg, as returned in legs[].options[].id by search_ferry_trips. Do not fabricate this value. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tripId"
],
"properties": {
"tripId": {
"type": "string",
"description": "The trip identifier for a single sailing leg, as returned in legs[].options[].id by search_ferry_trips. Do not fabricate this value."
}
},
"additionalProperties": false
}[peek] Get availability information for a specific experience including dates, times, and pricing
| Argument | Type | Description |
|---|---|---|
| id* | string | The ID of the experience |
| endDate* | string | End date inclusive in YYYY-MM-DD format (e.g., '2025-06-20' would return things taking place ON or BEFORE the 20th) |
| quantity* | integer | Number of travelers |
| startDate* | string | Start date inclusive YYYY-MM-DD format (e.g., '2025-06-19') |
{
"type": "object",
"required": [
"id",
"quantity",
"startDate",
"endDate"
],
"properties": {
"id": {
"type": "string",
"description": "The ID of the experience"
},
"endDate": {
"type": "string",
"description": "End date inclusive in YYYY-MM-DD format (e.g., '2025-06-20' would return things taking place ON or BEFORE the 20th)"
},
"quantity": {
"type": "integer",
"description": "Number of travelers"
},
"startDate": {
"type": "string",
"description": "Start date inclusive YYYY-MM-DD format (e.g., '2025-06-19')"
}
}
}[peek] Get detailed information about a specific experience by ID
| Argument | Type | Description |
|---|---|---|
| id* | string | The ID of the experience to retrieve |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The ID of the experience to retrieve"
}
}
}[peek] List all category tags
No arguments.
{
"type": "object",
"properties": {}
}[peek] Render activity tiles for a list of activity IDs, returning an embeddable widget URI
| Argument | Type | Description |
|---|---|---|
| id* | string | ID or comma separate list of activity IDs to render as tiles |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "ID or comma separate list of activity IDs to render as tiles"
}
}
}[peek] Search for travel experiences with comprehensive filtering options. Returns available categories, tags, and regions with IDs for further filtering.
| Argument | Type | Description |
|---|---|---|
| query | string | When the user wants something w/ a specific keyword (bike, beer, art, etc) limit to experiences whose title contain a keyword. Never include location information. |
| tagId | string | When you have determined the user is interest in a specific vibe of activity (family friendly, romantic, etc) limit to only experiences with a specific tag (single tag ID) |
| latLng | string | When the user wants something NEAR a specific place, but not necessarily IN a specific place, limit to only those near a given lat_lng. ex: "37.7799,-122.2822". Don't use this for regions, instead use the search_regions and provide a region id. this is a good fallback if a specific region is lacking inventory. |
| endDate | string | Return experiences that are available on or before this date in YYYY-MM-DD format (e.g., '2025-06-20' would return things taking place ON or BEFORE the 20th) |
| regionId | string | When you have determined the user wants something in a specific region (found w/ search_regions) limit to only a specific region ID |
| startDate | string | Return experiences that are available on or after this date. YYYY-MM-DD format (e.g., '2025-06-19') |
| categoryId |
[peek] Search for regions by name
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of regions to return (default: 50) |
| query* | string | Search query to match against region names |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"description": "Maximum number of regions to return (default: 50)"
},
"query": {
"type": "string",
"description": "Search query to match against region names"
}
}
}[restcountries] Look up country information from REST Countries.
| Argument | Type | Description |
|---|---|---|
| query* | string | |
| fields | any | |
| search_by | string |
{
"type": "object",
"title": "restcountries_country_infoArguments",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"title": "Query"
},
"fields": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Fields",
"default": null
},
"search_by": {
"type": "string",
"title": "Search By",
"default": "name"
}
}
}[skiplagged] Search Skiplagged for rental cars between pickup and dropoff locations/dates, returning prices, companies, and car details.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of car offers to return |
| offset | integer | Number of car offers to skip for pagination (default: 0) |
| pickupDate* | string | Pickup date (YYYY-MM-DD) |
| pickupTime | string | Pickup time (HH:mm or HH:mm:ss, default 10:00) |
| dropoffDate* | any | Dropoff date (YYYY-MM-DD) |
| dropoffTime | any | Dropoff time (HH:mm or HH:mm:ss, default 10:00) |
| pickupLocation* | string | Pickup city or airport code |
| dropoffLocation | any | Dropoff city or airport code (defaults to pickup) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pickupLocation",
"pickupDate",
"dropoffDate"
],
"properties": {
"limit": {
"type": "integer",
"default": 12,
"maximum": 100,
"minimum": 1,
"description": "Maximum number of car offers to return"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 99,
"minimum": 0,
"description": "Number of car offers to skip for pagination (default: 0)"
},
"pickupDate": {
"type": "string",
"description": "Pickup date (YYYY-MM-DD)"
},
"pickupTime": {
"type": "string",
"default": "10:00",
"pattern": "^\\d{2}:\\d{2}(?::\\d{2})?$",
"description": "Pickup time (HH:mm or HH:mm:ss, default 10:00)"
},
"dropoffDate": {
"$ref": "#/properties/pickupDate",
"description": "Dropoff date (YYYY-MM-DD)"
},
"dropoffTime": {
"$ref": "#/properties/pickupTime",
"default": "10:00",
"description": "Dropoff time (HH:mm or HH:mm:ss, default 10:00)"
},
"pickupLocation": {
"type": "string",
"minLength": 1,
"description": "Pickup city or airport code"
},
"dropoffLocation": {
"$ref": "#/properties/pickupLocation",
"description": "Dropoff city or airport code (defaults to pickup)"
}
},
"additionalProperties": false
}[skiplagged] Find lower-priced destinations from a departure city when the user is flexible about where to go.
| Argument | Type | Description |
|---|---|---|
| from* | string | Departure IATA code or city name |
| adults | integer | Number of adult passengers |
| depart* | string | Departure date in YYYY-MM-DD format |
| return | any | Return date in YYYY-MM-DD format (optional for one-way trips) |
| children | integer | Number of child passengers |
| fare_class | string | Fare class preference |
| infantsLap | integer | Number of lap infants |
| infantsSeat | integer | Number of seat infants |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"from",
"depart"
],
"properties": {
"from": {
"type": "string",
"description": "Departure IATA code or city name"
},
"adults": {
"type": "integer",
"default": 1,
"maximum": 9,
"minimum": 1,
"description": "Number of adult passengers"
},
"depart": {
"type": "string",
"description": "Departure date in YYYY-MM-DD format"
},
"return": {
"$ref": "#/properties/depart",
"description": "Return date in YYYY-MM-DD format (optional for one-way trips)"
},
"children": {
"type": "integer",
"default": 0,
"maximum": 8,
"minimum": 0,
"description": "Number of child passengers"
},
"fare_class": {
"enum": [
"basic-economy",
"economy",
"premium",
"business",
"first"
],
"type": "string",
"default": "economy",
"description": "Fare class preference"
},
"infantsLap": {
"type": "integer",
"default": 0,
"maximum": 4,
"minimum": 0,
"description": "Number of lap infants"
},
"infantsSeat": {
"type": "integer",
"default": 0,
"maximum": 4,
"minimum": 0,
"description": "Number of seat infants"
}
},
"additionalProperties": false
}[skiplagged] Search Skiplagged support articles for answers about its services, products, and policies.
| Argument | Type | Description |
|---|---|---|
| query* | string | Concise FAQ question for retrieval. Do not include personal identifiers, account IDs, or session details. |
| top_k | integer | Number of top FAQ sources to return (1-5) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Concise FAQ question for retrieval. Do not include personal identifiers, account IDs, or session details."
},
"top_k": {
"type": "integer",
"default": 3,
"maximum": 5,
"minimum": 1,
"description": "Number of top FAQ sources to return (1-5)"
}
},
"additionalProperties": false
}[skiplagged] Generate a flexible calendar of the lowest one-way fares around a chosen departure, returning date → cheapest-price entries to help pick the best day to fly. Intended for flexible-date price discovery, not exact itinerary selection.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort results chronologically or by lowest price first |
| adults | integer | Number of adult passengers (default: 1, max: 9) |
| origin* | string | Departure city name or IATA code (will be resolved to IATA code automatically) |
| children | integer | Number of child passengers (default: 0, max: 8) |
| infantsLap | integer | Number of lap infants (default: 0, max: 4) |
| returnDate | any | Return date for matching trip length (optional, YYYY-MM-DD format) |
| destination* | string | Arrival city name or IATA code (will be resolved to IATA code automatically) |
| infantsSeat | integer | Number of seat infants (default: 0, max: 4) |
[skiplagged] Generate a flexible round-trip price calendar for a fixed-length stay around a chosen travel window. Returns (depart date, return date, lowest total price) entries for nearby date pairs that preserve the original trip length; intended for price discovery, not exact itinerary selection.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort results chronologically or by lowest price first |
| adults | integer | Number of adult passengers (default: 1, max: 9) |
| origin* | string | Departure city name or IATA code (will be resolved to IATA code automatically) |
| children | integer | Number of child passengers (default: 0, max: 8) |
| infantsLap | integer | Number of lap infants (default: 0, max: 4) |
| returnDate* | any | Return date for the reference trip (YYYY-MM-DD format) |
| destination* | string | Arrival city name or IATA code (will be resolved to IATA code automatically) |
| infantsSeat | integer | Number of seat infants (default: 0, max: 4) |
[skiplagged] Search Skiplagged for flights between specific locations with filtering options for passengers, fare class, stops, airlines, and timing preferences
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort flights by price (cheapest first), duration (shortest first), or value (best price/time ratio, default) |
| limit | integer | Maximum number of flights to return (default: 12, max: 100) |
| adults | integer | Number of adult passengers (default: 1, max: 9) |
| offset | integer | Number of flights to skip for pagination (default: 0) |
| origin* | string | Departure location - prefer IATA code |
| children | integer | Number of child passengers (default: 0, max: 8) |
| maxStops | string | Maximum number of stops (none=nonstop, one=1 stop, many=2+ stops) |
| fareClass | string | Fare class preference (default: economy) |
| infantsLap | integer | Number of lap infants (default: 0, max: 4) |
[skiplagged] Fetch room-level availability, pricing, and amenities for a specific hotel and stay dates.
| Argument | Type | Description |
|---|---|---|
| live | boolean | Use live rates (includes booking links). Disable for faster, less accurate cached rates. |
| checkin* | string | Check-in date (YYYY-MM-DD format) |
| hotelId* | integer | Hotel ID (from search results) to fetch detailed availability for |
| checkout* | any | Check-out date (YYYY-MM-DD format) |
| numRooms | integer | Number of rooms (default: 1, max: 5) |
| numAdults | integer | Number of adults (default: 2, max: 10) |
| numChildren | integer | Number of children (default: 0, max: 10) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"hotelId",
"checkin",
"checkout"
],
"properties": {
"live": {
"type": "boolean",
"default": true,
"description": "Use live rates (includes booking links). Disable for faster, less accurate cached rates."
},
"checkin": {
"type": "string",
"description": "Check-in date (YYYY-MM-DD format)"
},
"hotelId": {
"type": "integer",
"description": "Hotel ID (from search results) to fetch detailed availability for",
"exclusiveMinimum": 0
},
"checkout": {
"$ref": "#/properties/checkin",
"description": "Check-out date (YYYY-MM-DD format)"
},
"numRooms": {
"type": "integer",
"default": 1,
"maximum": 5,
"minimum": 1,
"description": "Number of rooms (default: 1, max: 5)"
},
"numAdults": {
"type": "integer",
"default": 2,
"maximum": 10,
"minimum": 1,
"description": "Number of adults (default: 2, max: 10)"
},
"numChildren": {
"type": "integer",
"default": 0,
"maximum": 10,
"minimum": 0,
"description": "Number of children (default: 0, max: 10)"
}
},
"additionalProperties": false
}[skiplagged] Search Skiplagged for hotels in a city with specific check-in and check-out dates, including ratings and pricing.
| Argument | Type | Description |
|---|---|---|
| city* | string | City name to search for hotels (will be matched against available cities) |
| sort | string | Sort hotels by price (cheapest first), ranking (highest rated first), value (best value rating), or discount (best deals first, default when deals available) |
| limit | integer | Maximum number of hotels to return (default: 12, max: 100) |
| offset | integer | Number of hotels to skip for pagination (default: 0) |
| checkin* | string | Check-in date (YYYY-MM-DD format) |
| checkout* | any | Check-out date (YYYY-MM-DD format) |
| numRooms | integer | Number of rooms (default: 1, max: 9) |
| numAdults | integer | Number of adults (default: 2, max: 10) |
| numChildren | integer |
[skiplagged] Resolve a city name to a valid IATA code
| Argument | Type | Description |
|---|---|---|
| input* | string | City name code to resolve to IATA code |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"input"
],
"properties": {
"input": {
"type": "string",
"minLength": 1,
"description": "City name code to resolve to IATA code"
}
},
"additionalProperties": false
}[skiplagged] Resolve coarse location metadata supplied by the client to the nearest airport. Takes no user-provided arguments.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}[tourradar] Use this when you need to find a tour operator's ID by their name for filtering tours. Searches tour operators by name and returns matching operators with their IDs. Use the returned operator ID with tour search filters.
| Argument | Type | Description |
|---|---|---|
| textSearch* | string | Operator name for search, for example `Topdeck` |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"textSearch"
],
"properties": {
"textSearch": {
"type": "string",
"description": "Operator name for search, for example `Topdeck`"
}
}
}[tourradar] Use this when you need to find city IDs for tour search filters like start city, end city, or cities to visit. Searches for cities by name within a specific country. Supports multiple name variants to handle different spellings (e.g., Krakow, Kraków, Cracow).
| Argument | Type | Description |
|---|---|---|
| search* | array | City name filter. It is recommended to use this filter to narrow down the search results. Please use english only names. How to search: If you are looking for Kraków city, please pass potential candidates here, like: ['Krakow', 'Kraków', 'Cracow']. It will return all cities that match any of the names. |
| country_code* | string | ISO 3166-1 alpha-2 country code (e.g., 'US' for USA, 'GB' for United Kingdom, 'DE' for Germany). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"country_code",
"search"
],
"properties": {
"search": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "City name filter. It is recommended to use this filter to narrow down the search results. Please use english only names. How to search: If you are looking for Kraków city, please pass potential candidates here, like: ['Krakow', 'Kraków', 'Cracow']. It will return all cities that match any of the names."
},
"country_code": {
"enum": [
"AF",
"AL",
"DZ",
"AD",
"AO",
"AG",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BY",
"BE",
"BZ",
"BJ",
"BT",
"BA",
"BW",
"BR",
"BN",
"BG",
"BF",
"BI",
"KH",
"CM",
"CA",
"CV",
"CF",
"TD",
"CL",
"CN",
"CO",
"KM",
"CD",
"CG",
"CR",
"CI",
"HR",
"CU",
"CY",
"CZ",
"DK",
"DJ",
"DM",
"DO",
"TL",
"EC",
"EG",
"SV",
"GQ",
"ER",
"EE",
"ET",
"FJ",
"FI",
"FR",
"GA",
"GM",
"GE",
"DE",
"GH",
"GR",
"GD",
"GT",
"GN",
"GW",
"GY",
"HT",
"HN",
"HU",
"IS",
"IN",
"ID",
"IR",
"IQ",
"IE",
"IL",
"IT",
"JM",
"JP",
"JO",
"KZ",
"KE",
"KP",
"KR",
"KW",
"KG",
"LA",
"LV",
"LB",
"LS",
"LR",
"LY",
"LI",
"LT",
"LU",
"MK",
"MG",
"MW",
"MY",
"MV",
"ML",
"MR",
"MU",
"MX",
"FM",
"MD",
"MC",
"MN",
"MA",
"MZ",
"MM",
"NA",
"NR",
"NP",
"NZ",
"NI",
"NE",
"NG",
"NO",
"OM",
"PK",
"PA",
"PG",
"PY",
"PE",
"PH",
"PL",
"PT",
"QA",
"RU",
"RW",
"KN",
"LC",
"VC",
"WS",
"SM",
"ST",
"SA",
"SN",
"RS",
"SC",
"SG",
"SK",
"SI",
"SO",
"ZA",
"ES",
"LK",
"SD",
"SZ",
"SE",
"CH",
"SY",
"TW",
"TJ",
"TZ",
"TH",
"TG",
"TO",
"TT",
"TN",
"TR",
"TM",
"UG",
"UA",
"AE",
"US",
"UY",
"UZ",
"VU",
"VA",
"VE",
"VN",
"YE",
"ZM",
"ZW",
"NL",
"BO",
"MT",
"GB",
"NC",
"SB",
"GU",
"PF",
"AS",
"SL",
"EH",
"PS",
"BM",
"GL",
"PM",
"AI",
"AW",
"KY",
"GP",
"MQ",
"MS",
"PR",
"TC",
"VI",
"RO",
"FO",
"GG",
"JE",
"IM",
"SJ",
"GI",
"FK",
"VG",
"RE",
"SR",
"CK",
"ME",
"XK",
"SX",
"CW",
"HK",
"AQ"
],
"type": "string",
"description": "ISO 3166-1 alpha-2 country code (e.g., 'US' for USA, 'GB' for United Kingdom, 'DE' for Germany)."
}
}
}[tourradar] Use this when you need continent IDs for filtering tours by region. Returns a list of all supported continents with their IDs and names for use in tour search filters.
No arguments.
{
"type": "object",
"properties": {}
}[tourradar] Use this when you need to look up country IDs for filtering tours or validating country names. Returns a complete list of all supported countries with their IDs, names, and ISO country codes.
No arguments.
{
"type": "object",
"properties": {}
}[tourradar] Use this when you need to check supported currencies or get currency details like symbols. Returns a list of all supported currencies with their codes (USD, EUR), names, and symbols ($, €).
No arguments.
{
"type": "object",
"properties": {}
}[tourradar] Use this when you need language IDs for filtering tours by guide language. Returns a list of all supported languages with their IDs, codes, and names for use in tour search filters.
No arguments.
{
"type": "object",
"properties": {}
}[tourradar] Use this when the user wants information about a tour operator, such as their terms and policies. Fetches operator details including name, code, and terms & conditions based on operator ID.
| Argument | Type | Description |
|---|---|---|
| operatorId* | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"operatorId"
],
"properties": {
"operatorId": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
}[tourradar] Use this when the user asks about available departure dates, pricing for specific dates, or needs to validate if a departure date is available. Returns a list of departures for a specific tour within a date range, including availability status, pricing, and booking information.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number. Default is 1 |
| tourId* | integer | Tour ID |
| currency | string | Currency to return prices in. Use this only when the user explicitly asks for a specific currency. Otherwise the user's default (based on location) is used. |
| dateRange* | object | Returns only departure dates in the desired range |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tourId",
"dateRange"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"description": "Page number. Default is 1",
"exclusiveMinimum": 0
},
"tourId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Tour ID",
"exclusiveMinimum": 0
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"NZD",
"CAD"
],
"type": "string",
"description": "Currency to return prices in. Use this only when the user explicitly asks for a specific currency. Otherwise the user's default (based on location) is used."
},
"dateRange": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "End date of the range"
},
"start": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Start date of the range"
}
},
"description": "Returns only departure dates in the desired range"
}
}
}[tourradar] Use this when the user wants to see detailed information about a specific tour. Fetches comprehensive tour details including itinerary, pricing, operator info, images, and booking links based on tour ID.
| Argument | Type | Description |
|---|---|---|
| tourId* | integer | |
| currency | string | Currency to return prices in. Use this only when the user explicitly asks for a specific currency. Otherwise the user's default (based on location) is used. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tourId"
],
"properties": {
"tourId": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"NZD",
"CAD"
],
"type": "string",
"description": "Currency to return prices in. Use this only when the user explicitly asks for a specific currency. Otherwise the user's default (based on location) is used."
}
}
}[tourradar] Use this when the user has questions about a tour that might be answered in the FAQ section. Returns a paginated list of frequently asked questions and answers about a specific tour, covering topics like inclusions, requirements, and policies.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number. Default is 1 |
| tourId* | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tourId"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"description": "Page number. Default is 1",
"exclusiveMinimum": 0
},
"tourId": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
}[tourradar] Use this when the user wants to see tour routes on a map or compare itineraries visually. Fetches tour details for one or more tours and prepares map data with all itinerary locations, coordinates, and day-by-day information for visual display.
| Argument | Type | Description |
|---|---|---|
| tourIds* | array | |
| currency | string | Currency to return prices in. Use this only when the user explicitly asks for a specific currency. Otherwise the user's default (based on location) is used. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tourIds"
],
"properties": {
"tourIds": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"minItems": 1
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"NZD",
"CAD"
],
"type": "string",
"description": "Currency to return prices in. Use this only when the user explicitly asks for a specific currency. Otherwise the user's default (based on location) is used."
}
}
}[tourradar] Use this when you need tour type IDs for filtering tours by category like adventure, cultural, or wildlife. Returns a hierarchical list of tour type groups and their individual types with IDs and names.
No arguments.
{
"type": "object",
"properties": {}
}[tourradar] Use this when you need to know the current date, especially before setting departure date filters. Returns the current date and time in ISO format. Essential for calculating valid date ranges for tour searches.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}[tourradar] Search tour reviews using AI-powered semantic search. Requires tourIds to scope results to specific tours. Use this when the user asks about reviews, feedback, or experiences for specific tours. Combine with an optional text query to find reviews mentioning specific topics (e.g., 'food', 'guide', 'accommodation'). When you don't have tour IDs, use vertex-tour-search or vertex-tour-title-search first to find them.
| Argument | Type | Description |
|---|---|---|
| query | string | Short natural language search query to find specific review topics. Keep it concise — do NOT expand into keyword lists. Use simple phrases like 'food quality', 'guide', 'hotel issues'. The search engine handles semantic matching automatically. Prefer using 'keywords' parameter instead when user intent maps to specific topics. Leave empty to return all reviews. |
| tourIds | array | Tour IDs to scope reviews to specific tours. Use vertex-tour-title-search to find tour IDs if needed. |
| keywords | array | Array of keyword phrases to search reviews for. These are joined with OR logic to find reviews matching any of the given topics. Use short phrases (e.g., ['food quality', 'meals', 'restaurant']). When provided, this takes priority over 'query'. |
| pageSize | integer | Number of reviews to return (1-20, default 10) |
| minRating | number | Only return reviews with a star rating >= this value (1-5). Use to surface only strong reviews. |
| pageToken | string |
[tourradar] Use this when the user describes what they want in natural language and you need AI-powered semantic search to understand their intent. Before use this tool, please READ all possible filters. PLESE USE FILTERS, when can be used, to make search faster and much more precise. Please use start_city, end_city, cities, countries, start_country, end_country filters if possible. You can use multiple of them. AI-powered semantic search for tours using natural language queries combined with optional filters. Uses Google Vertex AI to understand intent and find relevant tours based on descriptions, themes, or specific requests. Use `vertex-tour-search` when: - The user describes what they want in natural language - You need semantic/AI-powered search to understand intent - Combining natural language with filters for refined results Examples: - "Family-friendly safari with kids under 12" - "Romantic honeymoon trip with beach and mountains" - "Adventure tour with hiking and camping for beginners" - "Cultural immersion experience with local homestays" - "Wine tasting tour through European countryside" ## Input ### Required - `textSearch`: Natural language description of what the user is looking for - `display_mode`: How to display results — `"listing"` (default, carousel of tour cards) or `"map"` (interactive map view) ### Optional Filters #### Location Filters | Filter | Type | Description | | --------------- | -------- | -------------------------------------------------------------------------- | | `start_country` | string[] | Country where tour BEGINS (ISO 3166-1 alpha-2 codes). OR logic. | | `end_country` | string[] | Country where tour ENDS (ISO 3166-1 alpha-2 codes). OR logic. | | `start_city` | number[] | City IDs where tour starts. Use `b2b-cities-search` to find IDs. OR logic. | | `end_city` | number[] | City IDs where tour ends. Use `b2b-cities-search` to find IDs. OR logic. | | `countries` | object | Countries visited DURING the itinerary. Supports AND/OR operator. | | `cities` | object | Cities visited on the itinerary. Supports AND/OR operator. | #### Range Filters | Filter | Type | Description | | ---------------- | ------------------------ | ------------------------------------------------------------------------------------ | | `duration` | `{ min, max }` | Tour length in days | | `max_group_size` | `{ min, max }` | Maximum group size range | | `min_group_size` | `{ min, max }` | Minimum group size range | | `min_age` | `{ min, max }` | Minimum age requirement range. E.g., `{ min: 1, max: 12 }` finds family-friendly tours | | `max_age` | `{ min, max }` | Maximum age limit range. E.g., `{ min: 18, max: 39 }` finds youth-specific tours | | `price` | `{ min, max, currency }` | Price range (currency: "EUR") | #### AND/OR Filters These filters support both AND and OR operators: | Filter | Values | Description | | ------------ | ------------------------ | ---------------------------------- | | `departures` | YYYY-MM strings | Filter by departure months | | `countries` | ISO 3166-1 alpha-2 codes | Countries visited during itinerary | | `cities` | City IDs | Cities visited on itinerary | Structure: `{ values: [...], operator: "AND" | "OR" }` - `OR` (default): Tour matches ANY of the specified values - `AND`: Tour must match ALL specified values ## Examples ### Simple text search ```json { "textSearch": "family adventure with wildlife" } ``` ### With location filters ```json { "textSearch": "hiking adventure", "start_country": ["DE", "AT"], "countries": { "values": ["IT", "CH"], "operator": "AND" } } ``` ### With range filters ```json { "textSearch": "luxury beach vacation", "duration": { "min": 7, "max": 14 }, "price": { "min": 2000, "max": 5000, "currency": "EUR" }, "max_group_size": { "min": 1, "max": 16 } } ``` ### With age filters ```json { "textSearch": "family safari with young children", "min_age": { "min": 1, "max": 6 }, "duration": { "min": 7, "max": 14 } } ``` ### With departure dates ```json { "textSearch": "northern lights tour", "departures": { "values": ["2026-01", "2026-02", "2026-03"], "operator": "OR" } } ``` ### Map display mode ```json { "textSearch": "hiking tours in the Alps", "display_mode": "map", "countries": { "values": ["AT", "CH"], "operator": "OR" } } ``` ## Response Returns a list of tours matching the query, each containing: - Tour ID, name, and URL - Operator information - Brief description matching the query context
[tourradar] Search for tours by title using AI-powered semantic search. Returns a list of matching tour IDs and titles. Use this when you need to look up a tour by name. When you know tour id, use b2b-tour-details tool to display details about specific tour
| Argument | Type | Description |
|---|---|---|
| query* | string | Tour title or partial title to search for |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Tour title or partial title to search for"
}
}
}[tourradar] Use this when the user wants to ASK A QUESTION about a tour or operator WITHOUT committing to a booking. Two modes: - mode "tour": a question about a specific tour. Requires `tourId`. The `departureDate` is OPTIONAL here — if the customer has not picked a date, omit it and the backend will pick the nearest real departure. Do NOT fabricate a date. - mode "operator": a general/operator-level question. Requires `operatorId` and no tour. Always provide the customer's real contact details (email, first/last name; phone optional) and their actual question text. Never fabricate or assume user data — ask for missing information.
| Argument | Type | Description |
|---|---|---|
| email* | string | Customer email address. If email is not given by the customer, please ask before executing this tool. Never generate an email yourself. |
| entity* | any | What the question is about. Pick exactly one mode: "tour" (carries `tourId` + optional departure/pax) or "operator" (carries `operatorId`). A tour question cannot carry an operator id and vice versa. |
| lastName* | string | Customer last name. |
| question* | string | The customer's actual question text. Required and must be non-empty. This is the question the customer wants answered. |
| firstName* | string | Customer first name. |
| phoneNumber |
[tourradar] Use this when the user explicitly wants to book a tour and has provided their contact details. Creates a booking request for a specific tour. Requires real contact details (email, names; phone optional). Always confirm the departure date by checking departures first. Never fabricate or assume user data - always ask for missing information.
| Argument | Type | Description |
|---|---|---|
| email* | string | Customer email address. If email is not given by the customer, please ask him before executing this endpoint. Never generate email by yourself, always ask customer for give the email before calling this tool. |
| tourId* | integer | Tour ID |
| lastName* | string | |
| firstName* | string | |
| paxAdults* | integer | Number of the adults. Always ask customer for this information, is important to have it |
| paxChildren* | integer | Number of the children |
| phoneNumber | string | Customer phone number in E-164 format. Is optional, but recommended to provide it. Never put fake phone number, always ask customer for give the phone number before calling this tool. If customer do not gives phone number, just skip this field |
[tourradar] Use this when the user requests a tour brochure or PDF to be sent to their email. Sends a tour brochure (PDF file) to the specified email address. Before using this, ensure the user has provided their email address. If not provided, ask the user for it. Never generate or assume email addresses.
| Argument | Type | Description |
|---|---|---|
| email* | string | User email address. If email is not given by the user, please ask him before executing this endpoint. Never generate email by yourself, always ask user for give the email before calling this tool. |
| tourId* | integer | Tour ID |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tourId",
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "User email address. If email is not given by the user, please ask him before executing this endpoint. Never generate email by yourself, always ask user for give the email before calling this tool."
},
"tourId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Tour ID",
"exclusiveMinimum": 0
}
}
}Ask a travel question in natural language. Routes to the right tools automatically and returns a combined answer. Example: 'Cheapest flights from Zurich to Rome next week, and do I need a visa?'
| Argument | Type | Description |
|---|---|---|
| query* | string |
{
"type": "object",
"title": "travel_agentArguments",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"title": "Query"
}
}
}[trivago] Search live hotel and accommodation listings near specific coordinates — a landmark, address, venue, or neighborhood — aggregated via trivago's metasearch of major booking sites. Returns the same, filterable results as trivago-accommodation-search. Use when the user anchors their search to a place rather than a named destination (e.g. "near the stadium," "within walking distance of X"). Additional Information: {"knownInformation":{"currentYear":"2026","today":"2026-10-11"}}
| Argument | Type | Description |
|---|---|---|
| rooms | number | The number of rooms, Number of rooms must be lower than or equal to the number of adults |
| adults | number | The number of adults. |
| arrival* | string | The arrival date in YYYY-MM-DD format, today is 2026-10-11. The arrival date MUST be before the departure date. If the arrival date is not in the future, notify the user that the arrival date is not in the future. |
| country | string | ISO alpha-2 country code that determines market-specific pricing and content. Default: US. |
| filters | object | The filters that you want to apply to the search. Set true or false for each filter. Multiple filters can be selected. |
| children | number | The number of children. |
| currency |
[trivago] Search live hotel and accommodation listings by destination or point of interest, aggregated via trivago's metasearch of major booking sites. Returns results with price, rating, amenities, and a link per property. Supports date range, guest/room configuration, and filters for star rating, guest rating, and amenities. Use for destination- or place-name-based lodging search. Additional Information: {"knownInformation":{"currentYear":"2026","today":"2026-10-11"}}
| Argument | Type | Description |
|---|---|---|
| query* | string | Destination or point of interest. |
| rooms | number | The number of rooms, Number of rooms must be lower than or equal to the number of adults |
| adults | number | The number of adults. |
| arrival* | string | The arrival date in YYYY-MM-DD format, today is 2026-10-11. The arrival date MUST be before the departure date. If the arrival date is not in the future, notify the user that the arrival date is not in the future. |
| country | string | ISO alpha-2 country code that determines market-specific pricing and content. Default: US. |
| filters | object | The filters that you want to apply to the search. Set true or false for each filter. Multiple filters can be selected. |
| children |
[trivago] Forecast monthly hotel price trends for a destination — average, minimum, and maximum nightly rate by star rating, across a date window. Use for planning questions like "when is the cheapest month to visit X" or "how do prices change through the year" — this is a forecasting tool, not a live-availability search. Additional Information: {"knownInformation":{"currentYear":"2026","today":"2026-10-11"}}
| Argument | Type | Description |
|---|---|---|
| query* | string | Destination query. Accepts two formats: - Free-text destination name, e.g. "Berlin", "Paris", "New York". - Coordinate pair in the format lat:<latitude>,long:<longitude>, e.g. "lat:52.52,long:13.405". The nearest destination to those coordinates is used. Latitude must be in [-90, 90] and longitude in [-180, 180]. |
| country | string | ISO alpha-2 country code that determines market-specific pricing and content. Default: US. |
| currency | string | ISO 4217 currency code used to display prices. Default: USD. |
| language | string | Language code for translated content (e.g. EN_US, DE_DE, ZH_HANS_CN). Default: EN_US. |
| end_month | string | Optional end year-month in YYYY-MM format (e.g. 2026-12). Must not be before start_month. Requires start_month to also be set. |
| start_month | string | Optional start year-month in YYYY-MM format (e.g. 2026-06). When omitted, the bridge defaults to the current month plus the next two months. It must be set when end_month is set. |
Check visa requirement for a passport country visiting a destination.
| Argument | Type | Description |
|---|---|---|
| passport* | string | |
| destination* | string |
{
"type": "object",
"title": "visa_checkArguments",
"required": [
"passport",
"destination"
],
"properties": {
"passport": {
"type": "string",
"title": "Passport"
},
"destination": {
"type": "string",
"title": "Destination"
}
}
}Overview of visa-free access for a passport country — counts by category.
| Argument | Type | Description |
|---|---|---|
| passport* | string |
{
"type": "object",
"title": "visa_summaryArguments",
"required": [
"passport"
],
"properties": {
"passport": {
"type": "string",
"title": "Passport"
}
}
}| string |
| Limit to only a specific activity category |
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "When the user wants something w/ a specific keyword (bike, beer, art, etc) limit to experiences whose title contain a keyword. Never include location information."
},
"tagId": {
"type": "string",
"description": "When you have determined the user is interest in a specific vibe of activity (family friendly, romantic, etc) limit to only experiences with a specific tag (single tag ID)"
},
"latLng": {
"type": "string",
"description": "When the user wants something NEAR a specific place, but not necessarily IN a specific place, limit to only those near a given lat_lng. ex: \"37.7799,-122.2822\". Don't use this for regions, instead use the search_regions and provide a region id. this is a good fallback if a specific region is lacking inventory."
},
"endDate": {
"type": "string",
"description": "Return experiences that are available on or before this date in YYYY-MM-DD format (e.g., '2025-06-20' would return things taking place ON or BEFORE the 20th)"
},
"regionId": {
"type": "string",
"description": "When you have determined the user wants something in a specific region (found w/ search_regions) limit to only a specific region ID"
},
"startDate": {
"type": "string",
"description": "Return experiences that are available on or after this date. YYYY-MM-DD format (e.g., '2025-06-19')"
},
"categoryId": {
"type": "string",
"description": "Limit to only a specific activity category"
}
}
}| departureDate* |
| string |
| Preferred departure date (YYYY-MM-DD format) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"origin",
"destination",
"departureDate"
],
"properties": {
"sort": {
"enum": [
"date",
"price"
],
"type": "string",
"default": "date",
"description": "Sort results chronologically or by lowest price first"
},
"adults": {
"type": "integer",
"default": 1,
"maximum": 9,
"minimum": 1,
"description": "Number of adult passengers (default: 1, max: 9)"
},
"origin": {
"type": "string",
"description": "Departure city name or IATA code (will be resolved to IATA code automatically)"
},
"children": {
"type": "integer",
"default": 0,
"maximum": 8,
"minimum": 0,
"description": "Number of child passengers (default: 0, max: 8)"
},
"infantsLap": {
"type": "integer",
"default": 0,
"maximum": 4,
"minimum": 0,
"description": "Number of lap infants (default: 0, max: 4)"
},
"returnDate": {
"anyOf": [
{
"$ref": "#/properties/departureDate"
},
{
"type": "null"
}
],
"description": "Return date for matching trip length (optional, YYYY-MM-DD format)"
},
"destination": {
"type": "string",
"description": "Arrival city name or IATA code (will be resolved to IATA code automatically)"
},
"infantsSeat": {
"type": "integer",
"default": 0,
"maximum": 4,
"minimum": 0,
"description": "Number of seat infants (default: 0, max: 4)"
},
"departureDate": {
"type": "string",
"description": "Preferred departure date (YYYY-MM-DD format)"
}
},
"additionalProperties": false
}| departureDate* | string | Preferred departure date (YYYY-MM-DD format) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"origin",
"destination",
"departureDate",
"returnDate"
],
"properties": {
"sort": {
"enum": [
"date",
"price"
],
"type": "string",
"default": "date",
"description": "Sort results chronologically or by lowest price first"
},
"adults": {
"type": "integer",
"default": 1,
"maximum": 9,
"minimum": 1,
"description": "Number of adult passengers (default: 1, max: 9)"
},
"origin": {
"type": "string",
"description": "Departure city name or IATA code (will be resolved to IATA code automatically)"
},
"children": {
"type": "integer",
"default": 0,
"maximum": 8,
"minimum": 0,
"description": "Number of child passengers (default: 0, max: 8)"
},
"infantsLap": {
"type": "integer",
"default": 0,
"maximum": 4,
"minimum": 0,
"description": "Number of lap infants (default: 0, max: 4)"
},
"returnDate": {
"$ref": "#/properties/departureDate",
"description": "Return date for the reference trip (YYYY-MM-DD format)"
},
"destination": {
"type": "string",
"description": "Arrival city name or IATA code (will be resolved to IATA code automatically)"
},
"infantsSeat": {
"type": "integer",
"default": 0,
"maximum": 4,
"minimum": 0,
"description": "Number of seat infants (default: 0, max: 4)"
},
"departureDate": {
"type": "string",
"description": "Preferred departure date (YYYY-MM-DD format)"
}
},
"additionalProperties": false
}| returnDate | any |
| destination* | string | Arrival location - prefer IATA code |
| infantsSeat | integer | Number of seat infants (default: 0, max: 4) |
| departureDate* | string |
| arrivalAirports | any | Array of specific arrival airport codes to include (when destination city has multiple airports) |
| includeStandard | boolean | Include standard flights (default: true) |
| excludedAirlines | array | Array of excluded airline codes (e.g., ['F9', 'NK']) |
| arrivalTimeLatest | integer | Latest arrival time in minutes from midnight (0-1439) |
| departureAirports | any | Array of specific departure airport codes to include (when origin city has multiple airports) |
| includeHiddenCity | boolean | Include hidden city flights (default: true) |
| maxFlightDuration | integer | Maximum total flight duration in minutes |
| preferredAirlines | array | Array of preferred airline codes (e.g., ['UA', 'DL']) |
| maxLayoverDuration | integer | Maximum layover duration in minutes |
| arrivalTimeEarliest | integer | Earliest arrival time in minutes from midnight (0-1439) |
| departureTimeLatest | integer | Latest departure time in minutes from midnight (0-1439) |
| departureTimeEarliest | integer | Earliest departure time in minutes from midnight (0-1439) |
| includeVirtualInterlining | boolean | Include virtual interlining flights (default: true) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"origin",
"destination",
"departureDate"
],
"properties": {
"sort": {
"enum": [
"price",
"duration",
"value"
],
"type": "string",
"default": "value",
"description": "Sort flights by price (cheapest first), duration (shortest first), or value (best price/time ratio, default)"
},
"limit": {
"type": "integer",
"default": 12,
"maximum": 100,
"minimum": 1,
"description": "Maximum number of flights to return (default: 12, max: 100)"
},
"adults": {
"type": "integer",
"default": 1,
"maximum": 9,
"minimum": 1,
"description": "Number of adult passengers (default: 1, max: 9)"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 99,
"minimum": 0,
"description": "Number of flights to skip for pagination (default: 0)"
},
"origin": {
"type": "string",
"minLength": 1,
"description": "Departure location - prefer IATA code"
},
"children": {
"type": "integer",
"default": 0,
"maximum": 8,
"minimum": 0,
"description": "Number of child passengers (default: 0, max: 8)"
},
"maxStops": {
"enum": [
"none",
"one",
"many"
],
"type": "string",
"description": "Maximum number of stops (none=nonstop, one=1 stop, many=2+ stops)"
},
"fareClass": {
"enum": [
"basic-economy",
"economy",
"premium",
"business",
"first"
],
"type": "string",
"default": "economy",
"description": "Fare class preference (default: economy)"
},
"infantsLap": {
"type": "integer",
"default": 0,
"maximum": 4,
"minimum": 0,
"description": "Number of lap infants (default: 0, max: 4)"
},
"returnDate": {
"$ref": "#/properties/departureDate"
},
"destination": {
"type": "string",
"minLength": 1,
"description": "Arrival location - prefer IATA code"
},
"infantsSeat": {
"type": "integer",
"default": 0,
"maximum": 4,
"minimum": 0,
"description": "Number of seat infants (default: 0, max: 4)"
},
"departureDate": {
"type": "string"
},
"arrivalAirports": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
}
]
},
{
"type": "null"
}
],
"description": "Array of specific arrival airport codes to include (when destination city has multiple airports)"
},
"includeStandard": {
"type": "boolean",
"default": true,
"description": "Include standard flights (default: true)"
},
"excludedAirlines": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of excluded airline codes (e.g., ['F9', 'NK'])"
},
"arrivalTimeLatest": {
"type": "integer",
"maximum": 1439,
"minimum": 0,
"description": "Latest arrival time in minutes from midnight (0-1439)"
},
"departureAirports": {
"anyOf": [
{
"anyOf": [
{
"not": {}
},
{
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
}
]
},
{
"type": "null"
}
],
"description": "Array of specific departure airport codes to include (when origin city has multiple airports)"
},
"includeHiddenCity": {
"type": "boolean",
"default": true,
"description": "Include hidden city flights (default: true)"
},
"maxFlightDuration": {
"type": "integer",
"minimum": 0,
"description": "Maximum total flight duration in minutes"
},
"preferredAirlines": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of preferred airline codes (e.g., ['UA', 'DL'])"
},
"maxLayoverDuration": {
"type": "integer",
"minimum": 0,
"description": "Maximum layover duration in minutes"
},
"arrivalTimeEarliest": {
"type": "integer",
"maximum": 1439,
"minimum": 0,
"description": "Earliest arrival time in minutes from midnight (0-1439)"
},
"departureTimeLatest": {
"type": "integer",
"maximum": 1439,
"minimum": 0,
"description": "Latest departure time in minutes from midnight (0-1439)"
},
"departureTimeEarliest": {
"type": "integer",
"maximum": 1439,
"minimum": 0,
"description": "Earliest departure time in minutes from midnight (0-1439)"
},
"includeVirtualInterlining": {
"type": "boolean",
"default": true,
"description": "Include virtual interlining flights (default: true)"
}
},
"additionalProperties": false
}| Number of children (default: 0, max: 10) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"city",
"checkin",
"checkout"
],
"properties": {
"city": {
"type": "string",
"minLength": 1,
"description": "City name to search for hotels (will be matched against available cities)"
},
"sort": {
"enum": [
"price",
"ranking",
"value",
"discount"
],
"type": "string",
"default": "value",
"description": "Sort hotels by price (cheapest first), ranking (highest rated first), value (best value rating), or discount (best deals first, default when deals available)"
},
"limit": {
"type": "integer",
"default": 12,
"maximum": 100,
"minimum": 1,
"description": "Maximum number of hotels to return (default: 12, max: 100)"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 99,
"minimum": 0,
"description": "Number of hotels to skip for pagination (default: 0)"
},
"checkin": {
"type": "string",
"description": "Check-in date (YYYY-MM-DD format)"
},
"checkout": {
"$ref": "#/properties/checkin",
"description": "Check-out date (YYYY-MM-DD format)"
},
"numRooms": {
"type": "integer",
"default": 1,
"maximum": 9,
"minimum": 1,
"description": "Number of rooms (default: 1, max: 9)"
},
"numAdults": {
"type": "integer",
"default": 2,
"maximum": 10,
"minimum": 1,
"description": "Number of adults (default: 2, max: 10)"
},
"numChildren": {
"type": "integer",
"default": 0,
"maximum": 10,
"minimum": 0,
"description": "Number of children (default: 0, max: 10)"
}
},
"additionalProperties": false
}| Token for fetching the next page of results. Use the nextPageToken value from a previous response. |
| createdAfter | string | Only return reviews created on or after this date (YYYY-MM-DD). Use to bias toward recent reviews. |
| travelledAfter | string | Only return reviews whose trip departed on or after this date (YYYY-MM-DD). Use to surface reviews from recent travellers. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "string",
"default": "",
"description": "Short natural language search query to find specific review topics. Keep it concise — do NOT expand into keyword lists. Use simple phrases like 'food quality', 'guide', 'hotel issues'. The search engine handles semantic matching automatically. Prefer using 'keywords' parameter instead when user intent maps to specific topics. Leave empty to return all reviews."
},
"tourIds": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"minItems": 1,
"description": "Tour IDs to scope reviews to specific tours. Use vertex-tour-title-search to find tour IDs if needed."
},
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of keyword phrases to search reviews for. These are joined with OR logic to find reviews matching any of the given topics. Use short phrases (e.g., ['food quality', 'meals', 'restaurant']). When provided, this takes priority over 'query'."
},
"pageSize": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "Number of reviews to return (1-20, default 10)"
},
"minRating": {
"type": "number",
"maximum": 5,
"minimum": 1,
"description": "Only return reviews with a star rating >= this value (1-5). Use to surface only strong reviews."
},
"pageToken": {
"type": "string",
"description": "Token for fetching the next page of results. Use the nextPageToken value from a previous response."
},
"createdAfter": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Only return reviews created on or after this date (YYYY-MM-DD). Use to bias toward recent reviews."
},
"travelledAfter": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Only return reviews whose trip departed on or after this date (YYYY-MM-DD). Use to surface reviews from recent travellers."
}
}
}| Argument | Type | Description |
|---|---|---|
| price | object | Filter by tour price in the selected currency. E.g., { min: 500, max: 2000, currency: 'EUR' } finds tours priced between €500 and €2000. Min and max value cannot be this same. |
| cities | object | Filter tours by cities visited on the itinerary. City IDs can be obtained from the b2b-cities-search tool |
| max_age | object | Filter by tour's maximum age limit. E.g., { min: 18, max: 39 } finds tours limited to young adults. Use to find age-restricted tours like youth or senior-specific trips. Min and max value cannot be this same. |
| min_age | object | Filter by tour's minimum age requirement. E.g., { min: 1, max: 12 } finds tours that accept children under 12. Use to find family-friendly tours or tours with low age requirements. Min and max value cannot be this same. |
| tourIds | array | Filter by specific tour IDs. Use this to narrow search results to known tours. |
| currency | string | Currency to return prices in. Use this only when the user explicitly asks for a specific currency. Otherwise the user's default (based on location) is used. |
| discount | object | Filter tours by discount percentage. E.g., { min: 10, max: 50 } finds tours with 10% to 50% off. Min and max value cannot be the same. |
| duration | object | Filter tours by duration in days. Example: set min: 5 , max: 8 to find duration between those days. Include this filter when is needed |
| end_city | array | City IDs where the tour ends (e.g., [1234, 5678]). Use b2b-cities-search to find city IDs. If passing multiple values, will find tours ending in any of the given cities |
| countries | object | Filter by countries visited DURING the tour itinerary. Use 'start_country'/'end_country' for departure/destination countries. |
| departures | object | Filter tours by available departure months |
| start_city | array | City IDs where the tour starts (e.g., [1234, 5678]). Use b2b-cities-search to find city IDs. If passing multiple values, will find tours starting in any of the given cities |
| textSearch* | string | |
| end_country | array | Filter by the country where the tour ENDS (final destination). ISO 3166-1 alpha-2 codes (e.g., ['IT', 'FR']). Multiple values = OR logic. Use 'countries' filter for countries visited during the itinerary. |
| display_mode | string | How to display the search results. 'listing' shows a carousel of tour cards. 'map' shows tours on an interactive map. |
| operator_ids | array | Filter tours by specific operator ids. You can add multiple operator ids, then OR operator will be used. For lookup for partner by name, please use algolia-operator-search tool. |
| start_country | array | Filter by the country where the tour BEGINS (departure point). ISO 3166-1 alpha-2 codes (e.g., ['DE', 'AT']). Multiple values = OR logic. Use 'countries' filter for countries visited during the itinerary. |
| max_group_size | object | Filter by tour's maximum group size. E.g., { min: 1, max: 20 } finds small group tours with max 20 participants. Min and max value cannot be this same. |
| min_group_size | object | Filter by tour's minimum group size. E.g., { min: 1, max: 1 } finds tours that accept solo travelers. Min and max value cannot be this same. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"textSearch"
],
"properties": {
"price": {
"type": "object",
"required": [
"min",
"max",
"currency"
],
"properties": {
"max": {
"type": "number",
"description": "Maximum price"
},
"min": {
"type": "number",
"minimum": 0,
"description": "Minimum price"
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"NZD",
"CAD"
],
"type": "string",
"description": "Currency for price values."
}
},
"description": "Filter by tour price in the selected currency. E.g., { min: 500, max: 2000, currency: 'EUR' } finds tours priced between €500 and €2000. Min and max value cannot be this same."
},
"cities": {
"type": "object",
"required": [
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"minItems": 1,
"description": "City IDs that the tour visits. Use b2b-cities-search to find city IDs (e.g., [1234, 5678])"
},
"operator": {
"enum": [
"AND",
"OR"
],
"type": "string",
"default": "OR",
"description": "AND = tour must visit ALL specified cities, OR = tour must visit ANY of the specified cities"
}
},
"description": "Filter tours by cities visited on the itinerary. City IDs can be obtained from the b2b-cities-search tool"
},
"max_age": {
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Maximum value for max age"
},
"min": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Minimum value for max age"
}
},
"description": "Filter by tour's maximum age limit. E.g., { min: 18, max: 39 } finds tours limited to young adults. Use to find age-restricted tours like youth or senior-specific trips. Min and max value cannot be this same."
},
"min_age": {
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Maximum value for min age"
},
"min": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Minimum value for min age"
}
},
"description": "Filter by tour's minimum age requirement. E.g., { min: 1, max: 12 } finds tours that accept children under 12. Use to find family-friendly tours or tours with low age requirements. Min and max value cannot be this same."
},
"tourIds": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"description": "Filter by specific tour IDs. Use this to narrow search results to known tours."
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"AUD",
"NZD",
"CAD"
],
"type": "string",
"description": "Currency to return prices in. Use this only when the user explicitly asks for a specific currency. Otherwise the user's default (based on location) is used."
},
"discount": {
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Maximum discount percentage (0-100)"
},
"min": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Minimum discount percentage (0-100)"
}
},
"description": "Filter tours by discount percentage. E.g., { min: 10, max: 50 } finds tours with 10% to 50% off. Min and max value cannot be the same."
},
"duration": {
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Max tour duration in days"
},
"min": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Min tour duration in days"
}
},
"description": "Filter tours by duration in days. Example: set min: 5 , max: 8 to find duration between those days. Include this filter when is needed"
},
"end_city": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"description": "City IDs where the tour ends (e.g., [1234, 5678]). Use b2b-cities-search to find city IDs. If passing multiple values, will find tours ending in any of the given cities"
},
"countries": {
"type": "object",
"required": [
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"enum": [
"AF",
"AL",
"DZ",
"AD",
"AO",
"AG",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BY",
"BE",
"BZ",
"BJ",
"BT",
"BA",
"BW",
"BR",
"BN",
"BG",
"BF",
"BI",
"KH",
"CM",
"CA",
"CV",
"CF",
"TD",
"CL",
"CN",
"CO",
"KM",
"CD",
"CG",
"CR",
"CI",
"HR",
"CU",
"CY",
"CZ",
"DK",
"DJ",
"DM",
"DO",
"TL",
"EC",
"EG",
"SV",
"GQ",
"ER",
"EE",
"ET",
"FJ",
"FI",
"FR",
"GA",
"GM",
"GE",
"DE",
"GH",
"GR",
"GD",
"GT",
"GN",
"GW",
"GY",
"HT",
"HN",
"HU",
"IS",
"IN",
"ID",
"IR",
"IQ",
"IE",
"IL",
"IT",
"JM",
"JP",
"JO",
"KZ",
"KE",
"KP",
"KR",
"KW",
"KG",
"LA",
"LV",
"LB",
"LS",
"LR",
"LY",
"LI",
"LT",
"LU",
"MK",
"MG",
"MW",
"MY",
"MV",
"ML",
"MR",
"MU",
"MX",
"FM",
"MD",
"MC",
"MN",
"MA",
"MZ",
"MM",
"NA",
"NR",
"NP",
"NZ",
"NI",
"NE",
"NG",
"NO",
"OM",
"PK",
"PA",
"PG",
"PY",
"PE",
"PH",
"PL",
"PT",
"QA",
"RU",
"RW",
"KN",
"LC",
"VC",
"WS",
"SM",
"ST",
"SA",
"SN",
"RS",
"SC",
"SG",
"SK",
"SI",
"SO",
"ZA",
"ES",
"LK",
"SD",
"SZ",
"SE",
"CH",
"SY",
"TW",
"TJ",
"TZ",
"TH",
"TG",
"TO",
"TT",
"TN",
"TR",
"TM",
"UG",
"UA",
"AE",
"US",
"UY",
"UZ",
"VU",
"VA",
"VE",
"VN",
"YE",
"ZM",
"ZW",
"NL",
"BO",
"MT",
"GB",
"NC",
"SB",
"GU",
"PF",
"AS",
"SL",
"EH",
"PS",
"BM",
"GL",
"PM",
"AI",
"AW",
"KY",
"GP",
"MQ",
"MS",
"PR",
"TC",
"VI",
"RO",
"FO",
"GG",
"JE",
"IM",
"SJ",
"GI",
"FK",
"VG",
"RE",
"SR",
"CK",
"ME",
"XK",
"SX",
"CW",
"HK",
"AQ"
],
"type": "string"
},
"minItems": 1,
"description": "ISO 3166-1 alpha-2 country codes that the tour passes through (e.g., [\"DE\", \"AT\", \"CH\"])"
},
"operator": {
"enum": [
"AND",
"OR"
],
"type": "string",
"default": "OR",
"description": "AND = tour must visit ALL specified countries, OR = tour must visit ANY of the specified countries"
}
},
"description": "Filter by countries visited DURING the tour itinerary. Use 'start_country'/'end_country' for departure/destination countries."
},
"departures": {
"type": "object",
"required": [
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}$"
},
"minItems": 1,
"description": "Departure months in YYYY-MM format (e.g., [\"2026-05\", \"2026-06\"])"
},
"operator": {
"enum": [
"AND",
"OR"
],
"type": "string",
"default": "OR",
"description": "AND = tour must have departures in ALL specified months, OR = tour must have departures in ANY of the specified months"
}
},
"description": "Filter tours by available departure months"
},
"start_city": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"description": "City IDs where the tour starts (e.g., [1234, 5678]). Use b2b-cities-search to find city IDs. If passing multiple values, will find tours starting in any of the given cities"
},
"textSearch": {
"type": "string"
},
"end_country": {
"type": "array",
"items": {
"enum": [
"AF",
"AL",
"DZ",
"AD",
"AO",
"AG",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BY",
"BE",
"BZ",
"BJ",
"BT",
"BA",
"BW",
"BR",
"BN",
"BG",
"BF",
"BI",
"KH",
"CM",
"CA",
"CV",
"CF",
"TD",
"CL",
"CN",
"CO",
"KM",
"CD",
"CG",
"CR",
"CI",
"HR",
"CU",
"CY",
"CZ",
"DK",
"DJ",
"DM",
"DO",
"TL",
"EC",
"EG",
"SV",
"GQ",
"ER",
"EE",
"ET",
"FJ",
"FI",
"FR",
"GA",
"GM",
"GE",
"DE",
"GH",
"GR",
"GD",
"GT",
"GN",
"GW",
"GY",
"HT",
"HN",
"HU",
"IS",
"IN",
"ID",
"IR",
"IQ",
"IE",
"IL",
"IT",
"JM",
"JP",
"JO",
"KZ",
"KE",
"KP",
"KR",
"KW",
"KG",
"LA",
"LV",
"LB",
"LS",
"LR",
"LY",
"LI",
"LT",
"LU",
"MK",
"MG",
"MW",
"MY",
"MV",
"ML",
"MR",
"MU",
"MX",
"FM",
"MD",
"MC",
"MN",
"MA",
"MZ",
"MM",
"NA",
"NR",
"NP",
"NZ",
"NI",
"NE",
"NG",
"NO",
"OM",
"PK",
"PA",
"PG",
"PY",
"PE",
"PH",
"PL",
"PT",
"QA",
"RU",
"RW",
"KN",
"LC",
"VC",
"WS",
"SM",
"ST",
"SA",
"SN",
"RS",
"SC",
"SG",
"SK",
"SI",
"SO",
"ZA",
"ES",
"LK",
"SD",
"SZ",
"SE",
"CH",
"SY",
"TW",
"TJ",
"TZ",
"TH",
"TG",
"TO",
"TT",
"TN",
"TR",
"TM",
"UG",
"UA",
"AE",
"US",
"UY",
"UZ",
"VU",
"VA",
"VE",
"VN",
"YE",
"ZM",
"ZW",
"NL",
"BO",
"MT",
"GB",
"NC",
"SB",
"GU",
"PF",
"AS",
"SL",
"EH",
"PS",
"BM",
"GL",
"PM",
"AI",
"AW",
"KY",
"GP",
"MQ",
"MS",
"PR",
"TC",
"VI",
"RO",
"FO",
"GG",
"JE",
"IM",
"SJ",
"GI",
"FK",
"VG",
"RE",
"SR",
"CK",
"ME",
"XK",
"SX",
"CW",
"HK",
"AQ"
],
"type": "string"
},
"description": "Filter by the country where the tour ENDS (final destination). ISO 3166-1 alpha-2 codes (e.g., ['IT', 'FR']). Multiple values = OR logic. Use 'countries' filter for countries visited during the itinerary."
},
"display_mode": {
"enum": [
"listing",
"map"
],
"type": "string",
"default": "listing",
"description": "How to display the search results. 'listing' shows a carousel of tour cards. 'map' shows tours on an interactive map."
},
"operator_ids": {
"type": "array",
"items": {
"type": "number"
},
"description": "Filter tours by specific operator ids. You can add multiple operator ids, then OR operator will be used. For lookup for partner by name, please use algolia-operator-search tool."
},
"start_country": {
"type": "array",
"items": {
"enum": [
"AF",
"AL",
"DZ",
"AD",
"AO",
"AG",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BY",
"BE",
"BZ",
"BJ",
"BT",
"BA",
"BW",
"BR",
"BN",
"BG",
"BF",
"BI",
"KH",
"CM",
"CA",
"CV",
"CF",
"TD",
"CL",
"CN",
"CO",
"KM",
"CD",
"CG",
"CR",
"CI",
"HR",
"CU",
"CY",
"CZ",
"DK",
"DJ",
"DM",
"DO",
"TL",
"EC",
"EG",
"SV",
"GQ",
"ER",
"EE",
"ET",
"FJ",
"FI",
"FR",
"GA",
"GM",
"GE",
"DE",
"GH",
"GR",
"GD",
"GT",
"GN",
"GW",
"GY",
"HT",
"HN",
"HU",
"IS",
"IN",
"ID",
"IR",
"IQ",
"IE",
"IL",
"IT",
"JM",
"JP",
"JO",
"KZ",
"KE",
"KP",
"KR",
"KW",
"KG",
"LA",
"LV",
"LB",
"LS",
"LR",
"LY",
"LI",
"LT",
"LU",
"MK",
"MG",
"MW",
"MY",
"MV",
"ML",
"MR",
"MU",
"MX",
"FM",
"MD",
"MC",
"MN",
"MA",
"MZ",
"MM",
"NA",
"NR",
"NP",
"NZ",
"NI",
"NE",
"NG",
"NO",
"OM",
"PK",
"PA",
"PG",
"PY",
"PE",
"PH",
"PL",
"PT",
"QA",
"RU",
"RW",
"KN",
"LC",
"VC",
"WS",
"SM",
"ST",
"SA",
"SN",
"RS",
"SC",
"SG",
"SK",
"SI",
"SO",
"ZA",
"ES",
"LK",
"SD",
"SZ",
"SE",
"CH",
"SY",
"TW",
"TJ",
"TZ",
"TH",
"TG",
"TO",
"TT",
"TN",
"TR",
"TM",
"UG",
"UA",
"AE",
"US",
"UY",
"UZ",
"VU",
"VA",
"VE",
"VN",
"YE",
"ZM",
"ZW",
"NL",
"BO",
"MT",
"GB",
"NC",
"SB",
"GU",
"PF",
"AS",
"SL",
"EH",
"PS",
"BM",
"GL",
"PM",
"AI",
"AW",
"KY",
"GP",
"MQ",
"MS",
"PR",
"TC",
"VI",
"RO",
"FO",
"GG",
"JE",
"IM",
"SJ",
"GI",
"FK",
"VG",
"RE",
"SR",
"CK",
"ME",
"XK",
"SX",
"CW",
"HK",
"AQ"
],
"type": "string"
},
"description": "Filter by the country where the tour BEGINS (departure point). ISO 3166-1 alpha-2 codes (e.g., ['DE', 'AT']). Multiple values = OR logic. Use 'countries' filter for countries visited during the itinerary."
},
"max_group_size": {
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Maximum value for max group size"
},
"min": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Minimum value for max group size"
}
},
"description": "Filter by tour's maximum group size. E.g., { min: 1, max: 20 } finds small group tours with max 20 participants. Min and max value cannot be this same. "
},
"min_group_size": {
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Maximum value for min group size"
},
"min": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Minimum value for min group size"
}
},
"description": "Filter by tour's minimum group size. E.g., { min: 1, max: 1 } finds tours that accept solo travelers. Min and max value cannot be this same."
}
}
}| string |
| Customer phone number in E-164 format. Optional but recommended. Never put a fake phone number; if the customer does not provide one, skip this field. |
| agentInformation | string | Optional agent context about the customer's needs/preferences. Helps Customer Support. The customer's question stays primary; this is appended as extra context. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity",
"question",
"email",
"firstName",
"lastName"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Customer email address. If email is not given by the customer, please ask before executing this tool. Never generate an email yourself."
},
"entity": {
"oneOf": [
{
"type": "object",
"required": [
"mode",
"tourId"
],
"properties": {
"mode": {
"type": "string",
"const": "tour",
"description": "Use \"tour\" for a question about a specific tour."
},
"tourId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Tour ID. Required for a tour question.",
"exclusiveMinimum": 0
},
"paxAdults": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Number of adults. Defaults to 1 when omitted.",
"exclusiveMinimum": 0
},
"paxChildren": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of children. Defaults to 0 when omitted."
},
"departureDate": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Optional departure date, from the customer selection. Omit if the customer has not chosen a date — do not fabricate one; the backend will pick the nearest real departure."
}
}
},
{
"type": "object",
"required": [
"mode",
"operatorId"
],
"properties": {
"mode": {
"type": "string",
"const": "operator",
"description": "Use \"operator\" for a general/operator-level question (no specific tour)."
},
"operatorId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Operator ID. Required for an operator question.",
"exclusiveMinimum": 0
}
}
}
],
"description": "What the question is about. Pick exactly one mode: \"tour\" (carries `tourId` + optional departure/pax) or \"operator\" (carries `operatorId`). A tour question cannot carry an operator id and vice versa."
},
"lastName": {
"type": "string",
"description": "Customer last name."
},
"question": {
"type": "string",
"minLength": 1,
"description": "The customer's actual question text. Required and must be non-empty. This is the question the customer wants answered."
},
"firstName": {
"type": "string",
"description": "Customer first name."
},
"phoneNumber": {
"type": "string",
"description": "Customer phone number in E-164 format. Optional but recommended. Never put a fake phone number; if the customer does not provide one, skip this field."
},
"agentInformation": {
"type": "string",
"description": "Optional agent context about the customer's needs/preferences. Helps Customer Support. The customer's question stays primary; this is appended as extra context."
}
}
}| departureDate* | string | Departure date, from customer selection |
| agentInformation* | string | Agent information about the booking. Describe here what customer is looked for, preferences etc, what you can recognize. Will be helpful for our Customer Support team to understand the customer needs. |
| extraInformation* | string | Customer extra information from the customer or agent. Fill here if customer has provided any additional information about the booking. This is optional and can be empty. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tourId",
"email",
"firstName",
"lastName",
"departureDate",
"extraInformation",
"agentInformation",
"paxAdults",
"paxChildren"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Customer email address. If email is not given by the customer, please ask him before executing this endpoint. Never generate email by yourself, always ask customer for give the email before calling this tool."
},
"tourId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Tour ID",
"exclusiveMinimum": 0
},
"lastName": {
"type": "string"
},
"firstName": {
"type": "string"
},
"paxAdults": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Number of the adults. Always ask customer for this information, is important to have it",
"exclusiveMinimum": 0
},
"paxChildren": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Number of the children"
},
"phoneNumber": {
"type": "string",
"description": "Customer phone number in E-164 format. Is optional, but recommended to provide it. Never put fake phone number, always ask customer for give the phone number before calling this tool. If customer do not gives phone number, just skip this field"
},
"departureDate": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Departure date, from customer selection"
},
"agentInformation": {
"type": "string",
"description": "Agent information about the booking. Describe here what customer is looked for, preferences etc, what you can recognize. Will be helpful for our Customer Support team to understand the customer needs."
},
"extraInformation": {
"type": "string",
"description": "Customer extra information from the customer or agent. Fill here if customer has provided any additional information about the booking. This is optional and can be empty."
}
}
}| string |
| ISO 4217 currency code used to display prices. Default: USD. |
| language | string | Language code for translated content (e.g. EN_US, DE_DE, ZH_HANS_CN). Default: EN_US. |
| latitude* | number | Latitude of the search target location (landmark, address, or neighborhood — not the user's location). |
| departure* | string | The departure date in YYYY-MM-DD format, today is 2026-10-11. The departure date MUST be after the arrival date. If the departure date is not after the arrival date, notify the user that the departure date is not after the arrival date. |
| longitude* | number | Longitude of the search target location (landmark, address, or neighborhood — not the user's location). |
| hotel_rating | object | The hotel rating that you want to filter by. Set true or false for each rating. Multiple ratings can be selected. |
| children_ages | string | Dashed separated list of children ages, e.g. 10-12-14 |
| review_rating | object | The guest review rating that you want to filter by. Set true or false for each rating. Multiple ratings can be selected. |
{
"type": "object",
"required": [
"latitude",
"longitude",
"arrival",
"departure"
],
"properties": {
"rooms": {
"type": "number",
"minimum": 1,
"description": "\n\t\tThe number of rooms, Number of rooms must be lower than or equal to the number of adults\n\t"
},
"adults": {
"type": "number",
"minimum": 1,
"description": "\n\t\tThe number of adults.\n\t"
},
"arrival": {
"type": "string",
"description": "\n\t\tThe arrival date in YYYY-MM-DD format, today is 2026-10-11.\n\n\t\tThe arrival date MUST be before the departure date. If the arrival date is not in the future, notify the user that the arrival date is not in the future.\n\t\t"
},
"country": {
"enum": [
"AE",
"AR",
"AT",
"AU",
"BE",
"BR",
"CA",
"CH",
"CL",
"CO",
"CZ",
"DE",
"DK",
"EG",
"ES",
"FI",
"FR",
"GB",
"GR",
"HK",
"HU",
"ID",
"IE",
"IL",
"IN",
"IT",
"JP",
"KR",
"MX",
"MY",
"NL",
"NO",
"NZ",
"PE",
"PH",
"PL",
"PT",
"RO",
"RU",
"SA",
"SE",
"SG",
"TH",
"TR",
"TW",
"UA",
"US",
"VN",
"ZA"
],
"type": "string",
"default": "US",
"description": "ISO alpha-2 country code that determines market-specific pricing and content. Default: US."
},
"filters": {
"type": "object",
"properties": {
"gym": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a gym"
},
"spa": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a spa"
},
"pool": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a pool"
},
"kitchen": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a kitchen"
},
"parking": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has parking"
},
"freeWiFi": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has free WiFi"
},
"petFriendly": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation is pet friendly"
},
"airConditioning": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has air conditioning"
},
"freeCancellation": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has free cancellation"
},
"breakfastIncluded": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation includes breakfast"
}
},
"description": "\n\t\tThe filters that you want to apply to the search.\n\t\tSet true or false for each filter.\n\t\tMultiple filters can be selected.\n\t\t"
},
"children": {
"type": "number",
"minimum": 0,
"description": "\n\t\tThe number of children.\n\t"
},
"currency": {
"enum": [
"AED",
"ARS",
"AUD",
"BRL",
"CAD",
"CHF",
"CLP",
"CNY",
"COP",
"CZK",
"DKK",
"EGP",
"EUR",
"GBP",
"HKD",
"HUF",
"IDR",
"ILS",
"INR",
"JPY",
"KRW",
"MXN",
"MYR",
"NOK",
"NZD",
"PEN",
"PHP",
"PLN",
"RON",
"RUB",
"SAR",
"SEK",
"SGD",
"THB",
"TRY",
"TWD",
"UAH",
"USD",
"VND",
"ZAR"
],
"type": "string",
"default": "USD",
"description": "ISO 4217 currency code used to display prices. Default: USD."
},
"language": {
"enum": [
"AR145",
"CS_CZ",
"DA_DK",
"DE_AT",
"DE_CH",
"DE_DE",
"EL_GR",
"EN_AU",
"EN_GB",
"EN_HK",
"EN_IE",
"EN_IN",
"EN_NZ",
"EN_PH",
"EN_SG",
"EN_US",
"EN_ZA",
"ES_AR",
"ES_CL",
"ES_CO",
"ES_ES",
"ES_MX",
"ES_PE",
"FI_FI",
"FR_BE",
"FR_CH",
"FR_FR",
"HE_IL",
"HU_HU",
"ID_ID",
"IT_IT",
"JA_JP",
"KO_KR",
"MS_MY",
"NL_BE",
"NL_NL",
"NO_NO",
"PL_PL",
"PT_BR",
"PT_PT",
"RO_RO",
"RU_RU",
"SV_SE",
"TH_TH",
"TR_TR",
"VI_VN",
"ZH_HANS_CN",
"ZH_HANT_HK",
"ZH_HANT_TW"
],
"type": "string",
"default": "EN_US",
"description": "Language code for translated content (e.g. EN_US, DE_DE, ZH_HANS_CN). Default: EN_US."
},
"latitude": {
"type": "number",
"description": "Latitude of the search target location (landmark, address, or neighborhood — not the user's location)."
},
"departure": {
"type": "string",
"description": "\n\t\tThe departure date in YYYY-MM-DD format, today is 2026-10-11.\n\n\t\tThe departure date MUST be after the arrival date. If the departure date is not after the arrival date, notify the user that the departure date is not after the arrival date.\n\t\t"
},
"longitude": {
"type": "number",
"description": "Longitude of the search target location (landmark, address, or neighborhood — not the user's location)."
},
"hotel_rating": {
"type": "object",
"properties": {
"1star": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a 1 star rating"
},
"2star": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a 2 star rating"
},
"3star": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a 3 star rating"
},
"4star": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a 4 star rating"
},
"5star": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a 5 star rating"
}
},
"description": "\n\t\tThe hotel rating that you want to filter by.\n\t\tSet true or false for each rating.\n\t\tMultiple ratings can be selected.\n\t"
},
"children_ages": {
"type": "string",
"description": "\n\t\tDashed separated list of children ages, e.g. 10-12-14\n\t"
},
"review_rating": {
"type": "object",
"properties": {
"rating70": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a Guest Rating of 7.0+"
},
"rating75": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a Guest Rating of 7.5+"
},
"rating80": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a Guest Rating of 8.0+"
},
"rating85": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a Guest Rating of 8.5+"
}
},
"description": "\n\t\tThe guest review rating that you want to filter by.\n\t\tSet true or false for each rating.\n\t\tMultiple ratings can be selected.\n\t"
}
}
}| number |
| The number of children. |
| currency | string | ISO 4217 currency code used to display prices. Default: USD. |
| language | string | Language code for translated content (e.g. EN_US, DE_DE, ZH_HANS_CN). Default: EN_US. |
| departure* | string | The departure date in YYYY-MM-DD format, today is 2026-10-11. The departure date MUST be after the arrival date. If the departure date is not after the arrival date, notify the user that the departure date is not after the arrival date. |
| hotel_rating | object | The hotel rating that you want to filter by. Set true or false for each rating. Multiple ratings can be selected. |
| children_ages | string | Dashed separated list of children ages, e.g. 10-12-14 |
| review_rating | object | The guest review rating that you want to filter by. Set true or false for each rating. Multiple ratings can be selected. |
{
"type": "object",
"required": [
"query",
"arrival",
"departure"
],
"properties": {
"query": {
"type": "string",
"description": "Destination or point of interest."
},
"rooms": {
"type": "number",
"minimum": 1,
"description": "\n\t\tThe number of rooms, Number of rooms must be lower than or equal to the number of adults\n\t"
},
"adults": {
"type": "number",
"minimum": 1,
"description": "\n\t\tThe number of adults.\n\t"
},
"arrival": {
"type": "string",
"description": "\n\t\tThe arrival date in YYYY-MM-DD format, today is 2026-10-11.\n\n\t\tThe arrival date MUST be before the departure date. If the arrival date is not in the future, notify the user that the arrival date is not in the future.\n\t\t"
},
"country": {
"enum": [
"AE",
"AR",
"AT",
"AU",
"BE",
"BR",
"CA",
"CH",
"CL",
"CO",
"CZ",
"DE",
"DK",
"EG",
"ES",
"FI",
"FR",
"GB",
"GR",
"HK",
"HU",
"ID",
"IE",
"IL",
"IN",
"IT",
"JP",
"KR",
"MX",
"MY",
"NL",
"NO",
"NZ",
"PE",
"PH",
"PL",
"PT",
"RO",
"RU",
"SA",
"SE",
"SG",
"TH",
"TR",
"TW",
"UA",
"US",
"VN",
"ZA"
],
"type": "string",
"default": "US",
"description": "ISO alpha-2 country code that determines market-specific pricing and content. Default: US."
},
"filters": {
"type": "object",
"properties": {
"gym": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a gym"
},
"spa": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a spa"
},
"pool": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a pool"
},
"kitchen": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a kitchen"
},
"parking": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has parking"
},
"freeWiFi": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has free WiFi"
},
"petFriendly": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation is pet friendly"
},
"airConditioning": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has air conditioning"
},
"freeCancellation": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has free cancellation"
},
"breakfastIncluded": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation includes breakfast"
}
},
"description": "\n\t\tThe filters that you want to apply to the search.\n\t\tSet true or false for each filter.\n\t\tMultiple filters can be selected.\n\t\t"
},
"children": {
"type": "number",
"minimum": 0,
"description": "\n\t\tThe number of children.\n\t"
},
"currency": {
"enum": [
"AED",
"ARS",
"AUD",
"BRL",
"CAD",
"CHF",
"CLP",
"CNY",
"COP",
"CZK",
"DKK",
"EGP",
"EUR",
"GBP",
"HKD",
"HUF",
"IDR",
"ILS",
"INR",
"JPY",
"KRW",
"MXN",
"MYR",
"NOK",
"NZD",
"PEN",
"PHP",
"PLN",
"RON",
"RUB",
"SAR",
"SEK",
"SGD",
"THB",
"TRY",
"TWD",
"UAH",
"USD",
"VND",
"ZAR"
],
"type": "string",
"default": "USD",
"description": "ISO 4217 currency code used to display prices. Default: USD."
},
"language": {
"enum": [
"AR145",
"CS_CZ",
"DA_DK",
"DE_AT",
"DE_CH",
"DE_DE",
"EL_GR",
"EN_AU",
"EN_GB",
"EN_HK",
"EN_IE",
"EN_IN",
"EN_NZ",
"EN_PH",
"EN_SG",
"EN_US",
"EN_ZA",
"ES_AR",
"ES_CL",
"ES_CO",
"ES_ES",
"ES_MX",
"ES_PE",
"FI_FI",
"FR_BE",
"FR_CH",
"FR_FR",
"HE_IL",
"HU_HU",
"ID_ID",
"IT_IT",
"JA_JP",
"KO_KR",
"MS_MY",
"NL_BE",
"NL_NL",
"NO_NO",
"PL_PL",
"PT_BR",
"PT_PT",
"RO_RO",
"RU_RU",
"SV_SE",
"TH_TH",
"TR_TR",
"VI_VN",
"ZH_HANS_CN",
"ZH_HANT_HK",
"ZH_HANT_TW"
],
"type": "string",
"default": "EN_US",
"description": "Language code for translated content (e.g. EN_US, DE_DE, ZH_HANS_CN). Default: EN_US."
},
"departure": {
"type": "string",
"description": "\n\t\tThe departure date in YYYY-MM-DD format, today is 2026-10-11.\n\n\t\tThe departure date MUST be after the arrival date. If the departure date is not after the arrival date, notify the user that the departure date is not after the arrival date.\n\t\t"
},
"hotel_rating": {
"type": "object",
"properties": {
"1star": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a 1 star rating"
},
"2star": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a 2 star rating"
},
"3star": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a 3 star rating"
},
"4star": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a 4 star rating"
},
"5star": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a 5 star rating"
}
},
"description": "\n\t\tThe hotel rating that you want to filter by.\n\t\tSet true or false for each rating.\n\t\tMultiple ratings can be selected.\n\t"
},
"children_ages": {
"type": "string",
"description": "\n\t\tDashed separated list of children ages, e.g. 10-12-14\n\t"
},
"review_rating": {
"type": "object",
"properties": {
"rating70": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a Guest Rating of 7.0+"
},
"rating75": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a Guest Rating of 7.5+"
},
"rating80": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a Guest Rating of 8.0+"
},
"rating85": {
"type": "boolean",
"default": false,
"description": "Whether the accommodation has a Guest Rating of 8.5+"
}
},
"description": "\n\t\tThe guest review rating that you want to filter by.\n\t\tSet true or false for each rating.\n\t\tMultiple ratings can be selected.\n\t"
}
}
}| hotel_rating | object | The hotel star ratings to include in the price statistics. Only 3, 4, and 5-star hotels are supported — forecasted price statistics are not available for 1 or 2-star hotels. Set true or false for each rating. Multiple ratings can be selected. When no rating is selected, the results default to 3-star hotels only. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "\nDestination query. Accepts two formats:\n- Free-text destination name, e.g. \"Berlin\", \"Paris\", \"New York\".\n- Coordinate pair in the format lat:<latitude>,long:<longitude>, e.g. \"lat:52.52,long:13.405\". The nearest destination to those coordinates is used. Latitude must be in [-90, 90] and longitude in [-180, 180].\n\t"
},
"country": {
"enum": [
"AE",
"AR",
"AT",
"AU",
"BE",
"BR",
"CA",
"CH",
"CL",
"CO",
"CZ",
"DE",
"DK",
"EG",
"ES",
"FI",
"FR",
"GB",
"GR",
"HK",
"HU",
"ID",
"IE",
"IL",
"IN",
"IT",
"JP",
"KR",
"MX",
"MY",
"NL",
"NO",
"NZ",
"PE",
"PH",
"PL",
"PT",
"RO",
"RU",
"SA",
"SE",
"SG",
"TH",
"TR",
"TW",
"UA",
"US",
"VN",
"ZA"
],
"type": "string",
"default": "US",
"description": "ISO alpha-2 country code that determines market-specific pricing and content. Default: US."
},
"currency": {
"enum": [
"AED",
"ARS",
"AUD",
"BRL",
"CAD",
"CHF",
"CLP",
"CNY",
"COP",
"CZK",
"DKK",
"EGP",
"EUR",
"GBP",
"HKD",
"HUF",
"IDR",
"ILS",
"INR",
"JPY",
"KRW",
"MXN",
"MYR",
"NOK",
"NZD",
"PEN",
"PHP",
"PLN",
"RON",
"RUB",
"SAR",
"SEK",
"SGD",
"THB",
"TRY",
"TWD",
"UAH",
"USD",
"VND",
"ZAR"
],
"type": "string",
"default": "USD",
"description": "ISO 4217 currency code used to display prices. Default: USD."
},
"language": {
"enum": [
"AR145",
"CS_CZ",
"DA_DK",
"DE_AT",
"DE_CH",
"DE_DE",
"EL_GR",
"EN_AU",
"EN_GB",
"EN_HK",
"EN_IE",
"EN_IN",
"EN_NZ",
"EN_PH",
"EN_SG",
"EN_US",
"EN_ZA",
"ES_AR",
"ES_CL",
"ES_CO",
"ES_ES",
"ES_MX",
"ES_PE",
"FI_FI",
"FR_BE",
"FR_CH",
"FR_FR",
"HE_IL",
"HU_HU",
"ID_ID",
"IT_IT",
"JA_JP",
"KO_KR",
"MS_MY",
"NL_BE",
"NL_NL",
"NO_NO",
"PL_PL",
"PT_BR",
"PT_PT",
"RO_RO",
"RU_RU",
"SV_SE",
"TH_TH",
"TR_TR",
"VI_VN",
"ZH_HANS_CN",
"ZH_HANT_HK",
"ZH_HANT_TW"
],
"type": "string",
"default": "EN_US",
"description": "Language code for translated content (e.g. EN_US, DE_DE, ZH_HANS_CN). Default: EN_US."
},
"end_month": {
"type": "string",
"description": "\nOptional end year-month in YYYY-MM format (e.g. 2026-12). Must not be before start_month. Requires start_month to also be set.\n\t"
},
"start_month": {
"type": "string",
"description": "\nOptional start year-month in YYYY-MM format (e.g. 2026-06). When omitted, the bridge defaults to the current month plus the next two months. It must be set when end_month is set.\n\t"
},
"hotel_rating": {
"type": "object",
"properties": {
"3star": {
"type": "boolean",
"default": false,
"description": "Include 3-star hotels in the price statistics"
},
"4star": {
"type": "boolean",
"default": false,
"description": "Include 4-star hotels in the price statistics"
},
"5star": {
"type": "boolean",
"default": false,
"description": "Include 5-star hotels in the price statistics"
}
},
"description": "\n\t\tThe hotel star ratings to include in the price statistics.\n\t\tOnly 3, 4, and 5-star hotels are supported — forecasted price statistics are not available for 1 or 2-star hotels.\n\t\tSet true or false for each rating. Multiple ratings can be selected.\n\t\tWhen no rating is selected, the results default to 3-star hotels only.\n\t"
}
}
}