# Booking Scraper (`automly/booking-scraper`) Actor

Scrape Booking.com hotels by destination and dates or hotel link: nightly price, taxes and fees, guest rating, reviews count, room types, address, coordinates and photos. No account needed. Export to CSV, JSON or Excel, schedule runs or use the API.

- **URL**: https://apify.com/automly/booking-scraper.md
- **Developed by:** [Automly](https://apify.com/automly) (community)
- **Categories:** Travel
- **Features:** Limited permissions
- **Stats:** 5 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 scraped place results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## Booking.com Scraper - Hotel Prices, Ratings & Rooms

### What is Booking.com Scraper?

**Booking.com Scraper** is a tool that lets you **scrape hotel prices, guest ratings, room types, taxes and fees, addresses and photos from Booking.com** search results and hotel pages. Type a destination like `Paris`, add your check-in and check-out dates, click **Start**, and download the hotels as Excel, CSV or JSON, priced for your exact dates, guests and currency.

- 💵 **Real prices for your dates:** the nightly price and the separate taxes-and-fees line Booking.com shows a visitor
- 🔎 **Your filters kept:** paste a Booking.com search link with star rating, review score, sort order and more
- 🏨 **Up to 500 hotels per run** from one or many searches, in Booking.com's own order
- 🔓 **No login:** no Booking.com account needed
- 💸 **Free to try:** the $5 of free usage every Apify account gets each month covers up to about 2,000 hotels

### What can Booking.com Scraper do?

- **Scrape Booking.com hotels by city or destination**, such as `Paris` or `Lisbon`
- **Scrape Booking.com hotel prices for specific dates**, guests and rooms
- **Scrape a Booking.com search link** with your filters: stars, review score, price, sort order, children and their ages
- **Scrape single Booking.com hotel pages** from their links
- **Monitor hotel rates on a schedule** and see how prices move across dates and seasons
- **Get prices in any currency** and pages in your language
- Export to Excel, CSV, JSON, HTML or XML, or send the data to Google Sheets, Make, Zapier and more

### What data can you extract from Booking.com?

| | | |
|---|---|---|
| 🏨 Hotel name and ID | 🔗 Hotel link and search link | 🔢 Rank in the search results |
| 💵 Price for your dates | 🧾 Taxes and fees line | 💱 Currency you choose |
| ⭐ Guest rating score | 💬 Number of reviews | 🛏️ Room name |
| 📍 Address, city and country | 🌐 Latitude and longitude | 🌆 Hotel photo links |
| 🧺 Amenities | 📝 Hotel description | 📅 Check-in, check-out and adults used |

### How to scrape Booking.com hotels

1. [Create a free Apify account](https://console.apify.com/sign-up) (no credit card needed).
2. Open **Booking.com Scraper**.
3. Type a destination into **Location query**, or paste Booking.com search links or hotel links.
4. Set **Check-in date** and **Check-out date**, the number of **Adults** and **Rooms**, and how many hotels you want, then click **Start**.
5. When the run finishes, download your hotels as Excel, CSV, JSON, HTML or XML.

#### 💡 Tips for scraping hotels on Booking.com

1️⃣ **Always provide check-in and check-out dates.** Booking.com only shows full room and price information when dates are set. Without them you get the hotels but no prices. Prices returned match your exact dates, guest count and currency.

2️⃣ **Paste a search link to keep your filters.** **Location query** is the quickest start. A Booking.com search link copied from the address bar keeps everything you set there: star rating, review score, price and other filters, sort order, children and their ages.

3️⃣ **Set Maximum results to how many hotels you need.** A search is read in Booking.com's own order until it reaches **Maximum results** (up to 500) or the end of the results. With several searches, **Maximum results** is the total for the run.

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

You pay **$2.50 per 1,000 hotels**, plus a start fee of $0.005 per run at the default settings. You also pay the Apify platform usage of the run, which is billed separately.

Example: 1,000 hotels cost $2.50 plus the $0.005 start fee and the run's platform usage.

Every Apify account gets **$5 of free usage each month**, so you can try it at no cost. See the **Pricing** tab for details.

### ⬇️ Input

Add at least one of **Location query**, **Booking.com search URLs** or **Booking.com hotel URLs**.

| Setting | What it does |
|---|---|
| Booking.com search URLs | Full Booking.com search links, with any filters you set on the site |
| Booking.com hotel URLs | Links to single Booking.com hotel pages |
| Location query | A destination name, such as `Paris`, used when you have no search link |
| Check-in date / Check-out date | Dates in `YYYY-MM-DD` format. Needed for prices |
| Adults | Number of adult guests, 1 to 30 (default 2) |
| Rooms | Number of rooms, 1 to 30 (default 1) |
| Maximum results | How many hotels to save in the run, 1 to 500 (default 50) |
| Currency | Currency for prices, such as `USD` or `EUR` |
| Language | Language for the pages, such as `en-us` |
| Connection settings | The default works for most runs |

Hotels in Paris for two nights, two adults, priced in US dollars:

```json
{
    "locationQuery": "Paris",
    "checkInDate": "2026-11-12",
    "checkOutDate": "2026-11-14",
    "adults": 2,
    "rooms": 1,
    "maxResults": 25,
    "currency": "USD",
    "language": "en-us"
}
```

Three specific hotels for the same dates:

```json
{
    "hotelUrls": [
        "https://www.booking.com/hotel/fr/melia-paris-champs-elysees.html",
        "https://www.booking.com/hotel/fr/pullman-paris-tour-eiffel.html",
        "https://www.booking.com/hotel/fr/ibis-paris-tour-eiffel-cambronne-15eme.html"
    ],
    "checkInDate": "2026-11-12",
    "checkOutDate": "2026-11-14",
    "adults": 2
}
```

### ⬆️ Output

You get one row per hotel. Results appear in the **Output** tab as a sortable hotel table, and you can download them as Excel, CSV, JSON, HTML or XML. This hotel is from a real run for Paris, 12 to 14 November 2026:

```json
{
    "searchUrl": "https://www.booking.com/searchresults.html?ss=Paris&checkin=2026-11-12&checkout=2026-11-14&group_adults=2&no_rooms=1&selected_currency=USD&lang=en-us",
    "hotelUrl": "https://www.booking.com/hotel/fr/melia-paris-champs-elysees.html?checkin=2026-11-12&checkout=2026-11-14&group_adults=2&no_rooms=1&selected_currency=USD&lang=en-us",
    "hotelName": "Meliá Paris Champs Elysées",
    "hotelId": "58316",
    "address": "102 Avenue Victor Hugo, 16th arr., Paris",
    "city": "Paris",
    "country": "France",
    "latitude": "48.868714637814",
    "longitude": "2.28286698460579",
    "rating": "7.9",
    "reviewCount": "272",
    "price": "504",
    "currency": "USD",
    "taxesAndFees": "+$89 taxes and fees",
    "roomName": "Melia Double Room",
    "checkInDate": "2026-11-12",
    "checkOutDate": "2026-11-14",
    "adults": "2",
    "rank": "2",
    "imageUrls": "[\"https://cf.bstatic.com/xdata/images/hotel/square600/888870945.jpg?k=867d4f0ee1021b6c064ab2e30bbae4a3f93853a736049e284a51dd6a43138284&o=\"]",
    "scrapedAt": "2026-09-27T09:33:09Z"
}
```

Every hotel also comes with `amenities` and a `description`. In search results, `amenities` lists all of the hotel's facilities; for hotel links, its most popular ones, plus up to 20 photos. Searches without dates give the short summary shown in the results list as the `description`; searches with dates and hotel links give the hotel's own description. Hotel links are ranked in the order you listed them.

Fields Booking.com does not show for a hotel stay empty rather than being filled with guesses, and prices appear only when check-in and check-out dates are set. The scraper never adds made-up rows: a link that cannot be read is listed with its reason in the run report.

### How can I use Booking.com data?

- **Hotel rate monitoring:** track how competitor prices move across dates and seasons
- **Travel market research:** compare average nightly rates between cities or districts
- **Price comparison products:** feed live hotel prices into your own app or dashboard
- **Revenue management:** see where your property ranks in search results and how it is priced against neighbors
- **Tourism research:** build datasets of hotel supply, ratings and pricing for a region

### Scrape more travel data

| Actor | What it gets |
|---|---|
| [Tripadvisor Reviews Scraper](https://apify.com/automly/tripadvisor-reviews-scraper) | Hotel, restaurant and attraction reviews with ratings, reviewer profiles and owner replies |
| [Airbnb Listings Scraper](https://apify.com/automly/airbnb-listings-scraper) | Airbnb listings, prices, ratings and hosts for the same destinations |
| [Skyscanner Flight Scraper](https://apify.com/automly/skyscanner-flight-scraper) | Flight prices, airlines, stops and booking links for any route |
| [Google Maps Scraper](https://apify.com/automly/google-maps-scraper) | Hotels, restaurants and other places with ratings, phones and websites |

### ❓FAQ

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

$2.50 per 1,000 hotels plus a $0.005 start fee per run and the run's platform usage. See the cost section above and the **Pricing** tab.

#### Do I need a Booking.com account?

No. You don't need a Booking.com account or a login.

#### How many hotels does one search return?

As many as Booking.com lists for it, up to **Maximum results** (500 per run). A big city search lists thousands of places; the scraper returns them in Booking.com's own order, so the first rows are the ones a visitor sees first.

#### What export formats are supported?

JSON, CSV, Excel (XLSX), XML, HTML and RSS. Download from the **Storage** tab in Apify Console or with the Apify API.

#### Can I run it on a schedule?

Yes. Use Apify Schedules to run it daily or weekly, which is the usual setup for price monitoring. Each run gives you a dated dataset you can compare.

#### Why did my run return no results?

Check the run report: it lists every link that could not be read and why, for example a hotel page that no longer exists or a search with no available hotels for your dates.

#### Are the prices accurate?

Prices are the ones Booking.com shows a visitor for your exact dates, guest count and currency, including the separate taxes-and-fees line. They reflect the moment of the scrape. Booking.com changes prices often, which is why scheduled monitoring runs are useful.

#### Does it scrape guest reviews?

No. It gets the rating score and the number of reviews for each hotel. For full review text, use [Tripadvisor Reviews Scraper](https://apify.com/automly/tripadvisor-reviews-scraper).

#### Can I connect Booking.com Scraper to other tools or AI agents?

Yes. Start runs and download results with the Apify API or the Python and JavaScript clients, send results to Make, Zapier, n8n, Google Sheets or Slack with Apify integrations and webhooks, or let AI assistants and agents run it through the Apify MCP server at [mcp.apify.com](https://mcp.apify.com).

#### Is it legal to scrape Booking.com?

This scraper only collects hotel information that Booking.com shows publicly, such as names, prices and ratings. It does not collect guest accounts or private data. Some pages can still contain personal data, which may be protected by laws such as GDPR, so only scrape for a legitimate reason and ask a lawyer if you are unsure. You can read more in [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/)

Booking.com Scraper is an independent tool. It is not affiliated with, endorsed by or sponsored by Booking.com.

#### Something isn't working?

Open the **Issues** tab and tell us your input and what you expected.

### ⭐ Your feedback

Have an idea or found a problem? Tell us in the **Issues** tab. If Booking.com Scraper saved you time, a short review on the **Reviews** tab helps other people find it.

# Actor input Schema

## `searchUrls` (type: `array`):

Full Booking.com search result URLs to scrape. Use public URLs only.

## `hotelUrls` (type: `array`):

Direct public Booking.com hotel page URLs to scrape.

## `locationQuery` (type: `string`):

Optional destination name used to build a basic Booking.com search URL when no search URL is supplied.

## `checkInDate` (type: `string`):

Optional check-in date in YYYY-MM-DD format.

## `checkOutDate` (type: `string`):

Optional check-out date in YYYY-MM-DD format.

## `adults` (type: `integer`):

Number of adult guests.

## `rooms` (type: `integer`):

Number of rooms.

## `maxResults` (type: `integer`):

Maximum number of hotel records to emit.

## `currency` (type: `string`):

Optional currency code to request, for example USD or EUR.

## `language` (type: `string`):

Optional language/locale to request, for example en-us.

## `requestTimeoutSecs` (type: `integer`):

Timeout for each page request in seconds.

## `useApifyProxy` (type: `boolean`):

Route requests through the proxy configuration available in the actor run.

## `proxyGroups` (type: `array`):

Optional proxy groups to use when proxying is enabled.

## Actor input object example

```json
{
  "searchUrls": [],
  "hotelUrls": [],
  "locationQuery": "Paris",
  "adults": 2,
  "rooms": 1,
  "maxResults": 20,
  "requestTimeoutSecs": 30,
  "useApifyProxy": true,
  "proxyGroups": []
}
```

# Actor output Schema

## `hotels` (type: `string`):

Scraped hotel listings with name, price, rating, and dates.

## `fullData` (type: `string`):

All extracted fields including location, amenities, and images.

## `runSummary` (type: `string`):

Run status: record count, failures per URL, and verified modes.

# 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 = {
    "searchUrls": [],
    "hotelUrls": [],
    "locationQuery": "Paris",
    "maxResults": 20,
    "proxyGroups": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("automly/booking-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchUrls": [],
    "hotelUrls": [],
    "locationQuery": "Paris",
    "maxResults": 20,
    "proxyGroups": [],
}

# Run the Actor and wait for it to finish
run = client.actor("automly/booking-scraper").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 '{
  "searchUrls": [],
  "hotelUrls": [],
  "locationQuery": "Paris",
  "maxResults": 20,
  "proxyGroups": []
}' |
apify call automly/booking-scraper --silent --output-dataset

```

## MCP server setup

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

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/F7XcM6mM18UcSvYKH/builds/jPcGlZ0WYkZN6LWBE/openapi.json