# Booking Reviews Scraper - New Guest Reviews Monitor by Hotel (`tenfoldfleet/booking-reviews-scraper-new-reviews-monitor`) Actor

Monitor new guest reviews of Booking.com hotels, or scrape a hotel's review list, by name or URL. A scheduled run returns only reviews posted since the previous one. Rows: score, likes and dislikes, language, room, stay, guest country, hotel reply. $2 per 1,000 reviews; hotels not found are free.

- **URL**: https://apify.com/tenfoldfleet/booking-reviews-scraper-new-reviews-monitor.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** Travel, Agents, MCP servers
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 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/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

### What does Booking Reviews Scraper do?

**Booking Reviews Scraper** reads the **guest reviews Booking.com shows for a hotel** and keeps watch for new ones. Run it once and you have a hotel's reviews, newest first. Put it on a schedule with **Only new reviews** switched on and it becomes a **new reviews monitor**: every run delivers just what guests posted since the previous run, and a review is delivered, and billed, once per hotel.

You say which hotels by **name or booking.com hotel URL**. Each row is one review: the score, the title, what the guest liked and what they disliked in two separate fields, the language, the guest's name and country as shown publicly, traveller type, room, length and date of stay, and the **hotel's reply** when one exists. Use it as a **Booking.com reviews API**: plain HTTPS requests, no browser, no login, results as JSON, CSV or Excel.

Not affiliated with, endorsed or sponsored by Booking.com or Booking Holdings.

### Why use a Booking.com reviews monitor?

- **Reputation management**: get every new review of your properties each morning, and see which ones still have no reply from the hotel.
- **Hotel groups and revenue teams**: follow your own hotels and the competitors next door in one dataset.
- **Alerts on bad stays**: set a maximum score of 6 and a schedule, and only low-scoring new reviews arrive.
- **Sentiment and topic analysis**: feed liked and disliked text, split into two fields, into your own models or an AI agent.
- **Market research**: compare guest mix by country and traveller type across hotels.

### What data can Booking Reviews Scraper extract?

| Field | Description |
|---|---|
| `hotelId`, `hotelName`, `hotelUrl` | The hotel the review belongs to |
| `reviewId` | Booking.com's id of the review (a stable hash when it has none) |
| `reviewDate` | When the review was posted (ISO 8601) |
| `score` | Guest score, 1 to 10 |
| `title`, `positiveText`, `negativeText` | Review title, what the guest liked, what the guest disliked |
| `language` | Language code of the review (`en`, `de`, `fr` ...; regional variants as `en-us`, `pt-br`, `es-ar`, `es-mx`, `zh-tw`) |
| `guestName`, `guestCountry`, `guestCountryCode` | As shown publicly on the review; `Anonymous` when the guest hid the name |
| `travellerType` | Couple, Family, Solo traveller, Group, Business |
| `roomType`, `stayNights`, `stayDate`, `checkoutDate` | Room booked, number of nights, check-in and check-out date |
| `partnerReply`, `partnerReplyDate` | The hotel's public reply; the date is filled only when Booking.com publishes it |
| `helpfulVotes` | Number of "helpful" votes |
| `hotelReviewsCount`, `hotelScore` | Reviews listed for the hotel and its overall score |
| `isNew` | `false` when an earlier only-new run already returned this review |
| `scrapedAt` | Time of the run |

### How to scrape Booking.com reviews

1. Open the Actor and add your hotels: a name with its city (`The Hoxton, Amsterdam`) or a hotel URL (`booking.com/hotel/nl/toren.html`).
2. Set **Max reviews per hotel**. Optionally filter by language, score range or a start date.
3. Click **Start** and download the dataset as JSON, CSV or Excel, or read it through the Apify API.

### How to monitor new Booking.com reviews

1. Switch on **Only new reviews**.
2. Save the input as a task and add a schedule (daily or weekly).
3. The first run returns the newest reviews up to your limit and remembers them. Every later run returns only what was posted since. A hotel with nothing new produces one free status row, so a quiet day costs nothing beyond the start fee of $0.00005.

The memory is a key-value store named `booking-reviews-monitor-state` in your own account, one record per hotel. Reviews older than the first run's window are treated as backlog and are not returned later. To start again, switch on **Reset the only-new memory** for one run.

From the second run on, a run that stops at **Max reviews per hotel** leaves nothing behind: the next run returns the reviews that were left, still once each. The same holds for any run, the first one included, that stops at its maximum charge or near its time limit.

### How much does it cost to scrape Booking.com reviews?

**$2 per 1,000 reviews** ($0.002 per review), plus $0.00005 per run. No monthly rental.

Free of charge: hotels that cannot be found, hotels without reviews, only-new runs that find nothing new, and pages that fail after retries. In only-new mode you never pay twice for the same review. The free Apify plan has no separate limit here: its monthly credit covers about 2,500 reviews.

Example: 20 hotels checked daily with about 3 new reviews each is 60 reviews a day, about $3.60 a month.

### Input

