Playground Sign in Start free
Travel · booking.com

How to scrape Booking.com

Booking.com (booking.com) is a travel booking site. This guide is built from our own checks of its public pages: what the pages contain, whether our requests get through right now, and the request settings that worked.

Intermittent

8 of 21 of our checks passed in the last 7 days (38.1%).

Last check 2026-10-13 16:07 UTC · last pass 2026-10-13 16:07 UTC · checked with our own requests, never customer data.

Try it in the Playground

Run the code on this page with your own key: 5,000 free credits for 7 days, no card. Get a free API key →

Extraction recipe

Detail pages carry structured data (Hotel). You can read those fields straight from the HTML, or select any other field with extract rules (CSS selectors). The recipe below is a set of Scrape API extract rules: we ran it through our API on two real Booking.com pages with the settings on this page and kept only the fields that came back on both. It is checked again every week, and hidden if it stops working.

Search and listing pages

Validated 2026-10-13
FieldTypeExample
listingslist of 3+ items
listings[].urlURLhttps://www.booking.com/hotel/us/warren-street-new-york.html?aid=30...
listings[].titletextWarren Street Hotel
listings[].imageimage URLhttps://cf.bstatic.com/xdata/images/hotel/270x200/635273380.jpg?k=1...
listings[].ratingnumber (as text)9.6
listings[].review_counttext· 78 reviews

Examples from www.booking.com/city/us/new-york.html on 2026-10-13, shortened.

Sample output (real, trimmed)

{
    "listings": [
        {
            "url": "https://www.booking.com/hotel/us/warren-street-new-york.html?aid=304142&label=gen173nr-10CAMo7AE4gANIM1gEaJUCiAEBmAEzuAEHyAEM2AED6AEB-AEBiAIBqAIBuAKI_7jWBsAC...",
            "title": "Warren Street Hotel",
            "image": "https://cf.bstatic.com/xdata/images/hotel/270x200/635273380.jpg?k=163d2a6078b24ddb4071a74bfddb446ced0520406709c8b1c4eb7aacf6af3f63&o=",
            "rating": "9.6",
            "review_count": "· 78 reviews"
        },
        {
            "url": "https://www.booking.com/hotel/us/the-wallace-new-york.html?aid=304142&label=gen173nr-10CAMo7AE4gANIM1gEaJUCiAEBmAEzuAEHyAEM2AED6AEB-AEBiAIBqAIBuAKI_7jWBsACAd...",
            "title": "The Wallace Hotel",
            "image": "https://cf.bstatic.com/xdata/images/hotel/270x200/311478002.jpg?k=3152a579112c1288c83d22a1b9cbad7d2077809f7a00066e37ef3a8580eba2be&o=",
            "rating": "9.3",
            "review_count": "· 1,085 reviews"
        },
        {
            "url": "https://www.booking.com/hotel/us/e-suites-new-york-new-york-new-york.html?aid=304142&label=gen173nr-10CAMo7AE4gANIM1gEaJUCiAEBmAEzuAEHyAEM2AED6AEB-AEBiAIBqAI...",
            "title": "Conrad New York Downtown",
            "image": "https://cf.bstatic.com/xdata/images/hotel/270x200/921050818.jpg?k=d8323f3812a376869521b88000d8d0716f04c348d76c6abce67a9042e63e18db&o=",
            "rating": "9.1",
            "review_count": "· 559 reviews"
        }
    ]
}
extract_rules (1 rule)
{
    "listings": {
        "selector": "div[data-testid=\"hotel\"]",
        "type": "obj",
        "multiple": true,
        "children": {
            "url": {
                "selector": "a[data-testid=\"hotelLink\"]",
                "type": "link"
            },
            "title": {
                "selector": "h3",
                "type": "text"
            },
            "image": {
                "selector": "img.f6c12c77eb",
                "type": "image"
            },
            "rating": {
                "selector": "div.fff1944c52.dff2e52086",
                "type": "text"
            },
            "review_count": {
                "selector": "div.aa225776f2 span.eaa8455879",
                "type": "text"
            }
        }
    }
}

Property pages

Validated 2026-10-13
FieldTypeExample
place.countrytextUS
place.imageimage URLhttps://cf.bstatic.com/xdata/images/hotel/max500/485684506.jpg?k=aa...
place.nametextDoubletree By Hilton New York Times Square West
place.postal_codetextNY 10018
place.ratingnumber7.1
place.regiontextNew York State
place.review_countnumber9879
place.streettext350 West 40th Street, Hell's Kitchen, New York, NY 10018, United St...
descriptiontextThe DoubleTree by Hilton Hotel New York – Times Square West is with...
urlURLhttps://www.booking.com/hotel/us/doubletree-by-hilton-new-york-time...

Examples from www.booking.com/hotel/us/doubletree-by-hilton-new-york-times... on 2026-10-13, shortened.

Sample output (real, trimmed)

