# TripAdvisor Reviews Scraper (`web_wanderer/tripadvisor-reviews-scraper`) Actor Extract TripAdvisor reviews from hotels, restaurants, attractions, and tours/activities in one run. Sort, filter by rating, trip type, month, language, or keyword, with owner replies, photos, and place metadata included. - **URL**: https://apify.com/web\_wanderer/tripadvisor-reviews-scraper.md - **Developed by:** [Billy](https://apify.com/web_wanderer) (community) - **Categories:** Travel, Lead generation, AI - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 reviews This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Reviews Scraper Get TripAdvisor reviews from hotels, restaurants, attractions, and attraction tours/activities. One actor, one consistent JSON shape, every filter you would expect from the website. ### Why use it - Works on every TripAdvisor review page: hotels, restaurants, attractions, and attraction tours/activities (tickets, day trips, classes, transfers). - Mix any of those URL types in a single run, or just paste numeric TripAdvisor location IDs and let the actor figure it out. - Every result lands in the dataset with the same flat field set so you can plug it straight into a spreadsheet, a database, or a downstream pipeline. - Filters (sort, keyword, ratings, trip type, month, language) apply to every URL type, no per-page configuration needed. - Owner responses, review photos, place metadata, and helpful-vote counts are included out of the box. - Reviewer personal data is null by default and only included when you explicitly opt in. ### Features - Reviews from Hotel, Restaurant, Attraction, and Attraction Product (tours and activities) pages. - Accepts both full TripAdvisor URLs and bare numeric location IDs (e.g. `671150`). - Sort by most recent, most detailed, most insightful, or the TripAdvisor default. - Filter by star rating, trip type, month of visit, language, and free-text keyword. - Choose between machine-translated reviews (default) or original-language text. - Captures owner/management responses with date and role. - Captures review photos and place-level information (name, total review count, and for tours: rating, description, and image). - Per-URL cap with `maxReviewsPerLocation` and a clean warning when a place returns no matching reviews. ### Input | Field | Type | Default | Description | |---|---|---|---| | `startUrls` | array of strings | required | TripAdvisor review URLs **or** bare numeric TripAdvisor location IDs (the digits after `-d` in the URL, e.g. `671150`). Mixed types in a single run are fine. | | `maxReviewsPerLocation` | integer | `50` | Cap reviews per URL. `0` = unlimited. | | `sortBy` | string | `"default"` | Sort order. `default` (TripAdvisor default), `most_recent`, `detailed`, or `insightful` (only effective on attraction tours/activities). | | `searchKeyword` | string | `""` | Free-text keyword to search inside review content. Applies to every URL type. | | `ratings` | array of `"1"`..`"5"` | `[]` | Only return reviews with these star ratings. Empty = all. | | `tripTypes` | array | `[]` | Filter by traveler segment. One or more of `Families`, `Couples`, `Solo`, `Business`, `Friends`. Empty = all. | | `months` | array of `"1"`..`"12"` | `[]` | Filter by month of visit. Empty = all. | | `reviewLanguage` | string | `"all"` | ISO language code for the reviews to fetch (e.g. `en`, `fr`, `es`, `de`, `it`, `zhCN`). Use `all` to collect every language. | | `showOriginalReviews` | boolean | `false` | When `true`, returns reviews in their original language instead of TripAdvisor's machine-translated version. Not supported on attraction tours/activities pages. | | `include_personal_information` | boolean | `false` | When `true`, populates `author`, `author_username`, `author_hometown`, `author_contributions`, `author_profile_url`, `author_avatar_url`. When `false`, those fields are present but set to `null`. | Example input mixing all four page types and a bare location ID: ```json { "startUrls": [ "https://www.tripadvisor.com/Hotel_Review-g60763-d671150-Reviews-The_Empire_Hotel-New_York_City_New_York.html", "https://www.tripadvisor.com/Restaurant_Review-g187147-d15343325-Reviews-99_Haussmann-Paris_Ile_de_France.html", "https://www.tripadvisor.com/Attraction_Review-g187147-d188757-Reviews-Louvre_Museum-Paris_Ile_de_France.html", "https://www.tripadvisor.com/AttractionProductReview-g293916-d12565966-Bangkok_Chao_Phraya_River_Cruise_Including_Buffet_Dinner-Bangkok.html", "671150" ], "maxReviewsPerLocation": 30, "sortBy": "default", "searchKeyword": "", "ratings": ["4", "5"], "tripTypes": ["Couples", "Friends"], "months": ["6", "7", "8"], "reviewLanguage": "all", "showOriginalReviews": false, "include_personal_information": false } ```` ### Output Each dataset item has this shape (real Empire Hotel run, default privacy settings): ```json { "place_name": "The Empire Hotel", "place_overall_rating": null, "place_total_reviews": 9561, "place_description": null, "place_image_url": null, "location_kind": "hotel", "geo_id": 60763, "detail_id": 671150, "source_url": "https://www.tripadvisor.com/Hotel_Review-g60763-d671150-Reviews-The_Empire_Hotel-New_York_City_New_York.html", "review_id": "1052932188", "review_url": "https://www.tripadvisor.com/ShowUserReviews-...html", "title": "Great location, friendly staff", "text": "Stayed for four nights with my partner ...", "rating": 5, "published_date": "2026-04-12", "published_date_text": "2026-04-12", "language": "en", "original_language": "en", "trip_type": null, "helpful_votes": 0, "photos": ["https://dynamic-media-cdn.tripadvisor.com/media/photo-o/.../caption.jpg?w=1024&h=-1&s=1"], "author": null, "author_username": null, "author_hometown": null, "author_contributions": null, "author_profile_url": null, "author_avatar_url": null, "mgmt_response_text": "Thank you for staying with us ...", "mgmt_response_date": "2026-04-15", "mgmt_response_role": "Front Office Manager", "scraped_at": "2026-04-24T09:07:46Z" } ``` `location_kind` is one of `hotel`, `restaurant`, or `attraction` (attraction tours and activities are also reported as `attraction`). The `place_*` fields describe the location/product itself. For attraction tours and activities, `place_overall_rating`, `place_description`, and `place_image_url` are populated. For hotels, restaurants, and attractions only `place_name` and `place_total_reviews` are typically available. With `include_personal_information: true` the same item carries the populated author fields: ```json { "author": "GG718", "author_username": "Adventure290052", "author_hometown": "Stafford, VA", "author_contributions": 86, "author_profile_url": "https://www.tripadvisor.com/Profile/Adventure290052", "author_avatar_url": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/.../default-avatar.jpg?w=300&h=-1&s=1" } ``` ### Use cases - Hotel and restaurant reputation tracking across markets. - Sentiment and theme analysis on cleaned, language-filtered review text. - Tour-operator and attraction-product benchmarking, including how owners reply to feedback. - Building a private review search index, dashboard, or alerting tool. - Feeding LLMs with curated, filtered review datasets for summarization or QA. ### Legal notice This actor is designed to extract publicly available data from TripAdvisor. While scraping public information is generally legal in many jurisdictions, you are solely responsible for complying with local laws and TripAdvisor's terms of service. Do not use this actor to collect sensitive data or for any unethical purposes such as spamming or harassment. By using this actor, you agree to do so lawfully and at your own risk. Neither the developer nor Apify assumes liability for how the data is used. Reviewer name, username, hometown, contribution count, profile URL, and avatar are personal data. By default, `include_personal_information` is `false` and those six fields are set to `null` so the output schema stays predictable while no personal values leave the actor. Setting `include_personal_information` to `true` populates those fields with the values returned by TripAdvisor; only enable it when you have a documented lawful basis under GDPR, CCPA, or any other regulation that applies to you. ### Tips - For the largest result sets, set `maxReviewsPerLocation` to `0` (unlimited) and let the actor paginate to the end. - If you only care about recent feedback, combine `sortBy: "most_recent"` with `months` and `ratings` filters so TripAdvisor does the work for you. - Bare numeric IDs are perfect for spreadsheets and bulk inputs. The actor accepts them mixed with full URLs. - A warning is logged when a URL returns zero reviews. That covers wrong or expired IDs as well as filters that exclude every review. - `showOriginalReviews` is ignored for attraction tours/activities pages. ### Support Found a missing field, a TripAdvisor page that does not parse correctly, or a filter that does not behave as you expect? Open an issue on the actor page with the exact input you used and a short note about what you expected. Bug reports with a reproducible input are the fastest way to a fix. # Actor input Schema ## `showOriginalReviews` (type: `boolean`): By default, reviews written in other languages are machine-translated into English. Enable this to receive each review in its original language instead. Not supported on attraction tours/activities pages. ## `include_personal_information` (type: `boolean`): When enabled, author name, username, hometown, profile URL and contribution count are included in the output. By default these fields are set to null to comply with GDPR and similar data protection regulations. Only enable this if you have a lawful basis for processing personal data. ## `startUrls` (type: `array`): TripAdvisor review page URLs (hotels, restaurants, attractions or attraction tours/activities), or bare numeric TripAdvisor location IDs (the digits after `-d` in the URL, e.g. `671150`). ## `maxReviewsPerLocation` (type: `integer`): Maximum number of reviews to collect per URL. Set to 0 for unlimited. ## `sortBy` (type: `string`): Order in which reviews are returned. `default` lets TripAdvisor decide; `most_recent` returns the newest reviews first; `detailed` prioritises the most informative reviews; `insightful` returns the most insightful reviews (only effective on attraction tours/activities pages). ## `searchKeyword` (type: `string`): Free-text keyword to search inside review content. Filtering is performed server-side by TripAdvisor. ## `ratings` (type: `array`): Only return reviews with these star ratings. Leave empty to include all ratings. ## `tripTypes` (type: `array`): Only return reviews from these traveler segments. Leave empty for all. ## `months` (type: `array`): Only return reviews where the visit happened in these months. Leave empty for all. ## `reviewLanguage` (type: `string`): ISO language code of the reviews to collect (e.g. en, fr, es, de, it, zhCN). Use `all` to collect reviews in every language. By default, non-English reviews are machine-translated into English. ## Actor input object example ```json { "showOriginalReviews": false, "include_personal_information": false, "startUrls": [ "https://www.tripadvisor.com/Hotel_Review-g60763-d671150-Reviews-The_Empire_Hotel-New_York_City_New_York.html", "671150" ], "maxReviewsPerLocation": 50, "sortBy": "default", "searchKeyword": "", "ratings": [], "tripTypes": [], "months": [], "reviewLanguage": "all" } ``` # Actor output Schema ## `dataset` (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/Hotel_Review-g60763-d671150-Reviews-The_Empire_Hotel-New_York_City_New_York.html", "671150" ] }; // Run the Actor and wait for it to finish const run = await client.actor("web_wanderer/tripadvisor-reviews-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/Hotel_Review-g60763-d671150-Reviews-The_Empire_Hotel-New_York_City_New_York.html", "671150", ] } # Run the Actor and wait for it to finish run = client.actor("web_wanderer/tripadvisor-reviews-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/Hotel_Review-g60763-d671150-Reviews-The_Empire_Hotel-New_York_City_New_York.html", "671150" ] }' | apify call web_wanderer/tripadvisor-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=web_wanderer/tripadvisor-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TripAdvisor Reviews Scraper", "description": "Extract TripAdvisor reviews from hotels, restaurants, attractions, and tours/activities in one run. Sort, filter by rating, trip type, month, language, or keyword, with owner replies, photos, and place metadata included.", "version": "0.1", "x-build-id": "pbDk4ds2oelEhu2pJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/web_wanderer~tripadvisor-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-web_wanderer-tripadvisor-reviews-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/web_wanderer~tripadvisor-reviews-scraper/runs": { "post": { "operationId": "runs-sync-web_wanderer-tripadvisor-reviews-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/web_wanderer~tripadvisor-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-web_wanderer-tripadvisor-reviews-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", "required": [ "startUrls" ], "properties": { "showOriginalReviews": { "title": "Show original (untranslated) reviews", "type": "boolean", "description": "By default, reviews written in other languages are machine-translated into English. Enable this to receive each review in its original language instead. Not supported on attraction tours/activities pages.", "default": false }, "include_personal_information": { "title": "Include personal information", "type": "boolean", "description": "When enabled, author name, username, hometown, profile URL and contribution count are included in the output. By default these fields are set to null to comply with GDPR and similar data protection regulations. Only enable this if you have a lawful basis for processing personal data.", "default": false }, "startUrls": { "title": "Start URLs or location IDs", "type": "array", "description": "TripAdvisor review page URLs (hotels, restaurants, attractions or attraction tours/activities), or bare numeric TripAdvisor location IDs (the digits after `-d` in the URL, e.g. `671150`).", "items": { "type": "string" } }, "maxReviewsPerLocation": { "title": "Reviews per Location", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to collect per URL. Set to 0 for unlimited.", "default": 50 }, "sortBy": { "title": "Sort reviews by", "enum": [ "default", "most_recent", "detailed", "insightful" ], "type": "string", "description": "Order in which reviews are returned. `default` lets TripAdvisor decide; `most_recent` returns the newest reviews first; `detailed` prioritises the most informative reviews; `insightful` returns the most insightful reviews (only effective on attraction tours/activities pages).", "default": "default" }, "searchKeyword": { "title": "Search keyword in reviews", "type": "string", "description": "Free-text keyword to search inside review content. Filtering is performed server-side by TripAdvisor.", "default": "" }, "ratings": { "title": "Filter by rating", "uniqueItems": true, "type": "array", "description": "Only return reviews with these star ratings. Leave empty to include all ratings.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star (Terrible)", "2 stars (Poor)", "3 stars (Average)", "4 stars (Very good)", "5 stars (Excellent)" ] }, "default": [] }, "tripTypes": { "title": "Filter by trip type", "uniqueItems": true, "type": "array", "description": "Only return reviews from these traveler segments. Leave empty for all.", "items": { "type": "string", "enum": [ "Families", "Couples", "Solo", "Business", "Friends" ] }, "default": [] }, "months": { "title": "Filter by month of visit", "uniqueItems": true, "type": "array", "description": "Only return reviews where the visit happened in these months. Leave empty for all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12" ], "enumTitles": [ "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" ] }, "default": [] }, "reviewLanguage": { "title": "Review language", "type": "string", "description": "ISO language code of the reviews to collect (e.g. en, fr, es, de, it, zhCN). Use `all` to collect reviews in every language. By default, non-English reviews are machine-translated into English.", "default": "all" } } }, "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 } } } } } } } } } } ```