```json
{
    "hotels": ["The Hoxton, Amsterdam", "https://www.booking.com/hotel/nl/toren.html"],
    "maxReviewsPerHotel": 100,
    "onlyNew": true,
    "languages": ["en", "de"],
    "maxScore": 6
}
```

`since` (a date such as `2026-10-01`), `minScore`, `sort` (newest, oldest, relevant, highest, lowest) and `proxy` are optional. A numeric Booking.com hotel id is accepted in `hotels` too.

### Output

![Sample output of Booking Reviews Scraper, rows from a real run: Hotel, Review date, Score, Title, Liked, Disliked](https://api.apify.com/v2/key-value-stores/4TBgG7fopkYMNWnX2/records/booking-reviews-scraper-new-reviews-monitor-output.png)

```json
{
    "input": "https://www.booking.com/hotel/nl/toren.html",
    "hotelId": 10004,
    "hotelName": "The Toren Amsterdam, by The Pavilions",
    "hotelUrl": "https://www.booking.com/hotel/nl/toren.html",
    "reviewId": "bc23844f10bb1fd8",
    "reviewDate": "2026-11-08T10:45:05.000Z",
    "score": 10,
    "title": "Amazing.",
    "positiveText": "Everything was great.",
    "negativeText": null,
    "language": "en",
    "guestName": "Umut",
    "guestCountry": "Turkey",
    "guestCountryCode": "tr",
    "travellerType": "Couple",
    "roomType": "Standard Double or Twin Room",
    "stayNights": 2,
    "stayDate": "2026-11-06",
    "checkoutDate": "2026-11-08",
    "partnerReply": "Thank you so much for your wonderful review! ...",
    "partnerReplyDate": null,
    "helpfulVotes": 0,
    "hotelReviewsCount": 1101,
    "hotelScore": 8.9,
    "isNew": true,
    "scrapedAt": "2026-11-15T00:43:17.000Z"
}
```

Rows without a review carry either an `error` (hotel not found, reviews not loaded) or a `status` (`no-new-reviews`, `no-reviews`, `no-matching-reviews`, `duplicate`, `skipped`) with a `message`. They are free. When a run stops at its maximum charge or time limit, the hotels it did not reach are listed together in one `skipped` row (`skippedInputs`).

### Tips

- **Names**: add the city, and check `hotelName` in the first run. The Actor takes the Booking.com suggestion that fits the words you typed. A name that is too general (`hotel`) or that no suggestion resembles gets a free error row instead of a guess.
- **URLs**: a URL is matched through Booking.com's search and accepted only when the listing's page name is identical to the one in the URL, so it never returns another hotel's reviews. In our tests about 94% of URLs matched (76 of 81, none to a wrong hotel). A listing whose page name shares nothing with its current name and does not mention its city may not be found: use its name or numeric hotel id instead. A matched URL is remembered for later runs.
- **Many new reviews**: in only-new mode keep **Max reviews per hotel** above the number of reviews a hotel collects between two runs. If a hotel collects more, the newest are returned first and the next run returns the rest.
- **Languages**: use two-letter codes (`en`, `de`, `fr`). `en` covers British and American English. An entry that is not a language code stops the run before anything is charged.
- **Filters in only-new mode**: reviews that your score or date filter rejects are remembered as seen.
- **Prices instead of reviews**: our Booking hotel prices Actor reads room rates through the same public Booking.com endpoint; this one reads reviews only.

### FAQ

#### Does Booking.com have a public reviews API?

Booking.com offers APIs to its partners, not a public one for reviews. This Actor reads the same public review list a visitor sees on the hotel page.

#### How far back can it go?

As far as Booking.com lists reviews for the hotel. `hotelReviewsCount` shows how many are available; set **Max reviews per hotel** to that number to export all of them.

#### Why is `partnerReplyDate` empty?

Booking.com shows the reply text but rarely publishes its date. The field is filled when the date is available.

#### Can I use it from an AI agent or MCP client?

Yes. Call it through the Apify API or the Apify MCP server with a list of hotel names; rows are flat JSON with one review each.

#### Does it need a proxy?

The default Apify datacenter proxy is enough. If a run reports blocked requests, switch the proxy input to residential.

### Disclaimer

This Actor collects publicly visible review data only and uses no login. Reviews can contain personal data (a guest's first name and country, as shown on the public page). Make sure you have a lawful basis for processing it under GDPR and similar rules, and do not use it to contact or profile individuals. Respect Booking.com's terms when you use the data.

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [AliExpress Reviews Scraper: Product Feedback & Photos Monitor](https://apify.com/tenfoldfleet/aliexpress-reviews-scraper) | review |
| [Amazon Reviews Summary - AI Insights & Star Breakdown](https://apify.com/tenfoldfleet/amazon-reviews-summary) | product review insights |
| [BBB Scraper: Business Leads, Ratings & New Reviews](https://apify.com/tenfoldfleet/bbb-scraper-leads-reviews) | business |
| [Douban Reviews Scraper - Movies, Books, TV & Groups](https://apify.com/tenfoldfleet/douban-reviews-scraper) | review |
| [Trustpilot Reviews Scraper - New Reviews Monitor & TrustScore](https://apify.com/tenfoldfleet/trustpilot-reviews-scraper-new-reviews-monitor) | review |
| [Google Flights API & Scraper - Fares by Route and Date](https://apify.com/tenfoldfleet/google-flights-scraper) | route search |
| [Google Hotels Scraper - Nightly Prices, Stars & Booking Sites](https://apify.com/tenfoldfleet/google-hotels-scraper) | hotel |
| [Google Travel Hotel Rate Tracker - OTA Prices for Every Night](https://apify.com/tenfoldfleet/google-travel-hotel-rate-tracker) | offer |
| [1688 Alibaba AliExpress Image Search: Compare Prices by Photo](https://apify.com/tenfoldfleet/1688-alibaba-aliexpress-image-search) | matched product |
| [1688 Image Search API - Reverse Image Search for Factory Prices](https://apify.com/tenfoldfleet/1688-image-search-suppliers-by-photo) | image search |
| [1688 Product Details API: Price Tiers, MOQ, Specs & Supplier](https://apify.com/tenfoldfleet/1688-product-details-scraper) | product details |
| [1688 Products Search: Wholesale Prices, Sales & Suppliers](https://apify.com/tenfoldfleet/1688-products-search) | product |

All 122 tools: [apify.com/tenfoldfleet](https://apify.com/tenfoldfleet). If this Actor saves you time, save it (the bookmark on its Store page) and leave a review: both help other people find it. Found a bug or need another field? Tell us on the Issues tab of this page.

# Changelog

This Actor's version history is a separate document: https://apify.com/tenfoldfleet/booking-reviews-scraper-new-reviews-monitor/changelog.md

# Actor input Schema

## `hotels` (type: `array`):

Hotel names (add the city: "The Hoxton, Amsterdam") or booking.com hotel URLs (https://www.booking.com/hotel/nl/toren.html). A name takes the Booking.com suggestion that fits the words you typed (a name that is too general gets a free error row); a URL is only accepted when the listing's page name is identical, so it never returns another hotel's reviews. Hotels that cannot be found are reported in a free row.

## `maxReviewsPerHotel` (type: `integer`):

Upper limit of reviews returned for each hotel in one run. Each returned review costs $0.002. There is no separate free-plan limit: the free Apify plan's monthly credit covers about 2,500 reviews.

## `since` (type: `string`):

Optional. Return only reviews posted on or after this date, e.g. 2026-10-01.

## `sort` (type: `string`):

Order in which reviews are read. Only-new mode always reads newest first.

## `languages` (type: `array`):

Optional. Two-letter language codes (en, de, fr, es, it, nl ...). Only reviews written in these languages are returned; en covers British and American English. Empty = all languages. An entry that is not a language code stops the run before anything is charged.

## `minScore` (type: `integer`):

Optional. Return only reviews with this score or higher (1-10).

## `maxScore` (type: `integer`):

Optional. Return only reviews with this score or lower (1-10). Set 6 to watch only negative reviews.

## `onlyNew` (type: `boolean`):

Return only reviews that earlier only-new runs have not returned for the same hotel, so a daily or weekly schedule never pays for a review twice. The first run returns the newest reviews up to the limit and remembers them; later runs return what was posted since. A run that stops at the limit or at its maximum charge is continued by the next run. A hotel with nothing new gets one free status row. The memory is a key-value store named booking-reviews-monitor-state in your account.

## `forgetSeen` (type: `boolean`):

With only-new mode: forget which reviews were already returned for these hotels and start again. Reviews returned again are charged again.

## `proxy` (type: `object`):

Apify datacenter proxy works and is the default. Switch to residential only if a run reports blocked requests.

## Actor input object example

```json
{
  "hotels": [
    "The Hoxton, Amsterdam",
    "https://www.booking.com/hotel/nl/toren.html"
  ],
  "maxReviewsPerHotel": 25,
  "sort": "newest",
  "onlyNew": false,
  "forgetSeen": false,
  "proxy": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (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 = {
    "hotels": [
        "The Hoxton, Amsterdam",
        "https://www.booking.com/hotel/nl/toren.html"
    ],
    "maxReviewsPerHotel": 25,
    "proxy": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/booking-reviews-scraper-new-reviews-monitor").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 = {
    "hotels": [
        "The Hoxton, Amsterdam",
        "https://www.booking.com/hotel/nl/toren.html",
    ],
    "maxReviewsPerHotel": 25,
    "proxy": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/booking-reviews-scraper-new-reviews-monitor").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 '{
  "hotels": [
    "The Hoxton, Amsterdam",
    "https://www.booking.com/hotel/nl/toren.html"
  ],
  "maxReviewsPerHotel": 25,
  "proxy": {
    "useApifyProxy": true
  }
}' |
apify call tenfoldfleet/booking-reviews-scraper-new-reviews-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenfoldfleet/booking-reviews-scraper-new-reviews-monitor"
        }
    }
}
```

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/z6D5GdaWdZjKV9ayn/builds/9rtBYb5pN5WC1Ddgn/openapi.json
