Booking.com Hotels Scraper
Pricing
from $0.42 / 1,000 property saveds
Scrape Booking.com hotels by place and dates: prices, availability, property details, rooms and guest reviews. Export to JSON, CSV or Excel.
ID
id
Optional
Same value as propertyId: the key the Actor's engine saves and de-duplicates every row on (and the memory of Only new properties).
Property ID
propertyId
Required
Booking.com numeric property id.
Name
name
Required
Property name in the requested language.
Property URL
url
Required
Public Booking.com page of the property (English page; the language of the page is set by the link you open).
Booking URL with dates
bookingUrl
Optional
Property page with the stay in the link (checkin, checkout, group_adults, group_children, no_rooms, selected_currency): opens Booking.com on the price of this row.
Page name
pageName
Required
Last part of the property URL, without the language suffix.
Country code
countryCode
Required
Two-letter country code of the property, in lower case, as in the property URL.
Property type
propertyType
Optional
Type of property named as in the Property types input (hotel, apartment, holiday_home, villa, guesthouse, hostel, bed_and_breakfast...). null for a type the Actor has no name for: see propertyTypeId.
Property type ID
propertyTypeId
Optional
Booking.com id of the property type (ht_id: 204 hotel, 201 apartment, 220 vacation home, 213 villa...).
Star rating
starRating
Optional
Stars (1-5), or the quality rating Booking.com gives to homes (see starRatingType); null when the property has none.
Star rating type
starRatingType
Optional
stars = official star rating of a hotel; tiles = quality rating given by Booking.com to apartments and homes (not an official classification); circles = rating Booking.com shows as circles, not official stars. null with no rating.
Guest rating
rating
Optional
Guest score out of 10; null with no review.
Rating text
ratingText
Optional
Wording Booking.com puts on the guest score (Exceptional, Wonderful, Excellent, Very Good, Good...), in the requested language.
Review count
reviewCount
Optional
Number of guest reviews.
Rating breakdown
ratingBreakdown
Optional
Score per category out of 10: staff, services, cleanliness, comfort, valueForMoney, location, and when Booking.com has them freeWifi, breakfast, paidWifi. Search results give only one category (the one the site puts forward, usually location); every category comes with Extract full property profile.
Reviews behind each score
ratingBreakdownCounts
Optional
How many guest reviews stand behind each score of ratingBreakdown, under the same keys (staff, services, cleanliness, comfort, valueForMoney, location, and when the site has them freeWifi, breakfast, paidWifi). null when the profile was not read (profile, option extractDetails).
External rating
externalRating
Optional
Score of an outside review source that Booking.com shows next to its own (only some properties); out of 10.
External rating word
externalRatingText
Optional
The word Booking.com puts on externalRating (Wonderful, Excellent...), in the language of the run; null when the property has no outside review source or the site gives no word.
External review count
externalReviewCount
Optional
Number of reviews behind externalRating (only the properties that have an outside review source).
Price
price
Optional
Price of the recommended offer for the whole stay (all rooms), in currency, as Booking.com shows it: taxes and fees marked "included" are in it; taxesAndFeesExcluded is to pay on top. null when the property is sold out.
Currency
currency
Optional
Currency of price and of the other prices of the row (the Currency input).
Price per night
pricePerNight
Optional
price divided by the number of nights (Booking.com does not give it).
Price before discount
priceBeforeDiscount
Optional
Crossed-out price for the whole stay; null when the offer has no discount.
Discount (%)
discountPercent
Optional
Discount in percent: (priceBeforeDiscount - price) / priceBeforeDiscount, rounded to the unit; null when the offer has no discount.
Discounts
discounts
Optional
Discounts already taken off price: name (Late Escape Deal, Booking.com pays, Genius...) and amount for the whole stay. Empty when none.
[ { "name": "Late Escape Deal", "amount": 197.45 }, { "name": "Booking.com pays", "amount": 41.47 }]Taxes and fees to pay on top
taxesAndFeesExcluded
Optional
Total of the taxes and fees NOT included in price, to pay at the property (city tax...), for the whole stay; 0 when everything is included; null when Booking.com says that charges may apply without giving the amount (often the city tax per person: see priceNote) and when the offer is not priced.
Taxes and fees
taxesAndFees
Optional
Every tax and fee line Booking.com details for the offer: type (Booking.com charge code), mode (PER_PERSON_PER_NIGHT, PERCENTAGE...), included (true = already in price, false = to pay on top) and amount for the whole stay. Empty when Booking.com details none.
[ { "type": 22, "mode": "PER_PERSON_PER_NIGHT", "included": false, "amount": 33.8 }, { "type": 21, "mode": "PERCENTAGE", "included": true, "amount": 46.07 }]Price with all taxes
priceWithAllTaxes
Optional
price plus taxesAndFeesExcluded: what the stay costs in all; null when taxesAndFeesExcluded is null (charges may apply without an amount: see priceNote).
Price in the hotel currency
priceInHotelCurrency
Optional
The same price in the currency the property itself charges, when it differs from currency; null otherwise.
Hotel currency
hotelCurrency
Optional
Currency the property charges (with priceInHotelCurrency); null when it is the same as currency.
Price note
priceNote
Optional
Mention Booking.com puts under the price, in the requested language; null when it shows none.
Price before the change
previousPrice
Optional
Only with the price change report (needs Only new properties), on a property a previous run delivered that comes back because its price moved: the price per night that run delivered it at, for the same stay (same dates, guests, rooms and currency), in currency. Null on every other row.
Price change
priceChange
Optional
pricePerNight minus previousPrice, in currency (negative = cheaper). Null unless the property comes back because its price moved.
Price change (%)
priceChangePct
Optional
The change in percent of previousPrice, 2 decimals (negative = cheaper). Null unless the property comes back because its price moved.
Price change noticed at
priceChangedAt
Optional
ISO 8601 UTC: when this run noticed the change (the row's scrapedAt); Booking.com does not say when the price moved. Null unless the property comes back because its price moved. Charged as price-change.
Value score
valueScore
Optional
Only with the value score option: 0 to 100, higher = better value for the price, computed from this row's own fields (price per night against the median of the properties with a price on the same results page, rating, reviews, distance from the centre, cancellation, prepayment, discount). Null when the option is off, when the property has no price, or when its results page has fewer than 5 comparable properties. Charged as value-score.
Value score reasons
valueScoreReasons
Optional
The rules that counted in favour of the property, the strongest first: price-below-median, high-rating, many-reviews, central, best-location-area, free-cancellation, no-prepayment, discount. Null when valueScore is.
Value score checks skipped
valueScoreChecksSkipped
Optional
The rules that could not be judged because the card did not give the datum (same codes as valueScoreReasons); never counted against the property. Null when valueScore is.
Nearby properties
comparables
Optional
Only with the nearby properties option: the other properties priced for the same stay and currency, of the same kind (hotel with hotel, apartment with apartment...) and, when this property has stars, the same stars give or take one, within 2 km, the nearest first (at most Max neighbours per property). Each has its id, name, URL, distance in km from this property, type, stars, guest rating, number of reviews, price per night and currency. Chosen among the properties nearest to the centre of the 1 km area of the map this property is in. An empty list when none was found; null when the option is off, when the property has no position or type, or when the area could not be read. Charged as comparables once per property with at least one neighbour.
Nearby properties count
comparablesCount
Optional
How many neighbours comparables holds (0 when none was found). Null when comparables is.
Nearby properties median price per night
comparablesMedianPricePerNight
Optional
Median price per night of the neighbours in comparables, in the currency of the run, to the cent. Null when comparables is null or empty.
Available
isAvailable
Required
True when at least one room can be booked for the requested stay; false for a sold-out property (no price).
Closed
isClosed
Optional
True when Booking.com marks the property as closed.
Rooms left
roomsLeft
Optional
Rooms left at this price, as the site shows it ("We have 2 left at this price"); null when it shows no count.
Free cancellation
freeCancellation
Optional
True when the recommended offer can be cancelled free of charge.
Free cancellation until
freeCancellationUntil
Optional
Last moment of free cancellation of the recommended offer, ISO 8601 (UTC); null when it cannot be cancelled free.
No prepayment
noPrepayment
Optional
True when the recommended offer needs no prepayment (pay at the property).
Meal plan
mealPlan
Optional
Meals included in the recommended offer, as Booking.com words it in the requested language; null when none.
Recommended room
recommendedRoom
Optional
The room Booking.com puts forward for your guests: name, beds (number of beds), bedrooms, units (number of rooms of this type), bathrooms, kitchens and livingRooms (filled for homes and apartments, 0 for a hotel room), bedConfigurations (the bed choices offered: type = the bed, typeId = its Booking.com code, count), sizeM2 (size in square metres, mostly for whole homes), unitType (for example Entire apartment) and roomId (the same id as in roomOffers). null for a sold-out property.
Stay
stay
Required
The stay the prices were read for: checkIn, checkOut, nights, adults, children, childrenAges, rooms.
{ "checkIn": "2026-11-12", "checkOut": "2026-11-14", "nights": 2, "adults": 2, "children": 0, "childrenAges": [], "rooms": 1}Dates adjusted
datesAdjusted
Optional
True when Flexible dates let Booking.com price this property for other dates than the ones asked (the dates priced are in stay); false for the dates asked; null without Flexible dates.
Street address
address
Optional
Street and number, as Booking.com gives it.
Full address
formattedAddress
Optional
Full address in one line, with district, postal code and country (profile).
Postal code
postalCode
Optional
Postal code read from the full address when the format of the country is known; null otherwise, never guessed (profile).
District
district
Optional
Neighbourhood or district, as Booking.com names it.
Display location
displayLocation
Optional
District and city as the search result shows them, in the requested language.
City
city
Optional
City of the property.
Region
region
Optional
Region of the searched destination, as Booking.com names it in the search (Ile de France, Tuscany, New York State); null for a property page given by URL or id, or for a search of a whole country.
Country
country
Optional
Country name in the requested language, on every row (the name of countryCode in that language). null only for a code the system has no name for; the last part of the address of the full profile option is then used.
Latitude
latitude
Optional
Longitude
longitude
Optional
Distance from center (text)
distanceFromCenter
Optional
Distance to the center of the destination as Booking.com words it, in the requested language (miles with en-us). null for a property found in a map area of a search of more than 1,000 properties (Booking.com gives no centre there).
Distance from center (km)
distanceFromCenterKm
Optional
distanceFromCenter converted to kilometres, whatever the language. null when distanceFromCenter is.
Distance to the beach (text)
beachDistance
Optional
Distance to the nearest beach as Booking.com words it, in the requested language. null when the property is not by the sea.
Distance to the beach (m)
beachDistanceMeters
Optional
beachDistance in metres, whatever the language. null when beachDistance is, or when its unit is not one we know.
Nearby beaches
nearbyBeachNames
Optional
Names of the beaches next to the property. Empty when Booking.com names none.
[ "Plage Ponchettes"]Distance to the ski lift (text)
skiLiftDistance
Optional
Distance to the nearest ski lift as Booking.com words it, in the requested language. null when the property is not in a ski area.
Distance to the ski lift (m)
skiLiftDistanceMeters
Optional
skiLiftDistance in metres, whatever the language. null when skiLiftDistance is, or when its unit is not one we know.
Search center latitude
searchCenterLatitude
Optional
Latitude of the center of the searched place according to Booking.com, the one distanceFromCenterKm is measured from. A map point is its own center, a map rectangle gives its middle. null for a search by property name, id or property link, or when Booking.com gave none.
Search center longitude
searchCenterLongitude
Optional
Longitude of the center of the searched place according to Booking.com, the one distanceFromCenterKm is measured from. A map point is its own center, a map rectangle gives its middle. null for a search by property name, id or property link, or when Booking.com gave none.
Public transport
publicTransport
Optional
Nearest public transport, as Booking.com words it.
Central
isCentral
Optional
True when Booking.com marks the property as centrally located.
In the best-rated area
isWithinBestLocationScoreArea
Optional
True when Booking.com places the property in the area of the destination that guests rate best for location.
Main photo
mainImage
Optional
First photo of the property (1024 px).
Photos
images
Required
Photo URLs (1024 px): every photo of the gallery with Extract full property profile, the main photo only otherwise.
[ "https://cf.bstatic.com/xdata/images/hotel/max1024x768/753148428.jpg?k=f66edc329a17da900502ecfe7770775c7840ab8a9faf90c1635227c3f5fe4bbf&o=", "https://cf.bstatic.com/xdata/images/hotel/max1024x768/776159947.jpg?k=a2b05a4ad00cb63b2febc60adc20f593be064aba6574c7761cb5136da1cdcb00&o="]Photos with captions
imagesDetailed
Optional
The same photos as images, in the same order, each with url, caption (the text Booking.com describes the photo with, in English), width and height in pixels of the original, and isNew (true when the site flags the photo as new). Empty when the profile was not read (profile, option extractDetails).
[ { "url": "https://cf.bstatic.com/xdata/images/hotel/max1024x768/929582270.jpg?k=9a5e2d3c1f&o=", "caption": "a hotel room with a bed and a table at Ikonik Jean Médecin in Nice", "width": 6000, "height": 4000, "isNew": true }]Photo count
imageCount
Required
Number of URLs in images.
Badges
badges
Optional
Offer badges Booking.com shows on the result (Late Escape Deal, Getaway Deal...). Empty when none.
[ "Late Escape Deal"]Sponsored
sponsored
Optional
True when the result is an advertisement (Booking.com's Ad label); false otherwise.
Preferred
isPreferred
Optional
True when Booking.com marks the property "Preferred Partner".
Preferred Plus
isPreferredPlus
Optional
True when Booking.com marks the property "Preferred Partner Plus".
Sustainable
isSustainable
Optional
True when the property holds a Booking.com sustainability badge.
Sustainability certifications
sustainabilityCertifications
Optional
Names of the sustainability certifications Booking.com lists for the property. Empty when none.
[ "Green Key (FEE)"]Newly opened
isNewlyOpened
Optional
True when Booking.com marks the property as newly opened.
Third-party inventory only
isTpiExclusive
Optional
True when Booking.com flags the property as sold only through a third-party inventory partner (rare).
Visibility booster
hasVisibilityBooster
Optional
True when the property uses Booking.com's visibility booster, which shows it higher in the results. null when Booking.com does not say.
Bundle rates
hasBundleRates
Optional
True when the property offers bundle rates for these dates. null when Booking.com does not say.
Genius
isGenius
Optional
True when the property takes part in the Genius loyalty programme (profile). Genius prices need a Booking.com account and are not given.
Travel Proud
isTravelProud
Optional
True when the property holds Booking.com's Travel Proud badge (LGBTQ+ welcoming) (profile).
Host type
hostType
Optional
professional = a company or a professional host; private = a private individual.
Description
description
Optional
Property description as text, with its line breaks (profile).
Description (HTML)
descriptionHtml
Optional
The same description with the HTML markup of the page (profile).
Fine print
finePrint
Optional
The "important information" paragraphs of the property page, joined by a blank line (profile).
Amenities
amenities
Optional
Flat list of the amenities the property offers (profile).
[ "Air conditioning", "Smoke-free property", "Wake-up service", "Heating"]Amenities by group
amenityGroups
Optional
Amenities kept in Booking.com's own groups: group, items (profile).
[ { "group": "General", "items": [ "Air conditioning", "Heating" ] }]Highlights
highlights
Optional
Property highlights Booking.com shows at the top of the page, in its order (profile).
[ "Breakfast", "Free Wifi", "Private bathroom", "View", "Non-smoking rooms", "Bath or shower", "Air conditioning", "Family rooms", "Flat-screen TV", "24-hour front desk"]Check-in time
checkInTime
Optional
24-hour HH:mm (a window reads 14:00-22:00) (profile).
Check-out time
checkOutTime
Optional
24-hour HH:mm (a window reads 07:00-12:00) (profile).
Policies
policies
Optional
House rules of the property (profile): children (allowed, minAge, rules by age with their price), beds (cribsAllowed, extraBedsAllowed), pets (allowed YES / NO..., charge), payment (cards accepted, cashStatus: the site's own code), deposit (damage deposit: type, amount, currency, text), rules (minimum check-in age, quiet hours, parties, groups, smoking, curfew, city regulations, as the site words them); and groupLimit (the most guests / rooms the property accepts in one booking, a number), idAndCardRequiredText (what the guest must show at check-in), arrivalNoticeRequiredText (the property must be told the arrival time), payAtProperty (true when the guest can pay at the property), damageDepositGuest (the deposit asked of the guest: amount, currency).
Questions and answers
questionsAnswers
Optional
Guests' questions to the property and its answers (50 at most): question, answer, askedDate and answeredDate (ISO 8601 date, read in the language you picked; null when a date's text does not fit), roomId (the roomId of roomOffers when the question is about a room) (profile). Empty when the property takes no questions.
[ { "question": "Check in and check out times?", "answer": "Hello \n\nCheck in 3pm and check out 12noon. \n\nThank you", "askedDate": "2022-01-18", "answeredDate": "2022-10-02", "roomId": null }]Average response time (s)
averageResponseTime
Optional
Average time the property takes to answer guests' questions, in seconds (profile); null when it takes no questions.
Languages spoken
languagesSpoken
Optional
Two-letter codes of the languages the staff speaks (profile).
[ "ar", "en", "es", "fr", "pt", "ru"]Meals
meals
Optional
Meals the property lists: type (BREAKFAST, LUNCH, DINNER...), style, cuisine, dietary, openFrom, openUntil, price (the site's own text, in the currency of the property: € 15; null when none), offer (the site's own code: BOTH, NOT_OFFERED...), foodMenu (what the buffet holds), drinks, foodScore (guest score out of 10 for the food), foodScoreReviewCount (reviews behind it), photo (link; null when none) (profile, option extractDetails).
[ { "type": "BREAKFAST", "style": [ "Buffet" ], "cuisine": [], "dietary": [], "openFrom": "07:00", "openUntil": "10:00", "price": "€ 15", "offer": "BOTH", "foodMenu": [ "Bread", "Pastries", "Cheese", "Fruit" ], "drinks": [ "Coffee", "Tea", "Fruit juice" ], "foodScore": 8.5, "foodScoreReviewCount": 32, "photo": "https://cf.bstatic.com/xdata/images/hotel/max400/929585048.jpg?k=7bd314a1e7cc&o=" }]Licence numbers
licenseNumbers
Optional
Registration / licence numbers the host gave to Booking.com (short-term rentals in Europe) (profile).
[ "ESHFNT00000805700081332300300000000000000000000000005"]Licence statements
licensePhrases
Optional
Licence statements Booking.com shows on the page (profile).
[ "This property indicated that it doesn't require a short-term rental license or registration"]Chain ID
chain
Optional
Booking.com id of the hotel group the property belongs to; null when independent (profile).
Brands
brands
Optional
Brands of the property: id (the value of the chaincode filter), name, chainId (profile).
[ { "id": 3086, "name": "ibis Styles", "chainId": 24 }]Host profile
hostProfile
Optional
The host's own presentation, for homes run by a host (profile): name, photoUrl, yearsOnWebsite, managedProperties, rating, reviewCount, spokenLanguages, welcomeMessage, ownerInfo, neighbourhoodInfo, familyTips. null when the property has none.
Wheelchair accessible
isWheelchairAccessible
Optional
True when the property page says the property is wheelchair accessible (profile, option extractDetails); null when the page does not say or the profile was not read.
Accessible
isAccessible
Optional
True when the property page flags it as accessible for guests with reduced mobility in general (profile, option extractDetails); null when the page does not say or the profile was not read.
Private bathroom in all rooms
privateBathroomInAllRooms
Optional
True when every room has its own private bathroom (profile, option extractDetails); null when the page does not say or the profile was not read.
Instant booking
instantBook
Optional
True when the property confirms a booking at once, false when the host must accept the request first (the opposite of Booking.com's request-to-book flag) (profile, option extractDetails); null when the page does not say or the profile was not read.
Paid amenities
paidAmenities
Optional
The amenities Booking.com marks as paid (extra cost), once each, in the order of the page; they are also in amenities. Empty when none is marked or the profile was not read (profile, option extractDetails).
[ "Parking", "Fruit", "Wine/Champagne"]Restaurants
restaurants
Optional
The restaurants listed on the property page, one per restaurant: name, cuisines, mealTypes, ambiances, isBuffet, isAlaCarte. Empty when the property lists none or the profile was not read (profile, option extractDetails).
[ { "name": "La Trattoria", "cuisines": [ "Italian", "Pizza" ], "mealTypes": [ "Lunch", "Dinner" ], "ambiances": [ "Romantic" ], "isBuffet": false, "isAlaCarte": true }]Restaurant count
restaurantCount
Optional
How many restaurants the property page lists: 0 when the profile was read and lists none; null when the profile was not read (profile, option extractDetails).
Relevant for your trip
relevantForYourTrip
Optional
The facilities Booking.com puts forward as relevant for the trip searched (its "Relevant for your trip" list), in its order. Empty when the page gives none or the profile was not read (profile, option extractDetails).
[ "Private bathroom", "Air conditioning", "Free Wifi", "View"]Parking
parking
Optional
Parking as the page states it: free (true = no charge), onSite, private, and summary (the site's own sentence, in the language of the run, with the price when there is one). A flag is null when the page does not state it (a property with no parking has only the sentence). null when the page says nothing about parking or the profile was not read (profile, option extractDetails).
Internet summary
internetSummary
Optional
The site's sentence on internet access, in the language of the run (WiFi is available in all areas and is free of charge.). null when the page gives none or the profile was not read (profile, option extractDetails).
Pets summary
petsSummary
Optional
The site's sentence on pets, in the language of the run (Pets are allowed on request. Charges may be applicable.). null when the page gives none or the profile was not read (profile, option extractDetails).
Pets on request
petsOnRequest
Optional
true when pets are allowed only after asking the property, false when they are allowed without asking. null when the page has no pets highlight (this does not mean pets are refused) or the profile was not read (profile, option extractDetails).
Nearby beaches (detailed)
nearbyBeaches
Optional
The beaches the page lists near the property, nearest first: name, distance (the site's text in the language of the run, 450 m) and rating (guest score out of 10, null when none). Empty when the page lists none or the profile was not read (profile, option extractDetails).
[ { "name": "Plage Ponchettes", "distance": "450 m", "rating": 8.2 }]Nearby ski lifts
nearbySkiLifts
Optional
The ski lifts the page lists near the property: name, distance (the site's text in the language of the run, 800 m) and resort (the ski resort, null when the site names none). Empty away from a ski area, or when the profile was not read (profile, option extractDetails).
[ { "name": "Planards", "distance": "1.4 km", "resort": null }]Area type
areaType
Optional
The kind of area the property is in, as the site classes it in lower case (urban, rural...). null when the site does not say or the profile was not read (profile, option extractDetails).
In the city centre
isCityCenter
Optional
true when the site places the property in the city centre. null when the page does not say or the profile was not read (profile, option extractDetails). Not the same as isCentral of the search results.
In the old town
isOldTown
Optional
true when the site places the property in the old town. null when the page does not say or the profile was not read (profile, option extractDetails).
Destination labels
destinationLabels
Optional
The labels the site puts on the destination (BEACH_UFI, SKI_UFI...), as the site writes them. Empty when it gives none or the profile was not read (profile, option extractDetails).
[ "BEACH_UFI"]Ski season
isSkiSeason
Optional
true when the site says it is ski season at the destination, false when it says it is not. null when the page does not say or the profile was not read (profile, option extractDetails).
Room types
roomTypes
Optional
The room types of the property page, each with its id (the roomId of roomOffers and of the review roomId) and name in the language of the run. Empty when the profile was not read (profile, option extractDetails). These are the types, not the offers: prices come with Room offers.
[ { "id": 706745315, "name": "Double Room" }]Room type count
roomTypeCount
Optional
Number of entries in roomTypes: 0 when the profile was read and lists none; null when the profile was not read (profile, option extractDetails).
Amenity count
amenityCount
Optional
How many amenities the site counts for the property. null when the page does not give it or the profile was not read (profile, option extractDetails).
Featured reviews
featuredReviews
Optional
The few guest reviews the property page shows itself (about 10): reviewId (the site's number of the review, a text; it is not the code used in reviews), rating (out of 10), title, positive, negative, language (code the site gives), travelerType (the site's own code, YOUNG_COUPLE...), reviewerCountryCode (two letters, lower case). Free with the profile; Include reviews gives all of them with more details. Empty when the page shows none or the profile was not read (profile, option extractDetails).
[ { "reviewId": "5359612737", "rating": 9, "title": "Fabulous would use again", "positive": "Great hotel, friendly and helpful staff, good location near all amenities.", "negative": null, "language": "en", "travelerType": "YOUNG_COUPLE", "reviewerCountryCode": "gb" }]Company / host contact
hostContact
Optional
The company or host running the property, as Booking.com publishes it for trader traceability: companyName, tradeRegisterName, registrationNumber, type (BUSINESS...), address (line1, line2, city, state, postalCode, countryCode), email, phone, firstName, middleName, lastName (a private host), legalEntityId (the company's number at Booking.com: the same for every property of one lessor, so it groups a lessor's listings). The address is the company's, not the property's. null unless Company / host contact details is on, and when Booking.com publishes none (option includeHostContact).
Company website
hostWebsite
Optional
The own website of the company that runs the property (https://host), found on public pages and kept only when its home page names the company and places it (its town, postal code, country or one of its phones). Companies only, never a private person. null unless Company website and contacts is on (option includeHostWebsite, needs includeHostContact), and when no site was found.
Company website e-mails
hostWebsiteEmails
Optional
E-mail addresses shown on the company's website (at most 3, lower case). [] when none is shown or the option is off (option includeHostWebsite).
[ "contact@hotelmimosa.fr"]Company website phones
hostWebsitePhones
Optional
Phone numbers shown on the company's website, written with their country code (+ and the digits; at most 3). [] when none is shown or the option is off (option includeHostWebsite).
[ "+33145388600"]Company Telegram
hostTelegram
Optional
The Telegram link (channel, user or invitation) shown on the company's website. null when none is shown or the option is off (option includeHostWebsite).
Company website source page
hostWebsiteSourceUrl
Optional
The page of the website the contact details come from: the first e-mail's, else the first phone's, else the Telegram link's, else the home page. null when no website was found (option includeHostWebsite).
Company website confidence
hostWebsiteConfidence
Optional
high when an e-mail on the website's own domain, or the e-mail Booking.com publishes for the company, confirms the site; medium otherwise. null when no website was found (option includeHostWebsite).
Nearby places
nearbyPlaces
Optional
Places around the property: name, category (Airports, landmarks, restaurants, public transport, beaches, Supermarkets and Groceries, Ski lifts...), distanceKm (straight line), distanceText (as the site words it), walkTime / walkMinutes (time on foot, as the site words it and in minutes), driveTime / driveMinutes (time by car), walkMeters / driveMeters (distance by the real road, in metres, on foot / by car), isIsolated (the site's own flag for the place), latitude, longitude. A time or a distance by road is null where the site gives none (a place too far to walk to) or, for a time, words it in a way the Actor cannot read as minutes (the text is kept). null unless Nearby places is on (option includeNearbyPlaces).
Area known for
areaEndorsements
Optional
What the area of the property is known for, as the site words it (Seaside, History and culture, Mountains, Winter sports...), in the language of the run. Empty when the site gives none. null unless Nearby places is on, or when the site did not answer (option includeNearbyPlaces).
Price calendar
calendar
Optional
One entry per day from the check-in date: date, available (bookable for your guests), price (indicative price in currency of a ONE-night stay that starts that day, for ONE room and the guests asked - asking for 2 rooms does not change it - rounded to the unit and the same whatever nights is; Booking.com may not take some discounts off it, so it is a guide: the exact price of your stay is price; null when not bookable), minNights (minimum stay). null unless Price calendar is on (option includeCalendar).
Room offers
roomOffers
Optional
Every room offer of the property for the stay, in Booking.com's order (maxRoomOffersPerHotel at most): offerId, roomId, roomName, roomSizeSqm, bathrooms, maxOccupancy, maxAdults and maxChildren (adults and children the rate lets in; 0 children = none allowed), isSmoking (smoking allowed in the room), roomTypeId (the site's number for the kind of room), beds (type, count; filled for apartments), roomDescription, roomPhotos (1024 px), roomFacilities, roomHighlights, mealPlan (site code: BREAKFAST, NONE...), occupancy (guests the price is for; null when Booking.com does not price this offer by number of guests: see maxOccupancy), price (ONE room of this type for the whole stay, taxes and fees included: with several rooms asked the offer is still for one room, while price of the row is for all of them), pricePerNight (that price per night), priceBeforeDiscount (crossed out), currency, taxesAndFeesIncluded (amount in price), badges, freeCancellation, cancellationText, noPrepayment, prepaymentText, roomsLeft, breakfastPrice and breakfastCurrency (optional breakfast as Booking.com prices it, in the currency of the property; null when breakfast is included or not offered). null unless Room offers is on; empty when sold out (option includeRoomOffers).
Room offers given by Booking.com
roomOfferCount
Optional
How many room offers Booking.com gave for the stay, before the cap maxRoomOffersPerHotel; 0 = sold out. null unless Room offers is on, or when the offers could not be read (option includeRoomOffers).
Reviews
reviews
Optional
Guest reviews of the property: reviewId, rating (out of 10), date (ISO 8601), title, positive, negative, language (code the site gives), reviewerName, reviewerCountry, reviewerCountryCode (two letters, lower case), avatarUrl, isAnonymous, userReviewCount (reviews the guest has written on Booking.com), userJoinedDate (ISO 8601 date the guest joined Booking.com), travelerType (FAMILIES, COUPLES, GROUP_OF_FRIENDS, SOLO_TRAVELLERS, BUSINESS_TRAVELLERS), roomType, roomId (the roomId of roomOffers), nights, checkIn, checkOut, stayStatus, hotelReply (the property's answer), photos, helpfulVotes. null unless Include reviews is on (option includeReviews).
Reviews incomplete
reviewsIncomplete
Optional
True when some of the reviews asked for could not be read (a page the site kept refusing, or no time left): reviews then holds those read. False otherwise; null when reviews are not asked for (option includeReviews).
Rating scores with city average
ratingScores
Optional
Score per review category as the reviews page gives it: category (Booking.com code), name (in the requested language), score, reviewCount (reviews that rated it), cityAverageLow and cityAverageHigh (range of the city's average for that category). null unless Include reviews is on.
Score distribution
scoreDistribution
Optional
Number of reviews in each score band of Booking.com: superb (9+), good (7-9), average (5-7), poor (3-5), veryPoor (1-3). null unless Include reviews is on.
Reviews by language
reviewsByLanguage
Optional
Number of the property's reviews written in each language, as Booking.com's language filter counts them: code (en), name (in the requested language), count, flag (country code of the flag). Counts all the reviews of the property, whatever the review filters of the run. null unless Include reviews or Include review summary is on.
Reviews by traveler type
reviewsByTravelerType
Optional
Number of the property's reviews by type of traveler (FAMILIES, COUPLES, GROUP_OF_FRIENDS, SOLO_TRAVELLERS, BUSINESS_TRAVELLERS): travelerType, name (in the requested language), count. Counts all the reviews of the property, whatever the review filters of the run. null unless Include reviews or Include review summary is on.
Reviews by season
reviewsBySeason
Optional
Number of the property's reviews of stays in each season: season (_03_05 March-May, _06_08 June-August, _09_11 September-November, _12_02 December-February, the values of the reviews season filter), name (in the requested language), count. A review with no stay date is in no season. null unless Include reviews or Include review summary is on, or when Booking.com did not give the counts.
Review topics
reviewTopics
Optional
The topics Booking.com lists for the reviews of the property (the words the guests mention most: Location, Breakfast, Room...), most mentioned first: id (Booking.com topic id, which depends on the language asked), name (in the requested language). No count: the site gives none. null unless Include reviews or Include review summary is on.
Review summary
reviewSummary
Optional
Booking.com's own summary of the guest reviews, as plain text: language, basedOnReviews (reviews summarised), summary (a short text, when Booking.com gives one instead of pros and cons), pros and cons (text, mentions = reviews that mention it, sentiment). null unless Include review summary is on, or when Booking.com has none (properties with few reviews).
Scores by topic and traveler type
reviewTopicScores
Optional
Score out of 10 per topic (bed_comfort and the categories of ratingScores) and per traveler type (ALL, COUPLE, FAMILY, BUSINESS, SOLO_TRAVELLER): topic, travelerType, score, reviewCount. null unless Include review summary is on, or when Booking.com has none (properties with few reviews).
Rank
rank
Optional
1-based position in the search results, in the requested order; null for a property given by URL or name.
Search destination
searchLocation
Optional
What this property was found for: the destination as typed, the hotel name, lat,lon of a map point, or the pasted search URL; null for a property URL.
Search URL
searchUrl
Optional
Booking.com search page equivalent to the search the property was found by; null for a property URL.
Total results
totalResults
Optional
Number of properties Booking.com reports for this search (moves by a few units between calls: live availability).
Destination nearly full
destinationLowAvailability
Optional
True when Booking.com says few properties of the searched destination are free for your dates. The same value on every row of a search; null for a property search, a map rectangle, or when Booking.com gives none.
City ID
cityId
Optional
Booking.com city id (ufi) the property belongs to.
Scraped at
scrapedAt
Required
ISO 8601 timestamp of the extraction.