Booking.com Hotel Scraper – Prices, Room Rates & Reviews
Pricing
from $2.54 / 1,000 search results
Scrape Booking.com hotel prices, room rates and availability via the mobile API. Full per-room rate table with itemised taxes and fees, family pricing by child age, guest reviews and property details — one actor, not four. Search by destination, GPS radius or hotel id. No API key needed.
Record type
recordType
Optional
Which kind of row this is. Absent on property rows (search, rooms, details, surroundings, reviews, reviewScores); "rate" in mode rates; "attraction", "attractionDetail" or "attractionAvailability" in the attractions modes. One dataset can hold several kinds, so filter on this before reading kind-specific columns.
Property ID
id
Optional
Booking's own numeric property id, stable across runs and the key to join enrichment rows back onto a search row.
Name
name
Optional
Property name on a property row; the attraction name on an attraction row.
Accommodation type
accommodationType
Optional
Booking's own label for the property type.
Accommodation type ID
accommodationTypeId
Optional
Booking's numeric type id; the same vocabulary the accommodationTypes input takes.
Star rating
starRating
Optional
Stars, 1-5, or null. It does not say whether the stars are official. Booking awards some properties an official classification and lets others self-estimate one; the mobile surface returns symbol "STARS" for both, so a 3 here may be official or self-assessed. Null is common and legitimate - hostels and many apartments carry no rating.
Address
address
Optional
Street line as the mobile API returns it. The product's own street address, when Booking publishes one: filled on 5 of 12 rows measured. A tour or transfer usually has no fixed address and returns null; a ticketed venue usually has one.
Formatted address
formattedAddress
Optional
The full one-line address the web property page prints (street, district, postcode, city, country). Needs Include details.
City
city
Optional
City name.
District
district
Optional
Booking's district for the property. Only populated when Include details is on - it is filled by a backfill from the details surface, not by search.
Country code
countryCode
Optional
Two-letter country code, lowercase.
Postal code
postalCode
Optional
Postal code where the property states one. The product's own postcode, when published: 4 of 12 rows measured.
Latitude
latitude
Optional
The property's own latitude on a property row. On an ATTRACTION row this is the destination's centroid, not the attraction's - every attraction in a city returns the same pair. On an attractionDetails row this is the PRODUCT's own latitude, filled on 6 of 12 rows measured - a tour often has none. The destination centroid is cityLatitude, always present. Coerced to a number: the upstream sends it as a string on some products.
Longitude
longitude
Optional
As latitude: the property's own on a property row, the destination's centroid on an attraction row.
UFI
ufi
Optional
Booking's numeric destination id for the city or area.
URL
url
Optional
Web page for the property or attraction. Populated on search, hotel_ids, rooms and details rows; absent on reviews, reviewScores and surroundings rows, which carry only the id, the stay and what you asked for - join those back on id.
Deep link
deep_link_url
Optional
A booking:// URI that opens the property in the Booking app. Not an http URL, so it will not open in a browser.
Main photo
mainPhotoUrl
Optional
One hi-res photo, on every search row, at no extra request or charge. The full gallery is details.photos and needs mode: "details".
Check-in
checkin
Optional
Stay start, yyyy-mm-dd, echoed from the input.
Check-out
checkout
Optional
Stay end, yyyy-mm-dd, echoed from the input.
Currency
currency
Optional
ISO 4217 code every money figure on the row is in.
Adults
adults
Optional
Adults the rate was priced for (rates mode).
Rooms requested
roomsRequested
Optional
Rooms the rate was priced for (rates mode). Named roomsRequested and not "rooms" because rooms is the room-type list on every other row kind.
Price
price
Optional
On a property row, the price object: base, book/total, per_night and extra_charges. On a rate or attraction row, a plain number. Read total_with_charges to match what the buyer is shown - it is right on every path, which total is not. Where Booking excludes taxes from its display price, total understates: measured on a search row, display EUR 246.28 with EUR 82.50 of excluded charges beside it. Where the taxes are already inside gross_amount, the two are the same number and both match the screen: measured on a room-list rate, MYR 151 on the app's price sheet against MYR 151.305 on the wire. discount_percent is not Booking's badge: it is computed from Booking's own figures and moves with the point of sale, so use it to rank savings within a run rather than to reproduce what a browser shows.
Price with charges
priceWithCharges
Optional
Rates mode: the all-in amount for the watched rate. The one to diff between runs, not price.
Price per night
pricePerNight
Optional
Rates mode: price divided by nights.
Price before discount
priceBeforeDiscount
Optional
Attractions: the pre-discount price where one is stated.
Refundability premium
refundabilityPremium
Optional
What a refundable rate costs over the cheapest non-refundable one at the same property. Needs Include rooms.
Availability
availability
Optional
Why a property has no price, when it has none: sold out, minimum stay not met (with the nights required), closed, or an unknown id. A property row always comes back even when it cannot be priced.
Status
status
Optional
Rates mode: "available", "not_offered" or "lookup_failed" - the last means we could not ask, the middle means Booking answered and the rate is not on sale. attractionAvailability mode: null means dates were bookable inside your window; no_availability_in_window is the real negative - days were checked and none were bookable; window_outside_calendar means the attraction is real but your window falls outside the span Booking publishes, so nothing was checked at all and calendarFrom/calendarTo give that span; not_found means the id resolved to nothing. That last one is INFERRED rather than reported: Booking answers an unknown id with a successful but empty calendar rather than an error, so an empty calendar is the discriminator - and it also covers an attraction withdrawn from sale. Telling the three negatives apart matters, because only the middle one means the attraction has no dates for you.
Available
available
Optional
Rates mode: true when status is "available".
Reason
reason
Optional
Rates mode: why a watched rate is not available, in words.
Error
error
Optional
Attractions modes: the upstream message when an id could not be looked up.
Review score
reviewScore
Optional
Booking's guest score, 0-10.
Score word
reviewScoreWord
Optional
Booking's own label for the score.
Reviews
reviewsCount
Optional
How many guest reviews the score is based on.
Reviews
reviews
Optional
Guest reviews: author, score, pros, cons, date. Needs Include reviews, and the count is capped by reviewsMax in mode reviews or maxReviews on search.
Review subscores
reviewSubscores
Optional
Per-category scores - staff, cleanliness, location, value, comfort, facilities, wifi. One request per property however many reviews you fetch.
Review summary
reviewSummary
Optional
Booking's aggregated review summary, including its AI summary where one exists.
Room types
rooms
Optional
One entry per room type with availability on your dates - not the property's whole catalogue, which is usually larger. Occupancy, bed layout, bedrooms, bathrooms, size, photos and child policy. bedCount counts beds, not sleeping places: a bunk counts once and sleeps two, so a "14-Bed Private Room" can report 7. Use maxOccupancy for capacity, and note that is the largest occupancy Booking offers your party rather than the room's own. areas[] says which room each bed is in for apartment-like units (bedroom, living room, each with its own beds, sleeps and en-suite flag), with hasLivingRoom beside bedroomCount; null on ordinary hotel rooms, which publish no layout. areas[] places beds, it does not inventory rooms: two entries of the same type can describe one room (measured against Booking's own room summary, counting them overstates living rooms on 2 of 14 units), which is why hasLivingRoom is a flag and not a count. areas[].beds[] and bedLayouts are the same beds from different angles, so summing across both double-counts - bedCount stays the one number to trust.
Rates
products
Optional
One entry per bookable rate: price, board, cancellation, payment terms, occupancy and how many are left at that price. Needs Include rooms. price.currency says which currency price.total and its siblings are in - read it rather than assuming the row's, because the two can differ: the total falls back to Booking's gross_amount_hotel_currency when the ordinary amount is absent, and that one is the property's own. Four nested keys are read wrong often enough to name here. policies.payment.noPrepayment means "nothing due today", not "nothing due ever" - true both for settle-at-the-property rates and for ones that take the full amount on a date before arrival; read prepaymentPolicy to tell them apart. amountDueNow is null, not 0, when the rate states no payment stage (198 of 688 sampled blocks), so reading null as 0 turns every one into a false "pays nothing at booking". dueDate is not the cancellation deadline - it is when payment falls due, and across 48 comparable rates it is always the earlier of the two. policies.meal_plan.plan only describes what is included: offers[] carries the meals that can be bought with the rate (status included / available_for_fee, with the price and its own currency), breakfastAvailableForFee flags the common case, and summary is Booking's own wording, localised and rounded.
Product ID
productId
Optional
Rates mode: the watched rate. Shaped room_id_rateplan_occupancy_board_0, and only meaningful together with the stay it came from - the id encodes no dates.
Hotel ID
hotelId
Optional
Rates mode: the property the watched rate belongs to, derived from the product id.
Room
roomName
Optional
Rates mode: the room type the rate sells.
Scraped at
scrapedAt
Optional
When the response that produced this row came back - the PRICED response where the row has a price, not when the row was pushed, which is batched and later by seconds to minutes. ISO-8601 UTC, to milliseconds. Note Booking's own date strings in the same row are NOT ISO (freeCancellationUntil is "2026-10-28 23:59:59 +0000"), so do not point one parser at both. Prices are fetched live - nothing in this Actor is cached or reused - so this is the age of the price, and a dataset read a week later does not refresh it.
Scraped at (epoch)
scrapedAtUnix
Optional
The same instant as scrapedAt, in epoch SECONDS, for consumers that diff timestamps arithmetically. Two keys rather than one selectable format, so a column's type never moves with a run setting and two datasets always join.
City latitude
cityLatitude
Optional
Latitude of the DESTINATION this attraction is listed under - the city centre, not the product. It comes from Booking's ufiDetails, beside the city name. Measured over 21 products in three cities: three distinct pairs, one per city. An attraction row's own coordinates are latitude/longitude on the attractionDetails row, which fill on about a third of products.
City longitude
cityLongitude
Optional
Longitude of the destination the attraction is listed under. See cityLatitude: this is the city centre, not the product.
Cancellation
cancellationType
Optional
free_cancellation, non_refundable or partially_refundable. partially_refundable means only part of the stay is charged after the deadline; those rates used to read as fully refundable, which overstated the refund.
Free cancellation until
freeCancellationUntil
Optional
When free cancellation ends. Not ISO-8601 - Booking returns "2026-10-28 23:59:59 +0000".
Prepayment policy
prepaymentPolicy
Optional
Booking's own policy string, passed through rather than mapped to a closed set. Observed: full_prepayment, partial_prepayment, no_prepayment_at_all, no_prepayment_until.
Payment timing
paymentTypes
Optional
When the guest pays: pay_now, pay_later and/or pay_at_property. Decided by the policy, not by any single flag.
Provenance
provenance
Optional
What produced this row's price: the proxy exit it was fetched through, the generation of that exit, the currency you asked for and the endpoint that priced it. The point of sale follows the proxy exit country, not any input - bookerCountry was removed in this build because nothing read it.
Meal plan
mealPlan
Optional
Board included in the rate. no_plan does not mean no breakfast: it means none is included, and 40% of blocks measured sell one for a fee - read breakfastAvailableForFee for that.
Breakfast for a fee
breakfastAvailableForFee
Optional
Whether breakfast can be bought with this rate but is not included in it. True on 145 of 366 blocks measured, every one of which mealPlan calls no_plan.
Breakfast price
breakfastPrice
Optional
What breakfast costs on top of this rate, as the property quotes it: a unit price per person per night, not a stay total (A/B'd invariant across 2 and 4 adults, 2 and 4 nights). Read it with breakfastCurrency, never with the row's currency. Null on the hotel_ids path, which publishes the offer but not the amount.
Breakfast currency
breakfastCurrency
Optional
The currency breakfastPrice is quoted in - the property's own, which can differ from the row's currency. A Cape Town property returns 120 ZAR on a run priced in EUR; pairing that amount with EUR overstates it twentyfold.
Payment terms
paymentTerms
Optional
Property-level requirements to book: model, cardRequired, cvcRequired, addressRequired, noCardNeeded, hostedPaymentPageOnly, requestToBookRequired. requestToBookRequired is about INSTANT booking, and it is null on most properties. Booking runs two models: Instant Booking, confirmed on the spot, and Request to Book, where the host has 24 hours to accept and the guest 24 more to finish, with the price held and the card pre-authorised rather than charged. Instant is the default, so the flag only appears on the vacation-rental segment where Request to Book is offered at all, and null there means the question does not apply rather than data missing.
Cot and extra bed policy
childAndBedPolicy
Optional
The property's cot and extra-bed rules by age band. Needs Include rooms.
Full rate
product
Optional
Rates mode: the whole rate object, for everything the hoisted columns omit.
Details
details
Optional
Static property content: description, fine print, check-in/out times, property type, district, languages, facilities, photos, host and trader information. Needs Include details, and is the whole content of mode: "details".
Free cancellation
freeCancellation
Optional
Whether a free-cancellation rate exists for the stay (property row) or the attraction is freely cancellable (attraction row).
Deal badges
dealBadges
Optional
Booking's own promotional badges for the stay.
Preferred
isPreferred
Optional
Booking's Preferred Partner flag.
Preferred Plus
isPreferredPlus
Optional
Booking's Preferred Plus flag.
Attraction ID
attractionId
Optional
Booking's attraction product id.
Slug
slug
Optional
URL slug for the attraction.
Short description
shortDescription
Optional
One-line description, and a CATALOGUE-row field: the attractions mode fills it (100 of 100 Rome products measured 2026-10-28) and the attractionDetails surface returns null for it (0 of 6 of those same products). Nothing is lost - a detail row carries the full, untruncated text in description, which on those products is the same prose the catalogue truncates into this column. Issue #58 reported it null on 5 of 5 detail rows and was right; a figure of 12 of 12 attractionDetails rows stood here until 2026-10-28 and had been measured on catalogue rows, so read description on a detail row and this column on a catalogue row.
Description
description
Optional
Full description, attractionDetails only.
Bookable
bookable
Optional
Whether the attraction can be booked.
Category
category
Optional
The attraction's taxonomy slug. Detail only.
Duration
durationLabel
Optional
Human-readable duration.
Duration (ISO-8601)
durationValue
Optional
Duration as an ISO-8601 period string, NOT a number of minutes - "PT10H" is ten hours. Parse it, do not cast it.
Reviews
reviewCount
Optional
Review count for the attraction.
Reviews on Booking
reviewCountOnPlatform
Optional
Reviews left on Booking itself.
Reviews (detail)
reviewTotal
Optional
Review total from the detail surface.
Review categories
reviewCategories
Optional
Per-category attraction scores.
Still refundable
stillRefundable
Optional
Whether it can still be cancelled now.
Cancellable until
cancellationUntil
Optional
ISO-8601 cancellation deadline.
Available from
availableFrom
Optional
First date the product is bookable.
Available dates
availableDates
Optional
Dates bookable in the window.
Offers
offerCount
Optional
How many offers the product has.
Country
country
Optional
Country of the destination.
Photo
image
Optional
Primary photo URL.
Photos
images
Optional
Photo URLs, attractionDetails only.
Flags
flags
Optional
Booking's own feature flags for the product.
Additional info
additionalInfo
Optional
Free text the operator adds, newline-joined into a single string on every product measured.
What's included
whatsIncluded
Optional
What's included for the attraction, attractionDetails only. Several of these are empty on every product measured - the upstream does not fill them.
Not included
notIncluded
Optional
Not included for the attraction, attractionDetails only. Several of these are empty on every product measured - the upstream does not fill them.
Selling points
uniqueSellingPoints
Optional
Selling points for the attraction, attractionDetails only. Several of these are empty on every product measured - the upstream does not fill them. Conditional on the product: filled on 4 of 12 rows measured across six cities.
Restrictions
restrictions
Optional
Restrictions for the attraction, attractionDetails only. Several of these are empty on every product measured - the upstream does not fill them. Conditional on the product: filled on 3 of 12 rows measured across six cities.
Highlights
highlights
Optional
Highlights for the attraction, attractionDetails only. Several of these are empty on every product measured - the upstream does not fill them.
Labels
labels
Optional
Labels for the attraction, attractionDetails only. Several of these are empty on every product measured - the upstream does not fill them.
Accessibility
accessibility
Optional
Accessibility for the attraction, attractionDetails only. Several of these are empty on every product measured - the upstream does not fill them.
Health and safety
healthSafety
Optional
Health and safety for the attraction, attractionDetails only. Several of these are empty on every product measured - the upstream does not fill them. Conditional on the product: filled on 4 of 12 rows measured across six cities.
Diet options
dietOptions
Optional
Diet options for the attraction, attractionDetails only. Several of these are empty on every product measured - the upstream does not fill them. Not observed filled on any product yet - 0 of 48 across seven cities. Kept rather than dropped because the upstream selects it and a food tour is the product type that would carry it; treat an empty value as 'this product does not state any', not as 'this column works'.
Guide languages
guideLanguages
Optional
Guide languages for the attraction, attractionDetails only. Several of these are empty on every product measured - the upstream does not fill them.
Audio guide languages
audioGuideLanguages
Optional
Audio guide languages for the attraction, attractionDetails only. Several of these are empty on every product measured - the upstream does not fill them. Conditional on the product: filled on 4 of 12 rows measured across six cities.
Offers
offers
Optional
Bookable offers with their availability type.
Operated by
operatedBy
Optional
Operator name.
Powered by
poweredBy
Optional
Platform behind the booking.
Address city
addressCity
Optional
City from the attraction address block. The product's own city, when published: 6 of 12 rows measured. Not the same as city, which is the DESTINATION the product is listed under and is always present.
Meeting point
meetingPoint
Optional
Where the guest meets the operator. Null on every product measured - the upstream returns addresses.meeting as null. Where the product starts, when Booking publishes it: 3 of 36 products measured. Mostly null even on tours.
Meeting instructions
meetingInstructions
Optional
Instructions for the meeting point. How to find the meeting point, when published. Null on every delivered row measured so far (0 of 12); seen only alongside a meetingPoint.
Terms
termsUrl
Optional
Operator terms URL.
Privacy policy
privacyPolicyUrl
Optional
Operator privacy policy URL.
Window start
windowStart
Optional
Start of the window you asked about.
Window end
windowEnd
Optional
End of the window you asked about.
Bookable in window
bookableInWindow
Optional
Whether any day in the window is bookable.
Available days
availableDayCount
Optional
Bookable days inside the window.
Days checked
daysChecked
Optional
Days of the calendar inside your window.
First available
firstAvailableDate
Optional
Earliest bookable day in the window.
Last available
lastAvailableDate
Optional
Latest bookable day in the window.
Calendar from
calendarFrom
Optional
First day Booking publishes for this product.
Calendar to
calendarTo
Optional
Last day Booking publishes for this product.
Timeslot dates fetched
timeslotDatesFetched
Optional
How many dates timeslots were fetched for, capped by attractionsTimeslotDays (default 3, maximum 14). Each one is a separate upstream request.
Timeslots
timeslots
Optional
Every timeslot on the fetched dates, with its offers, ticket types, prices and remaining inventory.
Mode
mode
Optional
The mode the row came from, echoed onto the row where the mode sets it.
Dates adjusted
datesAdjusted
Optional
True when the stay returned is not the stay asked for, because Booking moved it - read it before trusting checkin/checkout.
