# Tripadvisor API: List top attractions in a city > 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. Unofficial. Not affiliated with or endorsed by Tripadvisor. - Page: https://fous.com/methods/tripadvisor.com/list-top-attractions - Method: `tripadvisor.com/list_top_attractions`, version 1 - Website: tripadvisor.com - Returns: rank, name, category, rating, review count, description, neighbourhood or address, Tripadvisor link and location 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 | `"Paris, France"` | City to look up, with country if needed; for example, Rome or Paris, France. | | `category` | string | no | `"museums"` | Kind of things to do; for example, museums. One of "any", "tours", "museums", "sights_and_landmarks", "nature_and_parks". Default "any". | | `max_results` | integer | no | | Maximum attractions to return from the first results page; for example, 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "city": "Paris, France", "category": "museums" } ``` Its output: ```json { "attractions": [ { "name": "Louvre Museum", "rank": 1, "rating": 4.6, "category": "Points of Interest & Landmarks • Architectural Buildings", "description": null, "review_count": 104619, "tripadvisor_link": "https://www.tripadvisor.com/Attraction_Review-g187147-d188757-Reviews-Louvre_Museum-Paris_Ile_de_France.html", "tripadvisor_location_id": "188757", "neighbourhood_or_address": "Louvre / Palais-Royal" }, { "name": "Musée d'Orsay", "rank": 2, "rating": 4.7, "category": "Art Museums", "description": null, "review_count": 67978, "tripadvisor_link": "https://www.tripadvisor.com/Attraction_Review-g187147-d188150-Reviews-Musee_d_Orsay-Paris_Ile_de_France.html", "tripadvisor_location_id": "188150", "neighbourhood_or_address": "Tour Eiffel / Invalides" }, { "name": "Musée de l’Orangerie", "rank": 3, "rating": 4.6, "category": "Speciality Museums", "description": null, "review_count": 17737, "tripadvisor_link": "https://www.tripadvisor.com/Attraction_Review-g187147-d265635-Reviews-Musee_de_l_Orangerie-Paris_Ile_de_France.html", "tripadvisor_location_id": "265635", "neighbourhood_or_address": "Louvre / Palais-Royal" } ] } ``` ## 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":"tripadvisor.com/list_top_attractions","input":{"city":"Paris, France","category":"museums"}}' ``` 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 - What are the top 10 things to do in Lisbon, Portugal according to Tripadvisor? I need ratings and review counts. - Give me the highest-ranked museums in Vienna with their ratings and how many reviews each has. - I'm planning a trip to Kyoto — list the best-rated nature and parks spots there, up to 15. - Find the top tours in Cartagena, Colombia on tripadvisor.com, including descriptions and links. - Which sights and landmarks rank highest in Edinburgh? Show me around 25 with neighbourhood info. ## Input schema ```json { "type": "object", "required": [ "city" ], "properties": { "city": { "type": "string", "description": "City to look up, with country if needed; for example, Rome or Paris, France." }, "category": { "enum": [ "any", "tours", "museums", "sights_and_landmarks", "nature_and_parks" ], "type": "string", "default": "any", "description": "Kind of things to do; for example, museums." }, "max_results": { "type": "integer", "default": 20, "maximum": 30, "minimum": 1, "description": "Maximum attractions to return from the first results page; for example, 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "attractions" ], "properties": { "attractions": { "type": "array", "items": { "type": "object", "required": [ "rank", "name", "category", "rating", "review_count", "description", "neighbourhood_or_address", "tripadvisor_link", "tripadvisor_location_id" ], "properties": { "name": { "type": "string" }, "rank": { "type": "integer" }, "rating": { "type": [ "number", "null" ] }, "category": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "review_count": { "type": [ "integer", "null" ] }, "tripadvisor_link": { "type": "string" }, "tripadvisor_location_id": { "type": [ "string", "null" ] }, "neighbourhood_or_address": { "type": [ "string", "null" ] } } } } } } ``` ## See more - [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. - [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. - [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. - [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. - [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. - [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. - [Google API: Get hotel reviews from Google Hotels](https://fous.com/methods/google.com/get-hotel-reviews.md): Finds a hotel on Google Hotels by name and city and returns its guest reviews in the chosen order, its Google rating and review count, and topic ratings averaged from the returned reviews that rate each topic. - [All Tripadvisor methods](https://fous.com/methods/tripadvisor.com.md)