# TripAdvisor Scraper - Places & Ratings (`automatyk/tripadvisor-scraper`) Actor Scrape TripAdvisor hotels, restaurants and attractions: name, rating, reviews count, address and details. Export to JSON, CSV, Excel. - **URL**: https://apify.com/automatyk/tripadvisor-scraper.md - **Developed by:** [Automatyk](https://apify.com/automatyk) (community) - **Categories:** Travel, Lead generation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## TripAdvisor Scraper - Hotels, Restaurants, Attractions & Reviews Extract structured data from any TripAdvisor place page: hotels, restaurants, attractions, ratings, reviews, address, coordinates, phone number, and more. Export to JSON, CSV, or Excel in seconds. **No browser. No proxy needed. No getting blocked.** This scraper calls TripAdvisor internal REST API directly, bypassing anti-bot protection entirely. --- ### What you can scrape #### Place data - Name, category and subcategory - Overall rating and total review count - Full address, city, country, postal code - GPS coordinates (latitude, longitude) - Phone number and official website - Ranking within its category and city - Description, tags, photo count - TripAdvisor page URL #### Review data (optional) - Review title and full text - Star rating (1 to 5) - Travel date and trip type - Publication date - Author name, location and review count - Helpful votes - Direct URL to the review --- ### Use cases - **Travel market research**: benchmark hotels and restaurants in any city - **Reputation monitoring**: track ratings and reviews for your locations over time - **Competitor analysis**: compare ratings, review volume and sentiment across venues - **Lead generation**: build targeted lists of hospitality businesses with contact data - **Academic research**: collect large review datasets for NLP and sentiment analysis - **Travel app development**: enrich your database with real-time TripAdvisor data - **Review aggregation**: combine TripAdvisor data with Google and Booking.com --- ### Input Paste one or more TripAdvisor URLs (hotel, restaurant, or attraction pages): ```json { "startUrls": [ "https://www.tripadvisor.com/Attraction_Review-g187147-d188151-Reviews-Eiffel_Tower-Paris_Ile_de_France.html", "https://www.tripadvisor.com/Hotel_Review-g60763-d93589-Reviews-The_Plaza-New_York_City_New_York.html", "https://www.tripadvisor.com/Restaurant_Review-g187147-d718840-Reviews-Le_Jules_Verne-Paris_Ile_de_France.html" ], "includeReviews": true, "maxReviews": 100 } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `startUrls` | array | Eiffel Tower example | TripAdvisor place URLs to scrape | | `includeReviews` | boolean | true | Also extract reviews for each place | | `maxReviews` | integer | 50 | Max reviews per place (0 = all available) | *** ### Output example #### Place item ```json { "type": "place", "locationId": "188151", "name": "Eiffel Tower", "category": "Attraction", "subtype": "Observation Decks & Towers, Points of Interest & Landmarks", "rating": 4.6, "numReviews": 143919, "ranking": "#1 of 3,996 things to do in Paris", "description": "Completed in 1889, this colossal landmark...", "address": "Av. Gustave Eiffel, 75007 Paris France", "city": "Paris", "country": "France", "postalCode": "75007", "latitude": 48.858353, "longitude": 2.294464, "phone": "+33 892 70 12 39", "website": "https://www.toureiffel.paris/", "photoCount": 83342, "webUrl": "https://www.tripadvisor.com/Attraction_Review-g187147-d188151-..." } ``` #### Review item ```json { "type": "review", "locationId": "188151", "reviewId": "1062422731", "lang": "en", "publishedDate": "2026-05-31T06:57:20-04:00", "travelDate": "2026-05", "rating": 5, "title": "Best in Paris", "text": "Anytime of the day or the night, the eiffel tower never disappoints you!", "tripType": null, "helpfulVotes": 0, "authorName": "Travel T", "authorLocation": "New York, USA", "authorReviewCount": 7 } ``` *** ### Supported URL types This scraper supports any TripAdvisor place URL: - Hotels: `tripadvisor.com/Hotel_Review-g...-d...-...` - Restaurants: `tripadvisor.com/Restaurant_Review-g...-d...-...` - Attractions: `tripadvisor.com/Attraction_Review-g...-d...-...` Tip: copy the URL directly from your browser on any TripAdvisor place page. *** ### Performance and cost - **Speed**: 1 place + 50 reviews in under 5 seconds - **No proxy required**: direct REST API access, no browser, no anti-bot - **Pricing**: Pay-Per-Event (actor-start + result-item per scraped item) - **Scale**: handles hundreds of URLs per run without rate limiting *** ### FAQ **Does it work without getting blocked?** Yes. This scraper uses TripAdvisor internal REST API instead of scraping HTML pages. DataDome anti-bot protection only applies to browser-rendered pages, not to this API. **Can I scrape all reviews from a place?** Yes. Set `maxReviews` to `0` to fetch all available reviews. The Eiffel Tower has over 143,000 reviews - the scraper handles full pagination automatically. **What languages are supported?** English reviews are returned by default. The API returns the language field for each review so you can filter by `lang` in your dataset. **Can I scrape multiple places at once?** Yes. Add as many URLs as you need in `startUrls`. The scraper processes them sequentially. **Is this legal?** Web scraping publicly available data is generally permitted for research, analysis, and personal use. Always review TripAdvisor terms of service for your specific use case. **How do I get the locationId from a URL?** You do not need to. Just paste the full TripAdvisor URL and the scraper extracts the location ID automatically from the `-d{number}-` pattern in the URL. *** ### Export formats Results are available in: **JSON, CSV, Excel (XLSX), XML, RSS**. Download directly from the Apify console or via the API. *** Built by [Automatyk](https://apify.com/automatyk) - scraping tools for professionals. # Actor input Schema ## `startUrls` (type: `array`): TripAdvisor place URLs (hotel, restaurant or attraction pages). ## `includeReviews` (type: `boolean`): Also scrape reviews for each place. ## `maxReviews` (type: `integer`): Maximum reviews to fetch per place. 0 = all available reviews. ## Actor input object example ```json { "startUrls": [ "https://www.tripadvisor.com/Attraction_Review-g187147-d188151-Reviews-Eiffel_Tower-Paris_Ile_de_France.html" ], "includeReviews": true, "maxReviews": 50 } ``` # Actor output Schema ## `places` (type: `string`): No description ## `reviews` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://www.tripadvisor.com/Attraction_Review-g187147-d188151-Reviews-Eiffel_Tower-Paris_Ile_de_France.html" ] }; // Run the Actor and wait for it to finish const run = await client.actor("automatyk/tripadvisor-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["https://www.tripadvisor.com/Attraction_Review-g187147-d188151-Reviews-Eiffel_Tower-Paris_Ile_de_France.html"] } # Run the Actor and wait for it to finish run = client.actor("automatyk/tripadvisor-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://www.tripadvisor.com/Attraction_Review-g187147-d188151-Reviews-Eiffel_Tower-Paris_Ile_de_France.html" ] }' | apify call automatyk/tripadvisor-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automatyk/tripadvisor-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TripAdvisor Scraper - Places & Ratings", "description": "Scrape TripAdvisor hotels, restaurants and attractions: name, rating, reviews count, address and details. Export to JSON, CSV, Excel.", "version": "0.1", "x-build-id": "JD9i7kmHkzRrxc9MG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automatyk~tripadvisor-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automatyk-tripadvisor-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/automatyk~tripadvisor-scraper/runs": { "post": { "operationId": "runs-sync-automatyk-tripadvisor-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/automatyk~tripadvisor-scraper/run-sync": { "post": { "operationId": "run-sync-automatyk-tripadvisor-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "TripAdvisor URLs", "type": "array", "description": "TripAdvisor place URLs (hotel, restaurant or attraction pages).", "default": [ "https://www.tripadvisor.com/Attraction_Review-g187147-d188151-Reviews-Eiffel_Tower-Paris_Ile_de_France.html" ], "items": { "type": "string" } }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Also scrape reviews for each place.", "default": true }, "maxReviews": { "title": "Max reviews per place", "minimum": 0, "type": "integer", "description": "Maximum reviews to fetch per place. 0 = all available reviews.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```