# TripAdvisor Reviews Scraper — Hotels, Restaurants & Attractions (`gopalakrishnan/tripadvisor-reviews-scraper`) Actor Scrapes TripAdvisor reviews with star ratings, sub-ratings (cleanliness, service, value), trip type, reviewer info, and owner responses. Supports hotels, restaurants, and attractions with language filtering. - **URL**: https://apify.com/gopalakrishnan/tripadvisor-reviews-scraper.md - **Developed by:** [Gopalakrishnan](https://apify.com/gopalakrishnan) (community) - **Categories:** Travel, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 review scrapeds 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 **Extract TripAdvisor reviews and ratings for any hotel, restaurant, or attraction** at [tripadvisor.com](https://www.tripadvisor.com) — a fast, **TripAdvisor API alternative** that needs no browser or login. Give it one or more TripAdvisor location URLs and it returns structured JSON for each review: rating, title, text, stay/visit date, trip type, sub-ratings (value, service, cleanliness, etc.), reviewer profile, and the business owner's response, if any. ### Why use TripAdvisor Reviews Scraper? TripAdvisor reviews are a goldmine for hospitality and travel businesses, but the site has no public API for bulk review export. This Actor talks directly to TripAdvisor's own review-list endpoint, so it's fast and reliable — no browser rendering, no CAPTCHAs to solve. That makes it useful for: - **Reputation monitoring** — track new reviews and ratings for your hotel, restaurant, or attraction over time. - **Competitive intelligence** — benchmark your ratings and review sentiment against competitors. - **Market research** — collect review text at scale for sentiment analysis or NLP pipelines. - **Guest experience analysis** — mine sub-ratings (cleanliness, service, value, location) to spot trends. Running it on Apify also gives you: - **Scheduling** — run daily/weekly to build a historical review dataset. - **API & integrations** — trigger runs and pull results via the Apify API, or connect to Zapier, Make, Google Sheets, and more. - **Proxy rotation & monitoring** — built-in proxy support and run alerts, no extra setup. ### What data does TripAdvisor Reviews Scraper extract? | Field | Type | Description | | ----------------------- | ------- | -------------------------------------------------------------------------------------- | | `rating` | integer | Overall star rating (1-5) given by the reviewer. | | `title` | string | Review headline. | | `text` | string | Full review text. | | `stayDate` / `tripType` | string | When the reviewer visited and the type of trip (e.g. `FAMILY`, `COUPLES`, `BUSINESS`). | | `subRatings` | array | Category breakdown, e.g. Value, Rooms, Location, Cleanliness, Service. | | `reviewer` | object | Display name, username, hometown, total contributions, profile URL. | | `ownerResponse` | object | The business's reply to the review, if one was posted. | | `publishedDate` | string | Date the review was published on TripAdvisor. | | `reviewUrl` | string | Direct link to the review on TripAdvisor. | See [Output](#output) below for a full example, or the **Data** / **Schema** tabs in Apify Console for every field. ### How to scrape TripAdvisor reviews 1. Click **Try for free** (or **Run**) to open the Actor. 2. Find the location you want to scrape on TripAdvisor and copy its URL — see [How to find a TripAdvisor location URL](#how-to-find-a-tripadvisor-location-url) below. 3. Paste the URL(s) into **TripAdvisor location URLs**. 4. Set **Max reviews per location** (default `100`) and **Review language** (default `en`). 5. Click **Start** and view results in the **Dataset** tab once the run finishes. 6. Export the dataset as JSON, CSV, Excel, or HTML, or pull it via the API. #### How to find a TripAdvisor location URL Every TripAdvisor hotel, restaurant, and attraction page has a URL containing a `-d-` segment, which is the location's unique ID — for example: ```` https://www.tripadvisor.com/Hotel\_Review-g45963-d91967-Reviews-Treasure\_Island\_TI\_Las\_Vegas-Las\_Vegas\_Nevada.html └────┬────┘ location id (91967) ```` 1. Search for the business on [tripadvisor.com](https://www.tripadvisor.com). 2. Open its detail/reviews page (`Hotel_Review-…`, `Restaurant_Review-…`, or `Attraction_Review-…`). 3. Copy the full URL from your browser's address bar — that's it. You don't need to extract the ID yourself; the Actor parses it from the URL automatically. ### How much will it cost to scrape TripAdvisor reviews? This Actor uses Apify's **Pay Per Event (PPE)** pricing — you only pay for what you get, not for compute time: - **$0.002** flat fee per Actor run (charged once, on start) - **$0.0008** per review successfully scraped For example, scraping 500 reviews across a few locations costs roughly `$0.002 + (500 × $0.0008) ≈ $0.402`. Check the **Pricing** tab in Apify Console for the current live rates, which may be adjusted over time. ### Input | Field | Type | Description | | -------------------- | ---------------------------- | --------------------------------------------------------------------------------------------------- | | `startUrls` | array (required) | TripAdvisor location URLs to scrape (hotel, restaurant, or attraction detail pages). | | `maxReviews` | integer (default `100`) | Maximum number of reviews to fetch per location. Reviews are returned newest-first, in pages of 10. | | `language` | string (default `en`) | Two-letter language code to filter reviews by (e.g. `en`, `es`, `fr`, `de`, `it`). | | `proxyConfiguration` | object (default Apify Proxy) | Proxy settings. Datacenter proxy is sufficient — no residential proxy needed. | See the **Input** tab in Apify Console for the full schema and defaults. ```json { "startUrls": [ { "url": "https://www.tripadvisor.com/Hotel_Review-g45963-d91967-Reviews-Treasure_Island_TI_Las_Vegas-Las_Vegas_Nevada.html" } ], "maxReviews": 100, "language": "en", "proxyConfiguration": { "useApifyProxy": true } } ```` ### Output Each scraped review is one row in the dataset, for example: ```json { "reviewId": 1065375918, "locationId": 91967, "placeName": "Treasure Island TI Las Vegas", "placeType": "ACCOMMODATION", "rating": 5, "title": "One night in Vegas", "text": "Loved being in the middle of the strip. Room was clean. Beds were nice. The only thing was our great view was through a dirty window. But still great! We will be back at the end of the week", "language": "en", "originalLanguage": "en", "createdDate": "2026-06-22", "publishedDate": "2026-06-22", "stayDate": "2026-06-30", "tripType": "FAMILY", "helpfulVotes": 0, "subRatings": [ { "label": "Value", "rating": 4 }, { "label": "Rooms", "rating": 4 }, { "label": "Location", "rating": 5 }, { "label": "Cleanliness", "rating": 5 }, { "label": "Service", "rating": 4 }, { "label": "Sleep Quality", "rating": 5 } ], "reviewUrl": "https://www.tripadvisor.com/ShowUserReviews-g45963-d91967-r1065375918-Treasure_Island_TI_Las_Vegas-Las_Vegas_Nevada.html", "reviewer": { "displayName": "G Clark", "username": "520lenaf", "isVerified": false, "hometown": "Asheville, North Carolina", "totalContributions": 3, "profileUrl": "https://www.tripadvisor.com/Profile/520lenaf" }, "ownerResponse": { "text": "Thank you for your wonderful review. We are delighted to hear that you enjoyed our central location on the Strip...", "publishedDate": "2026-06-23", "responderName": "Anca B", "responderTitle": "Guest Services / Front Office" }, "sourceUrl": "https://www.tripadvisor.com/Hotel_Review-g45963-d91967-Reviews-Treasure_Island_TI_Las_Vegas-Las_Vegas_Nevada.html", "scrapedAt": "2026-06-24T10:16:01.959Z" } ``` You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. #### Data table | Field | Description | | ------------------------------- | -------------------------------------------------------------------------------------------------- | | `reviewId` | TripAdvisor's unique review ID. | | `locationId` | TripAdvisor's unique location ID (from the `-d-` URL segment). | | `placeName` / `placeType` | Name and type (`ACCOMMODATION`, `RESTAURANT`, `ATTRACTION`) of the scraped location. | | `rating` | Overall star rating (1-5). | | `title` / `text` | Review headline and body. | | `language` / `originalLanguage` | Review language code and the language it was originally written in. | | `createdDate` / `publishedDate` | When the review was created and published. | | `stayDate` / `tripType` | When the reviewer visited and the trip category. | | `helpfulVotes` | Number of "helpful" votes the review received. | | `subRatings` | Array of `{ label, rating }` category breakdowns. | | `reviewUrl` | Direct link to the review on TripAdvisor. | | `reviewer` | Reviewer's display name, username, verification status, hometown, contribution count, profile URL. | | `ownerResponse` | The business's reply (text, date, responder name/title), or `null` if none. | | `sourceUrl` | The location URL that was scraped. | | `scrapedAt` | ISO timestamp of when the review was scraped. | ### Tips and advanced options - Use `maxReviews` to cap a run while testing before scaling up to full review history. - Set `language` to pull reviews in a specific language only; TripAdvisor's machine translation flag is enabled, but `originalLanguage` always reflects what the reviewer actually wrote in. - One location failing (e.g. an invalid or removed URL) does not stop the rest of the run — the Actor logs a warning and moves on to the next `startUrls` entry. - Schedule the Actor (Apify Console → Schedules) to track new reviews and rating trends over time. ### FAQ **Does this need a browser or login?** No. The Actor uses plain HTTP requests to TripAdvisor's review API — no Puppeteer/Playwright, no TripAdvisor account required. **Can I scrape reviews in multiple languages in one run?** Run the Actor once per language by setting `language` accordingly, or run it with the default and inspect `originalLanguage` on each review. **Some reviews don't have an `ownerResponse` — is that a bug?** No. Not every business replies to every review; `ownerResponse` is `null` when no reply exists. **Found a bug or have a feature request?** Open an issue in the Actor's **Issues** tab in Apify Console. ### Disclaimer This Actor only extracts data that is already publicly visible on TripAdvisor review pages — it does not access private accounts, bypass logins, or scrape any content a user hasn't chosen to share publicly. Our Actors are built to be used ethically and do not extract private user data such as email addresses. However, public reviews can still contain personal data (e.g. reviewer names, hometowns), which may be subject to GDPR or other privacy regulations depending on your jurisdiction and use case. You are responsible for using this Actor in compliance with TripAdvisor's Terms of Service and all applicable laws. If you're unsure whether your intended use is compliant, consult your legal counsel. # Actor input Schema ## `startUrls` (type: `array`): TripAdvisor detail-page URLs for hotels, restaurants, or attractions (e.g. https://www.tripadvisor.com/Hotel\_Review-g45963-d91967-Reviews-Treasure\_Island\_TI\_Las\_Vegas-Las\_Vegas\_Nevada.html). The location id is read from the -d- segment of the URL. ## `maxReviews` (type: `integer`): Maximum number of reviews to scrape for each location. Reviews are fetched newest-first in pages of 10. ## `language` (type: `string`): Two-letter language code to filter reviews by (e.g. en, es, fr, de, it). Reviews in other languages are excluded. ## `proxyConfiguration` (type: `object`): Proxy settings. Apify Proxy (datacenter) is sufficient for TripAdvisor's review endpoint. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.tripadvisor.com/Hotel_Review-g45963-d91967-Reviews-Treasure_Island_TI_Las_Vegas-Las_Vegas_Nevada.html" } ], "maxReviews": 100, "language": "en", "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `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": [ { "url": "https://www.tripadvisor.com/Hotel_Review-g45963-d91967-Reviews-Treasure_Island_TI_Las_Vegas-Las_Vegas_Nevada.html" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("gopalakrishnan/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": [{ "url": "https://www.tripadvisor.com/Hotel_Review-g45963-d91967-Reviews-Treasure_Island_TI_Las_Vegas-Las_Vegas_Nevada.html" }] } # Run the Actor and wait for it to finish run = client.actor("gopalakrishnan/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": [ { "url": "https://www.tripadvisor.com/Hotel_Review-g45963-d91967-Reviews-Treasure_Island_TI_Las_Vegas-Las_Vegas_Nevada.html" } ] }' | apify call gopalakrishnan/tripadvisor-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=gopalakrishnan/tripadvisor-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TripAdvisor Reviews Scraper — Hotels, Restaurants & Attractions", "description": "Scrapes TripAdvisor reviews with star ratings, sub-ratings (cleanliness, service, value), trip type, reviewer info, and owner responses. Supports hotels, restaurants, and attractions with language filtering.", "version": "0.0", "x-build-id": "E79iuXoxUt5yfhHwt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gopalakrishnan~tripadvisor-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gopalakrishnan-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/gopalakrishnan~tripadvisor-reviews-scraper/runs": { "post": { "operationId": "runs-sync-gopalakrishnan-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/gopalakrishnan~tripadvisor-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-gopalakrishnan-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": { "startUrls": { "title": "TripAdvisor location URLs", "type": "array", "description": "TripAdvisor detail-page URLs for hotels, restaurants, or attractions (e.g. https://www.tripadvisor.com/Hotel_Review-g45963-d91967-Reviews-Treasure_Island_TI_Las_Vegas-Las_Vegas_Nevada.html). The location id is read from the -d- segment of the URL.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxReviews": { "title": "Max reviews per location", "minimum": 1, "type": "integer", "description": "Maximum number of reviews to scrape for each location. Reviews are fetched newest-first in pages of 10.", "default": 100 }, "language": { "title": "Review language", "type": "string", "description": "Two-letter language code to filter reviews by (e.g. en, es, fr, de, it). Reviews in other languages are excluded.", "default": "en" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Apify Proxy (datacenter) is sufficient for TripAdvisor's review endpoint.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```