🏨 Booking.com Hotel Scraper

A powerful Apify Actor that scrapes hotel listings from Booking.com search results. It performs HTML content tag-based data extraction in two stages:

1. Search Page — extracts property cards and queues detail URLs
2. Detail Page — extracts full description, amenities, and review data

---

✅ Use Cases

• 🔍 Scrape hotels in any city for a given date range and guest count
• 📊 Compare hotel prices, star ratings, and review scores
• 🏖️ Extract full amenity lists and property descriptions
• 📋 Build travel comparison datasets

---

📥 Input Configuration

{
  "startUrls": [
    {
      "url": "https://www.booking.com/searchresults.html?ss=Chennai&checkin=2026-02-18&checkout=2026-02-24&group_adults=2&no_rooms=1&group_children=0"
    }
  ],
  "ss": "Chennai",
  "checkin": "2026-02-18",
  "checkout": "2026-02-24",
  "group_adults": 2,
  "no_rooms": 1,
  "group_children": 0,
  "maxItems": 50,
  "scrollTimeout": 40,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  },
  "debugMode": false
}

🧾 Fields Explained

Field	Type	Description
startUrls	array	Booking.com search result URLs. If provided, individual parameters below are ignored.
ss	string	Destination city (e.g. "Chennai"). Used when no startUrls are provided.
checkin	string	Check-in date in YYYY-MM-DD format
checkout	string	Check-out date in YYYY-MM-DD format
group_adults	integer	Number of adult guests
no_rooms	integer	Number of rooms required
group_children	integer	Number of child guests
maxItems	integer	Maximum number of hotel detail pages to scrape
scrollTimeout	integer	Seconds to scroll the search page to load more results
proxy	object	Proxy configuration
debugMode	boolean	Save debug screenshots and verbose logs

---

🔗 URL Structure

The scraper supports direct Booking.com search URLs:

https://www.booking.com/searchresults.html?ss=Chennai&checkin=2026-02-18&checkout=2026-02-24&group_adults=2&no_rooms=1&group_children=0

Parameter	Description
ss	Destination / city name
checkin	Check-in date
checkout	Check-out date
group_adults	Number of adults
no_rooms	Number of rooms
group_children	Number of children

---

📤 Output

Each record saved to the dataset contains:

{
  "dataType": "hotel",
  "hotel_name": "The Leela Palace Chennai",
  "location": "MRC Nagar, Chennai",
  "price_per_night": "₹ 110,860",
  "rating": 5,
  "review_score": 9.1,
  "review_label": "Rated superb",
  "review_count": "2,265 reviews",
  "description": "Nestled along the Coromandel Coast...",
  "amenities": [
    "Free Wi-Fi",
    "Swimming Pool",
    "Spa",
    "Fitness Center",
    "Restaurant"
  ],
  "thumbnail": "https://cf.bstatic.com/...",
  "hotel_url": "https://www.booking.com/hotel/in/leela-palace-chennai.html",
  "scrapedAt": "2026-02-19T10:00:00.000Z"
}

📋 Output Schema

Field	Type	Description
dataType	string	Always "hotel"
hotel_name	string	Hotel / property name
location	string	Address or area
price_per_night	string	Displayed nightly price with currency
rating	integer	Star rating (1–5), counted from SVG icons
review_score	number	Guest review score (e.g. 9.1)
review_label	string	Textual rating (e.g. "Rated superb")
review_count	string	Number of reviews (e.g. "2,265 reviews")
description	string	Full property description
amenities	array	List of facilities
thumbnail	string	Thumbnail image URL
hotel_url	string	Booking.com hotel detail page URL
scrapedAt	string	ISO 8601 scrape timestamp

---

🔒 Proxy Configuration

{
  "useApifyProxy": true,
  "apifyProxyGroups": ["RESIDENTIAL"]
}

Residential proxies are recommended to avoid Booking.com's anti-bot measures.

---

🛠️ Tech Stack

• 🧩 Apify SDK — actor and dataset handling
• 🕷️ Crawlee — crawling and request queue management
• 🌐 Puppeteer — headless browser automation
• ⚙️ Node.js — fast, scalable backend