# Fast TripAdvisor Reviews Scraper API | Hotel, Restaurant Review (`theagents/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/theagents/tripadvisor-reviews.md
- **Developed by:** [Agents](https://apify.com/theagents) (community)
- **Categories:** Travel, Developer tools, Automation
- **Security:** Limited permissions
- **Stats:** 252 total users, 7 monthly users, 100.0% runs succeeded, 15 bookmarks
- **User rating**: 3.16 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## TripAdvisor Reviews Scraper: The Fastest, Cheapest and Most Reliable

**Built by [Agents](https://apify.com/theagents?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/theagents?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/theagents/trustpilot-reviews?fpr=yhdrb)** | Reviews, TrustScores, company replies    | SaaS/B2B analysis                           |
| ⭐ **[Yelp Reviews Scraper](https://apify.com/theagents/yelp-reviews?fpr=yhdrb)**             | Yelp reviews, ratings, reviewer profiles | Restaurant/hospitality                      |
| 🏪 **[Yelp Business Scraper](https://apify.com/theagents/yelp-business?fpr=yhdrb)**           | Business profiles, ratings, contact      | Lead generation                             |

***

### 💰 Pricing

- **$0.50** per **1,000 reviews**
- Demo Mode Available for Free Users (**5 runs per month**, each capped at **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 | JavaScript function to transform each output review. Ignored with a warning if it is not a usable function (see [Custom Map Function](#-custom-map-function)) | `null`     |
| `outputConnector`   | string | MCP connector to deliver the reviews to (see [Send Results to Notion, Todoist and More](#-send-results-to-notion-todoist-and-more)) | `null`     |
| `deliverTarget`     | string | Where the connector writes — paste the URL or ID (Notion example: `https://www.notion.so/My-Reviews-24f8a1b2c3d44e5f8a9b0c1d2e3f4a5b`); some services need none | `null`     |
| `deliverMode`       | string | `perPost` (one record per review) or `summary` (one roll-up per run) | `perPost`  |
| `deliverMaxItems`   | number | Optional cap on how many records `perPost` delivers (ignored in `summary`) | `null`     |

***

### 🧩 Custom Map Function

Transform output using the `customMapFunction` parameter. This JavaScript function receives each review object and returns your desired format-add computed fields, flatten nested data, or remove fields you do not need.

**Important:** Custom map function is for data transformation-**not for filtering**. Filtering items may result in automatic restrictions. Returning an empty object does not remove the item from the dataset-it is saved as `{ "noResults": true }` instead.

```javascript
(object) => ({
  ...object,
  isPositive: object.rating >= 4,
  textLength: object.text?.length ?? 0,
  locationName: object.location?.name,
  location: undefined
})
```

#### Requirements & Error Handling

The value must be a **single JavaScript function** that takes one item and returns the transformed item. Arrow functions and regular functions both work; `async` and generator functions are not supported.

**Limits:** the function runs in an isolated sandbox. It must be synchronous and finish within about 1 second per item, and only plain JavaScript is available (no network requests, `require` or `console`). Each item is passed in as plain JSON data.

**An unusable function never stops your run.** The actor logs a warning, ignores the function, and saves the original, unmodified items instead-so you still get your data:

| Situation | What happens |
| --------- | ------------ |
| Not valid JavaScript (for example, plain text pasted into the field) | Rejected before the first request; original items are saved |
| Valid JavaScript but not a function (for example, an object) | Rejected before the first request; original items are saved |
| `async` or generator function | Rejected before the first request; original items are saved |
| Returns a Promise (for example, `(object) => Promise.resolve(object)`) | Rejected at that point; the remaining items are saved unmodified |
| Returns something other than an object (for example, a number or `null`) | Rejected at that point; the remaining items are saved unmodified |
| Throws while transforming an item | Rejected at that point; the remaining items are saved unmodified |
| Takes longer than about 1 second on one item (for example, an endless loop) | Rejected at that point; the remaining items are saved unmodified |
| Uses date operations (`new Date`, `Date.now`, `1970`) | Rejected-use the `since` input to filter by date instead |

If your output does not look transformed, check the run log for a warning that starts with `Your "customMapFunction" input was rejected:`-it explains exactly what was wrong.

If you do not need to transform the output, simply leave this field empty.

***

### 🔗 Send Results to Notion, Todoist and More

Skip the manual exports — the TripAdvisor Reviews Scraper can deliver its results directly into the tools you already work in, through [Apify MCP Connectors](https://apify.com/store/collections/mcp-connectors):

1. Authorize a connector (Notion, Todoist, or any service whose MCP server offers non-destructive write tools) once in [Console → Settings → API & Integrations → MCP connectors](https://console.apify.com/settings/integrations).
2. Pick it from the **Send results to Notion, Todoist, …** dropdown.
3. Fill in where and how to write:
   - **Destination target** — paste the URL or ID (Notion example: `https://www.notion.so/My-Reviews-24f8a1b2c3d44e5f8a9b0c1d2e3f4a5b`); share it with your connector first via Notion's **•••  → Connections** menu. For structured columns use a **page** URL (the Actor builds the database for you) or a database that **already has columns** — an empty database only receives titles. (Some services need no target.)
   - **Write mode** — `perPost` writes one record per review; `summary` writes a single roll-up for the run.
   - **Max records to deliver** *(optional)* — cap on how many records `perPost` delivers.

**Notion, structured like a spreadsheet:** for a table of typed columns, point the target at a Notion **page** — the Actor auto-creates a database from the data, one matching, correctly-typed column per field (URL, number, date, text). Pointing at an **existing database** fills the columns it already has (matched by name); an **empty database** receives only the title, and the rest of each record goes to the row body — the connector can't add columns to an existing database without destructive access it never requests. Nested fields such as `userProfile` or `location` are flattened into columns too, so everything is sortable and filterable in the grid. Fields that don't fit a column go to the row's page body, so nothing is lost.

Your credentials stay yours: the Actor talks to your services exclusively through your own authorized connector and only ever uses non-destructive write tools — it cannot delete or overwrite anything you already have. Delivery is best-effort and runs after the scrape: if a connector is misconfigured or a delivery fails, your run still finishes normally with all results intact — the failure is reported in the run log, never by failing the run. If the run is about to hit its timeout, delivery stops early so the run still succeeds, and the log tells you how many records were delivered.

***

### ⚙️ 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/theagents?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 <whoaretheagents@gmail.com>

***

**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/theagents?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`):

JavaScript function to transform each output review. Use to add computed fields, modify values, or remove unnecessary data. NOT intended for filtering - filtering may result in automatic bans. Must be a single synchronous function, e.g. (object) => { return {...object} }. It runs in a sandbox with plain JavaScript only (no network or require) and about 1 second per item. Leave empty if you do not need to transform the output - an unusable function is ignored and the original items are saved instead.

## `outputConnector` (type: `string`):

Pick an MCP connector you authorized in Console → Settings → API & Integrations → MCP connectors (e.g. Notion, Todoist — any service whose MCP server offers non-destructive write tools works best-effort). The scraped results are written through your own connector — the Actor never sees your third-party credentials. Only non-destructive write tools are used; it can never delete or overwrite your existing data.

## `deliverTarget` (type: `string`):

Where to write into the connector — paste the URL or ID. Notion example: https://www.notion.so/My-Reviews-24f8a1b2c3d44e5f8a9b0c1d2e3f4a5b. Leave empty for services that need no target (e.g. Todoist Inbox, Slack). For Notion, share the page or database with your connector first (Notion's ••• → Connections menu), and point at a PAGE for structured columns (the Actor builds the database for you) — an empty database receives only the title (the rest of each record goes to the row's body).

## `deliverMode` (type: `string`):

perPost writes one record per scraped review; summary writes a single roll-up for the run.

## `deliverMaxItems` (type: `integer`):

Cap on how many records perPost mode writes to the connector; ignored in summary mode. Leave empty to deliver everything scraped.

## 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} }",
  "deliverMode": "perPost"
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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("theagents/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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("theagents/tripadvisor-reviews").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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 theagents/tripadvisor-reviews --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,theagents/tripadvisor-reviews"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/k2dVBeyzwpXxHACKa/builds/FbKbu7MZxNLmJgJjb/openapi.json
