Search Tours & Activities
search_toursSearch for bookable tours, activities, excursions, and experiences at a destination using GetYourGuide with Viator and Tiqets travelpayouts fallbacks. Returns tour options with titles, prices, ratings, durations, and booking links. Use when the user asks about things to do, tours, activities, excursions, or experiences in a city or destination.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Optional date in YYYY-MM-DD format to filter tours available on that day. | |
| limit | No | Maximum number of tour results to return (default 10, max 30). | |
| query | Yes | Search query — a destination, activity type, or combination (e.g. 'walking tour Rome', 'snorkeling Cancun'). | |
| trip_id | No | Optional Tineo trip ID (from trips_list) this request is for. Used only to default the currency to that trip's currency when currency is omitted and the user has no preferred currency; ignored if the trip is not found or not accessible to the user. | |
| currency | No | Optional ISO-style three-letter currency code. Omit to use the user's preferred currency, then the currency of the trip given by trip_id, then USD. | |
| provider | No | Preferred tour provider to search ('all', 'getyourguide', or 'viator'). Default is 'all'. |