{
    "place": {
        "country": "US",
        "image": "https://cf.bstatic.com/xdata/images/hotel/max500/485684506.jpg?k=aa6b48a0a762d1d5265a42a24c9da901d9a85121968fbf151b46441078f3a5be&o=&hp=1",
        "name": "Doubletree By Hilton New York Times Square West",
        "postal_code": "NY 10018",
        "rating": 7.1,
        "region": "New York State",
        "review_count": 9879,
        "street": "350 West 40th Street, Hell's Kitchen, New York, NY 10018, United States"
    },
    "description": "The DoubleTree by Hilton Hotel New York – Times Square West is within 0.9 mi of Times Square",
    "url": "https://www.booking.com/hotel/us/doubletree-by-hilton-new-york-times-square-west.html"
}
extract_rules (3 rules)
{
    "place": {
        "type": "fn",
        "fn": "const T = ['Hotel', 'LodgingBusiness', 'Restaurant', 'FoodEstablishment', 'LocalBusiness', 'Store', 'TouristAttraction', 'Resort', 'Motel', 'BedAndBreakfast', 'CafeOrCoffeeShop']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { country: all(g('address.addressCountry.name|address.addressCountry')), image: one(g('image.url|image')), name: all(g('name')), postal_code: all(g('address.postalCode')), rating: all(g('aggregateRating.ratingValue')), region: all(g('address.addressRegion')), review_count: all(g('aggregateRating.reviewCount|aggregateRating.ratingCount')), street: all(g('address.streetAddress')) };"
    },
    "description": {
        "selector": "meta[property=\"og:description\"]",
        "type": "attr",
        "attribute": "content"
    },
    "url": {
        "selector": "link[rel=\"canonical\"]",
        "type": "attr",
        "attribute": "href"
    }
}

Code

Complete scripts: set the UJEEBU_API_KEY environment variable and run them as they are. Each one sends the settings on this page and the extraction recipe, prints the extracted JSON, and prints the credits the request cost (the Ujb-Credits response header) on stderr. A non-200 answer stops the script with the API's error message.

Search and listing pages

Runs the recipe on the two pages it was validated on, one after the other.

booking_listing_sdk.py pip install ujeebu-python==0.1.5
# Scrape Booking.com search and listing pages with the Ujeebu Scrape API.
# Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 booking_listing_sdk.py

import json
import os
import sys
import time

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
    "https://www.booking.com/city/us/new-york.html",
    "https://www.booking.com/city/es/barcelona.html",
]
SETTINGS = {
    "js": True,
}
EXTRACT_RULES = {
    "listings": {
        "selector": "div[data-testid=\"hotel\"]",
        "type": "obj",
        "multiple": True,
        "children": {
            "url": {
                "selector": "a[data-testid=\"hotelLink\"]",
                "type": "link",
            },
            "title": {
                "selector": "h3",
                "type": "text",
            },
            "image": {
                "selector": "img.f6c12c77eb",
                "type": "image",
            },
            "rating": {
                "selector": "div.fff1944c52.dff2e52086",
                "type": "text",
            },
            "review_count": {
                "selector": "div.aa225776f2 span.eaa8455879",
                "type": "text",
            },
        },
    },
}


def scrape(client, url):
    # with extract_rules, client.scrape sends a JSON POST and the API answers {"result": {...}}
    try:
        response = client.scrape(url, params={**SETTINGS, "extract_rules": EXTRACT_RULES})
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}", file=sys.stderr)
    return response.json()["result"]


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for i, url in enumerate(URLS):
    if i:
        time.sleep(2)  # be polite: one page at a time
    print(json.dumps(scrape(client, url), indent=2, ensure_ascii=False))

Property pages

Runs the recipe on the two pages it was validated on, one after the other.

booking_detail_sdk.py pip install ujeebu-python==0.1.5
# Scrape Booking.com property pages with the Ujeebu Scrape API.
# Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 booking_detail_sdk.py

import json
import os
import sys
import time

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
    "https://www.booking.com/hotel/us/doubletree-by-hilton-new-york-times-square-west.html",
    "https://www.booking.com/hotel/us/casablanca.html",
]
SETTINGS = {
    "js": True,
}
EXTRACT_RULES = {
    "place": {
        "type": "fn",
        "fn": "const T = ['Hotel', 'LodgingBusiness', 'Restaurant', 'FoodEstablishment', 'LocalBusiness', 'Store', 'TouristAttraction', 'Resort', 'Motel', 'BedAndBreakfast', 'CafeOrCoffeeShop']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { country: all(g('address.addressCountry.name|address.addressCountry')), image: one(g('image.url|image')), name: all(g('name')), postal_code: all(g('address.postalCode')), rating: all(g('aggregateRating.ratingValue')), region: all(g('address.addressRegion')), review_count: all(g('aggregateRating.reviewCount|aggregateRating.ratingCount')), street: all(g('address.streetAddress')) };",
    },
    "description": {
        "selector": "meta[property=\"og:description\"]",
        "type": "attr",
        "attribute": "content",
    },
    "url": {
        "selector": "link[rel=\"canonical\"]",
        "type": "attr",
        "attribute": "href",
    },
}


