# GetYourGuide API: Search activities > 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. Unofficial. Not affiliated with or endorsed by GetYourGuide. - Page: https://fous.com/methods/getyourguide.com/search-activities - Method: `getyourguide.com/search_activities`, version 1 - Website: getyourguide.com - Returns: title, rating, reviews, starting price, currency, duration, free cancellation, skip the line, description, link, activity id - 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 | `"Amsterdam"` | City to explore, such as Amsterdam. | | `date` | string | no | | Only activities available on this day (YYYY-MM-DD), such as 2026-10-10. | | `sort` | string | no | | Order by popularity, lowest price or rating, such as rating. One of "popularity", "price_low_to_high", "rating". Default "popularity". | | `query` | string | no | | Activity to look for, such as canal cruise; blank for any. Default "". | | `currency` | string | no | | Three-letter price currency, such as EUR. Default "USD". | | `max_results` | integer | no | `25` | Maximum number of activities, such as 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "city": "Amsterdam", "max_results": 25 } ``` Its output: ```json { "activities": [ { "link": "https://www.getyourguide.com/amsterdam-l36/amsterdam-luxury-canal-cruise-with-unlimited-drinks-bite-t396132/", "title": "Canal Cruise with Unlimited Drinks & Bites Option", "rating": 4.5, "currency": "USD", "duration": "1 hour", "activity_id": "396132", "skip_the_line": false, "free_cancellation": true, "number_of_reviews": 26803, "short_description": "See Amsterdam best way possible on a boat with a live guide and optional unlimited drinks. On sunny days cruise on an open boat. If it rains, enjoy a warm and covered classic saloon boat instead.", "starting_price_per_person": 22 }, { "link": "https://www.getyourguide.com/amsterdam-l36/amsterdam-evening-sunset-canal-cruise-w-optional-drinks-t963935/", "title": "Amsterdam Evening (Sunset) Canal Cruise w/ optional drinks", "rating": 4.8, "currency": "USD", "duration": "1 hour", "activity_id": "963935", "skip_the_line": true, "free_cancellation": true, "number_of_reviews": 5034, "short_description": "Enjoy the sunset during this 1 hour evening cruise while you sail through the city's canals.\nHear about the sights from your local skipper in English or through a digital guide in 8 languages.", "starting_price_per_person": 22 }, { "link": "https://www.getyourguide.com/amsterdam-l36/e-bike-the-dutch-countryside-windmill-fields-cheese-farm-t57233/", "title": "Windmill & Dutch Cheese farm electric bike tour", "rating": 4.6, "currency": "USD", "duration": "4 hours", "activity_id": "57233", "skip_the_line": false, "free_cancellation": true, "number_of_reviews": 1539, "short_description": "Experience the charming Dutch countryside on an electric bike tour with a guide or on your own. Explore traditional farms and picturesque villages, and discover how local cheese is made from scratch.", "starting_price_per_person": 48 } ] } ``` ## 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":"getyourguide.com/search_activities","input":{"city":"Amsterdam","max_results":25}}' ``` 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 the top-rated food tours in Lisbon available on 2026-05-14, prices in EUR - What are the cheapest things to do in Rome on June 3rd, 2026? Show me about 10 options with free cancellation info - On GetYourGuide, look up skip-the-line Sagrada Familia tickets in Barcelona sorted by rating - Show me the most popular tours and activities in Kyoto, up to 30 results, priced in JPY - Search GetYourGuide for sunset boat cruises in Dubrovnik on 2026-08-22, lowest price first, in GBP ## Input schema ```json { "type": "object", "required": [ "city" ], "properties": { "city": { "type": "string", "minLength": 1, "description": "City to explore, such as Amsterdam." }, "date": { "type": "string", "description": "Only activities available on this day (YYYY-MM-DD), such as 2026-10-10." }, "sort": { "enum": [ "popularity", "price_low_to_high", "rating" ], "type": "string", "default": "popularity", "description": "Order by popularity, lowest price or rating, such as rating." }, "query": { "type": "string", "default": "", "description": "Activity to look for, such as canal cruise; blank for any." }, "currency": { "type": "string", "default": "USD", "description": "Three-letter price currency, such as EUR." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of activities, such as 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "activities" ], "properties": { "activities": { "type": "array", "items": { "type": "object", "required": [ "title", "rating", "number_of_reviews", "starting_price_per_person", "currency", "duration", "free_cancellation", "skip_the_line", "short_description", "link", "activity_id" ], "properties": { "link": { "type": "string" }, "title": { "type": "string" }, "rating": { "type": [ "number", "null" ], "description": "Rating out of 5." }, "currency": { "type": "string" }, "duration": { "type": [ "string", "null" ] }, "activity_id": { "type": "string" }, "skip_the_line": { "type": "boolean" }, "free_cancellation": { "type": "boolean" }, "number_of_reviews": { "type": [ "integer", "null" ] }, "short_description": { "type": [ "string", "null" ] }, "starting_price_per_person": { "type": [ "number", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [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. - [Viator API: Search tours](https://fous.com/methods/viator.com/search-tours.md): Finds tours and experiences in a city on Viator, with optional keywords, date, currency and sorting. Prices are starting prices. - [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. - [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. - [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. - [Airbnb API: Search stays](https://fous.com/methods/airbnb.com/search-stays.md): Searches public Airbnb homes for a destination and travel dates. Each stay comes with its price, rating, room details and listing link. Prices are the displayed trip totals, including fees. - [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.