# Viator API: Search tours > Finds tours and experiences in a city on Viator, with optional keywords, date, currency and sorting. Prices are starting prices. Unofficial. Not affiliated with or endorsed by Viator. - Page: https://fous.com/methods/viator.com/search-tours - Method: `viator.com/search_tours`, version 1 - Website: viator.com - Returns: title, rating, review count, starting price, currency, duration, free cancellation, badges, short description, link, product code - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `city` | string | yes | `"Paris"` | City to explore, e.g. Paris. | | `date` | string | no | | Day tours should be available (YYYY-MM-DD), e.g. 2026-10-18. | | `sort` | string | no | | Order of tours, e.g. featured. One of "featured", "price_low_to_high", "rating". Default "featured". | | `query` | string | no | | Tour topic or attraction, e.g. Eiffel Tower. Leave blank for any tours. Default "". | | `currency` | string | no | | Three-letter price currency, e.g. EUR. Default "USD". | | `max_results` | integer | no | | Maximum tours to return, e.g. 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "city": "Paris" } ``` Its output: ```json { "tours": [ { "link": "https://www.viator.com/tours/Paris/Golden-Versailles-Palace-and-Garden-Tour/d479-67584P2", "title": "Versailles Palace and Gardens Tour from Paris", "badges": [ "Best Seller" ], "rating": 4.4, "currency": "USD", "duration": "3 hours to 3 hours 30 minutes", "product_code": "67584P2", "review_count": 4577, "free_cancellation": true, "short_description": "On this eminently civilized guided tour with a round trip transportation from Paris. Your guide will show you the most magnificent of the 2,000 rooms, including the Hall of Mirrors, the King’s State Apartments, and the King’s Private Apartments, then introduce you to the magical 2,000-acre (800-hect…", "starting_price_per_person": 74.11 }, { "link": "https://www.viator.com/tours/Paris/Aperitif-Cruise-on-the-Seine-River/d479-9511P47", "title": "Paris Seine River Sunset & Evening Champagne Cruises", "badges": [ "Likely to Sell Out" ], "rating": 4.1, "currency": "USD", "duration": "1 hour", "product_code": "9511P47", "review_count": 633, "free_cancellation": true, "short_description": "Skip your usual land-lubber evening drink with this River Seine sunset cruise with an aperitif. Meet near Pont Neuf just before sunset and hop aboard a river boat with a terrace—take a seat and cruise past Notre-Dame Cathedral, the Louvre, Musée d’Orsay, and the Eiffel Tower with a glass of organic …", "starting_price_per_person": 45.16 }, { "link": "https://www.viator.com/tours/Paris/Paris-in-A-Day-Louvre-Eiffel-Tower-Notre-Dame-and-Seine-Cruise/d479-46018P3", "title": "Paris in A Day Louvre Eiffel Tower Notre Dame and Seine Cruise", "badges": [], "rating": 4.8, "currency": "USD", "duration": "4 hours to 9 hours", "product_code": "46018P3", "review_count": 2552, "free_cancellation": true, "short_description": "Discover Paris' most iconic landmarks in a single day on this time-saving tour. In addition to getting an included ticket to the Louvre Museum (if option selected), you'll also explore neighborhoods including Montmartre and Île de la Cité on guided walks. Cover more ground in the city than you could…", "starting_price_per_person": 114.63 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"viator.com/search_tours","input":{"city":"Paris"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find food tours in Rome available on 2026-05-14, sorted by rating, prices in EUR - What are the cheapest things to do in Lisbon? Show me 10 options lowest price first. - Search Viator for Sagrada Familia skip-the-line tours in Barcelona, top 15 by rating - I'm in Kyoto on 2026-11-03 — list tours I can book that day with prices in JPY, and tell me which have free cancellation - Pull up featured experiences on viator.com for New York City, snorkeling or boat trips not needed, just general tours, max 25 results in USD ## Input schema ```json { "type": "object", "required": [ "city" ], "properties": { "city": { "type": "string", "minLength": 1, "description": "City to explore, e.g. Paris." }, "date": { "type": "string", "description": "Day tours should be available (YYYY-MM-DD), e.g. 2026-10-18." }, "sort": { "enum": [ "featured", "price_low_to_high", "rating" ], "type": "string", "default": "featured", "description": "Order of tours, e.g. featured." }, "query": { "type": "string", "default": "", "description": "Tour topic or attraction, e.g. Eiffel Tower. Leave blank for any tours." }, "currency": { "type": "string", "default": "USD", "maxLength": 3, "minLength": 3, "description": "Three-letter price currency, e.g. EUR." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum tours to return, e.g. 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "tours" ], "properties": { "tours": { "type": "array", "items": { "type": "object", "required": [ "link", "title", "badges", "rating", "currency", "duration", "product_code", "review_count", "free_cancellation", "short_description", "starting_price_per_person" ], "properties": { "link": { "type": "string", "description": "Viator tour page link." }, "title": { "type": "string", "description": "Tour title." }, "badges": { "type": "array", "items": { "type": "string" }, "description": "Badges shown on the listing." }, "rating": { "type": [ "number", "null" ], "description": "Rating out of five." }, "currency": { "type": "string", "description": "Price currency." }, "duration": { "type": [ "string", "null" ], "description": "Tour duration." }, "product_code": { "type": "string", "description": "Viator product code." }, "review_count": { "type": [ "integer", "null" ], "description": "Number of reviews." }, "free_cancellation": { "type": [ "boolean", "null" ], "description": "Whether cancellation is free." }, "short_description": { "type": [ "string", "null" ], "description": "Short description when shown." }, "starting_price_per_person": { "type": [ "number", "null" ], "description": "Starting price per person." } } }, "description": "Tours matching the city and filters." } } } ``` ## See more - [GetYourGuide API: Search activities](https://fous.com/methods/getyourguide.com/search-activities.md): Finds GetYourGuide tours, tickets and activities in a city, optionally matching words, available on a day, sorted by popularity, price or rating, with prices, ratings and booking features. - [Klook API: Search activities](https://fous.com/methods/klook.com/search-activities.md): Finds Klook activities, tickets, tours and passes in a city, with ratings, booking counts, prices and booking policies. Keyword matches are ranked by Klook and may include related activities. - [Tripadvisor API: List top attractions in a city](https://fous.com/methods/tripadvisor.com/list-top-attractions.md): Lists Tripadvisor's ranked things to do in a city from the first results page, for all attractions or one category (tours, museums, sights and landmarks, nature and parks), with rating, review count, category, and the description or neighbourhood when shown. - [Trip.com API: Search hotels](https://fous.com/methods/trip.com/search-hotels.md): Finds hotels in a city on Trip.com for given dates, with prices, guest ratings, reviews and booking links. Only the initial public listing is read, so large limits may return fewer hotels. - [Tripadvisor API: List top restaurants in a city](https://fous.com/methods/tripadvisor.com/list-top-restaurants.md): Lists Tripadvisor's ranked restaurants in a city from the first results page, optionally filtered by cuisine and price category. Sponsored listings are left out; up to 30 restaurants with rating, review count, cuisines, price range and address. - [Agoda API: Search hotels](https://fous.com/methods/agoda.com/search-hotels.md): Finds available Agoda stays in a city for your dates, with prices before taxes and fees, star and guest ratings, and free-cancellation status. - [Hostelworld API: Search hostels](https://fous.com/methods/hostelworld.com/search-hostels.md): Finds available hostels, hotels and guesthouses on Hostelworld in a city for given dates, with per-night dorm and private room prices, ratings, facilities and booking links. - [Tripadvisor API: Get reviews](https://fous.com/methods/tripadvisor.com/get-reviews.md): Gets the latest traveler reviews for a hotel, restaurant or attraction in a city (by name or Tripadvisor listing link), with the place's overall rating and review count. Dates of visit show the month and year when provided.