def scrape(client, url):
    # with extract_rules, client.scrape sends a JSON POST and the API answers {"result": {...}}
    try:
        response = client.scrape(url, params={**SETTINGS, "extract_rules": EXTRACT_RULES})
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}", file=sys.stderr)
    return response.json()["result"]


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for i, url in enumerate(URLS):
    if i:
        time.sleep(2)  # be polite: one page at a time
    print(json.dumps(scrape(client, url), indent=2, ensure_ascii=False))

SDK tabs use the official Ujeebu SDKs (ujeebu-python 0.1.5, @ujeebu-org/ujeebu-sdk 0.1.2, github.com/ujeebu/ujeebu-go v0.1.8); there is no PHP SDK, so the PHP tab calls the API with curl. For agents and scripts, the same status and settings are at /scrape/booking.json.

Try it yourself

Run this on Booking.com with your own key

Get a free API key, set UJEEBU_API_KEY and run any script above as it is. 5,000 free credits for 7 days, no card.

URL patterns and pagination

What the URLs look like, read from the pages our checks fetched.

Search and listing pages

Pattern
https://www.booking.com/city/{slug}/{slug}.html
Next pages
We did not see a next-page link on the pages we fetched. Results may load as you scroll: try scroll_down.
Validated on
https://www.booking.com/city/us/new-york.htmlhttps://www.booking.com/city/es/barcelona.html

Property pages

Pattern
https://www.booking.com/hotel/us/{slug}.html
Validated on
https://www.booking.com/hotel/us/doubletree-by-hilton-new-york-times-square-west.htmlhttps://www.booking.com/hotel/us/casablanca.html

Settings that work today

From our health checks over the last 7 days: the cheapest settings that return the real page most of the time.

Endpoint/scrape
jstrue
wait_for8000
Costup to 5 credits a request (only HTTP 200 and 404 are billed)
Learnedjs + wait 8000 (found by our retry layer)

Collect detail page URLs from listing pages first, then fetch each detail page. Our checks pass with JavaScript rendering on (js=true) and a wait of 8 seconds (wait_for=8000) before the snapshot: keep both. Start with the default (rotating) proxy, the cheapest one that passed most of its attempts in our checks.

Try it in the Playground
ProxyAttemptsPassed
Default (rotating)76

The cheapest proxy that passes most of our checks of this site.

Troubleshooting

The failures our own checks of booking.com ran into over the last 7 days, and what got the page in the same check.

What happenedTimesWhat fixed it
An empty page 1 None of the settings we tried got past it in 7 days.
The page did not load in time 1 Nothing we tried in the same check. Retry later, one request at a time.
A different page than expected 1 A retry with wait_for=8000 got the page (1 of 1).

A failed request is not billed: only HTTP 200 and 404 responses cost credits.

What people build with Booking.com data

  • Ratings benchmarksCompare ratings and review counts across properties.More on this use case
  • Inventory trackingSee which properties are listed for a destination and how that changes.

Limits and etiquette

  • Public pages only. Pages behind a login, and data shown only to signed-in users, are out of scope.
  • Keep the rate modest: fetch pages one after another or with low concurrency, and cache what you already have.
  • robots.txt of www.booking.com (read 2026-10-13): public pages allowed for generic crawlers; no crawl delay set.
  • Read Booking.com's terms of service before you collect data at scale, and do not collect personal data you have no basis to process. This guide is not legal advice.

Questions

Can you scrape Booking.com with Ujeebu?

Partly. 8 of 21 checks of public Booking.com pages passed in the last 7 days; most failures were the page did not load in time. Retry failed pages later, and use the settings on this page.

Which settings work for Booking.com?

Call /scrape with js=true, wait_for=8000. On the default (rotating) proxy, 6 of 7 attempts passed in the last 7 days. Our retry layer found that this site needs "js + wait 8000".

How many credits does a Booking.com request cost?

With these settings a request costs up to 5 credits. Only responses with HTTP 200 or 404 are billed: a blocked or timed-out request is free.

Which fields can I extract from Booking.com?

With the extraction recipes on this page, validated on real Booking.com pages through our API: search and listing pages: url, title, image, rating, review_count; property pages: country, image, name, postal_code, rating, region, review_count, street, description, url. Pass the recipe as extract_rules in a POST to /scrape and the API returns those fields as JSON.

Is it allowed to scrape Booking.com?

Its robots.txt allows generic crawlers on the page types in this guide. Collect public pages only, read Booking.com's terms of service, keep your request rate modest and do not collect personal data you have no basis to process. This is not legal advice.

How fresh is this page?

The status and settings come from our own health checks of booking.com, which run around the clock. Last check: 2026-10-13 16:07:45 UTC; last pass: 2026-10-13 16:07:45 UTC.