# Booking.com Hotel Price Scraper (`galdrcode_dev/booking-hotel-price-scraper`) Actor

Scrape hotel prices, ratings, and availability from Booking.com search results. Get flat, analysis-ready data with price per night, discounts, cancellation policy, meal plan, and Genius deals. Supports currency selection and geo-pricing via proxy country.

- **URL**: https://apify.com/galdrcode\_dev/booking-hotel-price-scraper.md
- **Developed by:** [Galdrcode](https://apify.com/galdrcode_dev) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 hotel results

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?

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

## Booking.com Hotel Price Scraper

Scrape **hotel pricing data** from Booking.com search results. Returns flat, analysis-ready rows — one per hotel — with price, ratings, cancellation policy, meal plan, and deal indicators.

Perfect for hotel price monitoring, competitive analysis, revenue management, and travel market research.

### What data do you get?

Each result row contains **one hotel listing** for your selected dates and guests:

| Field | Example |
|---|---|
| Hotel name, stars, review score | Hilton Dubai Creek, 5★, 8.6/10 |
| Review count | 4,521 reviews |
| Price per night & total | $178.59 / $357.17 |
| Original price & discount | $420.00 → 15% off |
| Currency | USD, EUR, GBP, AED, etc. |
| Meal plan | Breakfast Included, Room Only |
| Free cancellation | Yes / No |
| Refundable | Yes / No |
| Genius rate | Yes / No |
| Sold out | Yes / No |
| Hotel location & coordinates | Dubai, 25.25°N 55.33°E |
| Hotel URL | Direct link to Booking.com page |
| Scrape timestamp | 2026-09-06T12:00:00Z |

**Flat CSV/Excel-ready format.** No nested JSON to wrangle.

### Why this scraper?

- **Fast & reliable**: Uses Booking.com's internal search API directly — no fragile HTML parsing.
- **Flat output**: One row per hotel. Drop it into Excel, Google Sheets, or your BI tool — no post-processing needed.
- **Geo-pricing support**: Change the proxy country to compare prices as seen from different markets.
- **Currency control**: Set your preferred currency (USD, EUR, GBP, AED, etc.) in the input.
- **Scalable**: Scrape 25 hotels per page with automatic pagination. Set max results or scrape entire destinations.
- **Deal detection**: Spot Genius rates, discounted prices, and free cancellation offers programmatically.

### How to use

#### Option 1: Search URLs

Paste a Booking.com search URL (with your destination, dates, and guest count):

```
https://www.booking.com/searchresults.html?ss=Dubai&checkin=2026-10-01&checkout=2026-10-03&group_adults=2&no_rooms=1
```

The scraper extracts all hotels from the search results with their pricing.

#### Option 2: Direct Hotel URLs

Paste one or more hotel page URLs:

```
https://www.booking.com/hotel/ae/hilton-dubai-creek.html
```

#### Override search parameters

You can override check-in/check-out dates, number of adults, rooms, and currency in the input settings. These override any values in the URLs.

### Input parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| Search URLs | URL list | — | Booking.com search result pages |
| Hotel URLs | URL list | — | Direct hotel page URLs |
| Check-in Date | YYYY-MM-DD | Tomorrow | Override check-in date |
| Check-out Date | YYYY-MM-DD | Day after | Override check-out date |
| Adults | Integer | 2 | Guests per room |
| Rooms | Integer | 1 | Number of rooms |
| Currency | String | USD | Price currency (USD, EUR, GBP, AED, etc.) |
| Max Hotels | Integer | 50 | Limit hotels scraped (0 = unlimited) |
| Proxy | Object | Residential | Proxy configuration |

### Output example

```json
{
    "hotelId": "12345",
    "hotelName": "Hilton Dubai Creek",
    "stars": 5,
    "reviewScore": 8.6,
    "reviewCount": 4521,
    "checkIn": "2026-10-01",
    "checkOut": "2026-10-03",
    "nights": 2,
    "pricePerNight": 178.59,
    "priceTotal": 357.17,
    "currency": "USD",
    "taxIncluded": true,
    "mealPlan": "Room Only",
    "isBreakfastIncluded": false,
    "freeCancellation": true,
    "isRefundable": true,
    "isGeniusRate": false,
    "isSoldOut": false,
    "latitude": 25.2532,
    "longitude": 55.3311,
    "address": "Baniyas Road, Deira",
    "city": "Dubai",
    "country": "AE",
    "hotelUrl": "https://www.booking.com/hotel/ae/hilton-dubai-creek.html",
    "scrapeTimestamp": "2026-09-06T12:00:00+00:00"
}
```

### Use cases

- **Hotel price monitoring**: Track rates over time for revenue management
- **Competitive analysis**: Compare pricing across hotels in a destination
- **Travel market research**: Analyze pricing trends, demand patterns, and seasonal rates
- **Deal detection**: Find discounted rates and Genius deals programmatically
- **Geo-pricing analysis**: Compare what travelers from different countries pay for the same hotel

### Tips for best results

1. **Use residential proxies** — Booking.com blocks datacenter IPs. The default proxy config uses Apify residential proxies.
2. **Set realistic dates** — Use future dates; prices and availability are date-dependent.
3. **Geo-pricing**: Change your proxy country in settings to see location-specific prices.
4. **Currency**: Set the currency input to get prices in your preferred currency (USD, EUR, AED, etc.)

### Pricing

This actor uses pay-per-event pricing:

- **Per result**: $0.003 (= $3.00 per 1,000 hotels)
- **Per actor start**: $0.005

### Legal & compliance

This actor scrapes publicly available data from Booking.com. Users are responsible for ensuring their use complies with applicable laws and Booking.com's terms of service. The actor does not bypass any authentication or access restricted content.

# Actor input Schema

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

Booking.com search result page URLs. The actor will extract all hotels from these pages with their pricing.

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

Direct Booking.com hotel page URLs for individual hotel scraping.

## `checkIn` (type: `string`):

Override check-in date (YYYY-MM-DD). If empty, uses dates from the URL or defaults to tomorrow.

## `checkOut` (type: `string`):

Override check-out date (YYYY-MM-DD). If empty, uses dates from the URL or defaults to day after tomorrow.

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

Number of adults per room.

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

Number of rooms.

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

Currency for prices (e.g. USD, EUR, GBP, AED). Defaults to USD.

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

Maximum number of hotels to scrape. 0 = unlimited.

## `proxyConfiguration` (type: `object`):

Proxy settings. Residential proxies recommended for Booking.com.

## Actor input object example

```json
{
  "searchUrls": [
    {
      "url": "https://www.booking.com/searchresults.html?ss=Dubai&checkin=2026-10-01&checkout=2026-10-03&group_adults=2&no_rooms=1"
    }
  ],
  "hotelUrls": [],
  "adults": 2,
  "rooms": 1,
  "currency": "USD",
  "maxResults": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset containing one row per room option per hotel.

# 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": [
        {
            "url": "https://www.booking.com/searchresults.html?ss=Dubai&checkin=2026-10-01&checkout=2026-10-03&group_adults=2&no_rooms=1"
        }
    ],
    "hotelUrls": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("galdrcode_dev/booking-hotel-price-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": [{ "url": "https://www.booking.com/searchresults.html?ss=Dubai&checkin=2026-10-01&checkout=2026-10-03&group_adults=2&no_rooms=1" }],
    "hotelUrls": [],
}

# Run the Actor and wait for it to finish
run = client.actor("galdrcode_dev/booking-hotel-price-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": [
    {
      "url": "https://www.booking.com/searchresults.html?ss=Dubai&checkin=2026-10-01&checkout=2026-10-03&group_adults=2&no_rooms=1"
    }
  ],
  "hotelUrls": []
}' |
apify call galdrcode_dev/booking-hotel-price-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,galdrcode_dev/booking-hotel-price-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/IovaagVzYDA5ZioYC/builds/q0R9Sd301SMgtp2fp/openapi.json