# Fast TripAdvisor Reviews Scraper API | Hotel, Restaurant Review (`agents/tripadvisor-reviews`) Actor High-performance TripAdvisor review scraper delivering 100-200 reviews per second with precision filtering by language, ratings, and dates. Affordable at $0.50 per 1,000 reviews, with rich data output and custom mapping capabilities. Perfect for research, analytics, and market intelligence. - **URL**: https://apify.com/agents/tripadvisor-reviews.md - **Developed by:** [Agents](https://apify.com/agents) (community) - **Categories:** Travel, Developer tools, Automation - **Stats:** 217 total users, 32 monthly users, 100.0% runs succeeded, 15 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing $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. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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: The Fastest, Cheapest and Most Reliable **Built by [Agents](https://apify.com/agents?fpr=yhdrb) — Intelligence. Precision. Impact.** *** ### 🚀 Overview Our TripAdvisor Reviews Scraper is engineered for high-performance data extraction, delivering real-time, granular insights to empower: - **Speed:** Scrape 100-200 reviews per second - **Precision:** Filter by language, ratings, and dates - **Flexibility:** Transform data with custom mapping functions - **Rich Data:** Access comprehensive review details and metadata Whether you need to monitor guest sentiment or fuel deep intelligence research, our tool provides actionable review data with unmatched speed and accuracy. Built by [Agents](https://apify.com/agents?fpr=yhdrb)—a team of ex-Big Tech engineers and data specialists—this scraper is part of a cross-platform review intelligence suite covering TripAdvisor, Trustpilot, and Yelp. #### Agents Review Intelligence Suite | Tool | What It Extracts | Best For | | ----------------------------------------------------------------------------------------- | ---------------------------------------- | ------------------------------------------- | | ⭐ **TripAdvisor Reviews Scraper** | Hotel/restaurant reviews, ratings | Hospitality intelligence **(You are here)** | | ⭐ **[Trustpilot Reviews Scraper](https://apify.com/agents/trustpilot-reviews?fpr=yhdrb)** | Reviews, TrustScores, company replies | SaaS/B2B analysis | | ⭐ **[Yelp Reviews Scraper](https://apify.com/agents/yelp-reviews?fpr=yhdrb)** | Yelp reviews, ratings, reviewer profiles | Restaurant/hospitality | | 🏪 **[Yelp Business Scraper](https://apify.com/agents/yelp-business?fpr=yhdrb)** | Business profiles, ratings, contact | Lead generation | *** ### 💰 Pricing - **$0.50** per **1,000 reviews** - Demo Mode Available for Free Users (max 10 items, API not available) *** ### 🔍 How It Works 1. **Set Your Targets:**\ Provide TripAdvisor URLs for the reviews you want to extract. 2. **Define Your Parameters:**\ Configure filters like publication date (`since`), ratings, languages, and review limits. 3. **Run and Analyze:**\ Execute the scraper to receive detailed review data at high speed. #### Input Definitions | Field | Type | Description | Default | | ------------------- | ------ | --------------------------------------------------------------------- | ---------- | | `startUrls` | array | TripAdvisor URLs from which to extract reviews | `[]` | | `since` | string | Filter reviews published after this date | `null` | | `startPage` | number | Starting page number for scraping | `1` | | `locale` | string | Auto-translate reviews to a target language (TripAdvisor translation). Results may vary — TripAdvisor's translation is unreliable. | `none` | | `ratings` | string | Filter reviews by specific ratings | `[]` | | `languages` | array | Filter reviews by language | `[]` | | `maxItems` | number | Maximum number of reviews to retrieve | `Infinity` | | `customMapFunction` | string | Custom JavaScript function to transform each review. *(mapping only)* | `null` | *** ### ⚙️ Sample Output A typical review appears as follows: ```json { "id": "986902418", "createdDate": "2024-12-29", "publishedDate": "2024-12-29", "rating": 5, "title": "Great staff", "text": "Jeffrey is great! Experienced some minor error during check in...", "language": "en", "username": "songh455", "location": { "name": "SpringHill Suites New York Manhattan/Times Square South" } } ``` *** ### 👍 Who Benefits - **Data Scientists:** Uncover patterns and drive actionable decisions - **Academic Researchers:** Gather empirical data for studies - **Hospitality Professionals:** Monitor guest feedback - **Market Researchers:** Extract competitive intelligence - **Reputation Managers:** Track guest sentiment across properties - **Travel Industry Analysts:** Benchmark competitors and identify trends *** ### 🛠 Troubleshooting & Tips - **Result Quantity Adjustments:**\ Adjust the `maxItems` parameter if you receive unexpected quantities. Excess data is free—you'll only be billed for your specified amount. - **Missing Data?**\ Check the Storage tab for complete results. Verify your input parameters for accuracy. - **Need Help?**\ Our support team is ready to assist with any issues or questions. *** ### 📌 Contact & Support **Built by [Agents](https://apify.com/agents?fpr=yhdrb)** — Where others search, we uncover. Our team of ex-Big Tech engineers, growth hackers, and data specialists builds high-performance scraping tools engineered for speed, precision, and reliability. For questions or further assistance: - **Discord:** Join our community to connect with our support team - **Email:** Reach out at *** **Ready to start extracting TripAdvisor review data?** With simple per-review pricing, demo mode for free testing, and no API required, this **TripAdvisor Reviews Scraper** by [Agents](https://apify.com/agents?fpr=yhdrb) is the ultimate tool for hospitality intelligence, guest sentiment analysis, and competitive benchmarking. Start scraping today! ⭐ # Actor input Schema ## `startUrls` (type: `array`): URLs you want to retrieve the reviews from. Only TripAdvisor detail URLs are accepted. ## `since` (type: `string`): Get reviews made since the date. ## `startPage` (type: `integer`): Start page to get reviews from. ## `locale` (type: `string`): Requests TripAdvisor to auto-translate reviews. Results may vary — TripAdvisor's translation is unreliable. ## `languages` (type: `array`): Select the review languages. ## `ratings` (type: `array`): Select the review ratings. ## `maxItems` (type: `integer`): Maximum number of items that you want as output. ## `customMapFunction` (type: `string`): Function that takes each of the objects as argument and returns data that will be mapped by the function itself. This function is not intended for filtering, please don't use it for filtering purposes or you will get banned automatically. ## Actor input object example ```json { "startUrls": [ "https://www.tripadvisor.com/Restaurant_Review-g60763-d25324283-Reviews-Allora_Fifth_Ave-New_York_City_New_York.html", "https://www.tripadvisor.com/Hotel_Review-g60763-d15288822-Reviews-SpringHill_Suites_New_York_Manhattan_Times_Square_South-New_York_City_New_York.html?spAttributionToken=MjMyMTAzMzg" ], "locale": "none", "languages": [ "all" ], "ratings": [ "all" ], "maxItems": 1000, "customMapFunction": "(object) => { return {...object} }" } ``` # Actor output Schema ## `overview` (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/Restaurant_Review-g60763-d25324283-Reviews-Allora_Fifth_Ave-New_York_City_New_York.html", "https://www.tripadvisor.com/Hotel_Review-g60763-d15288822-Reviews-SpringHill_Suites_New_York_Manhattan_Times_Square_South-New_York_City_New_York.html?spAttributionToken=MjMyMTAzMzg" ], "languages": [ "all" ], "ratings": [ "all" ], "maxItems": 1000, "customMapFunction": (object) => { return {...object} } }; // Run the Actor and wait for it to finish const run = await client.actor("agents/tripadvisor-reviews").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/Restaurant_Review-g60763-d25324283-Reviews-Allora_Fifth_Ave-New_York_City_New_York.html", "https://www.tripadvisor.com/Hotel_Review-g60763-d15288822-Reviews-SpringHill_Suites_New_York_Manhattan_Times_Square_South-New_York_City_New_York.html?spAttributionToken=MjMyMTAzMzg", ], "languages": ["all"], "ratings": ["all"], "maxItems": 1000, "customMapFunction": "(object) => { return {...object} }", } # Run the Actor and wait for it to finish run = client.actor("agents/tripadvisor-reviews").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/Restaurant_Review-g60763-d25324283-Reviews-Allora_Fifth_Ave-New_York_City_New_York.html", "https://www.tripadvisor.com/Hotel_Review-g60763-d15288822-Reviews-SpringHill_Suites_New_York_Manhattan_Times_Square_South-New_York_City_New_York.html?spAttributionToken=MjMyMTAzMzg" ], "languages": [ "all" ], "ratings": [ "all" ], "maxItems": 1000, "customMapFunction": "(object) => { return {...object} }" }' | apify call agents/tripadvisor-reviews --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=agents/tripadvisor-reviews", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/acts/k2dVBeyzwpXxHACKa/builds/2fZx3TjuVxMEKtGyL/openapi.json