Same value as propertyId: the key the Actor's engine saves and de-duplicates every row on (and the memory of Only new properties).
Type:integer
Example:
59015
Property ID
propertyId
Required
Booking.com numeric property id.
Type:integer
Example:
59015
Name
name
Required
Property name in the requested language.
Type:string
Example:
Ibis Styles Paris Batignolles
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).
Type:string
Example:
https://www.booking.com/hotel/fr/mirific.html
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.
Last part of the property URL, without the language suffix.
Type:string
Example:
mirific
Country code
countryCode
Required
Two-letter country code of the property, in lower case, as in the property URL.
Type:string
Example:
fr
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.
Type:string | null
Example:
hotel
Property type ID
propertyTypeId
Optional
Booking.com id of the property type (ht_id: 204 hotel, 201 apartment, 220 vacation home, 213 villa...).
Type:integer | null
Example:
204
Star rating
starRating
Optional
Stars (1-5), or the quality rating Booking.com gives to homes (see starRatingType); null when the property has none.
Type:number | null
Example:
3
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.
Type:string | null
Example:
stars
Options:
starstilescirclesnull
Guest rating
rating
Optional
Guest score out of 10; null with no review.
Type:number | null
Example:
8.3
Rating text
ratingText
Optional
Wording Booking.com puts on the guest score (Exceptional, Wonderful, Excellent, Very Good, Good...), in the requested language.
Type:string | null
Example:
Very Good
Review count
reviewCount
Optional
Number of guest reviews.
Type:integer | null
Example:
3224
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.
Type:object | null
Example:
[object Object]
External rating
externalRating
Optional
Score of an outside review source that Booking.com shows next to its own (only some properties); out of 10.
Type:number | null
Example:
9.28
External review count
externalReviewCount
Optional
Number of reviews behind externalRating (only the properties that have an outside review source).
Type:integer | null
Example:
51
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.
Type:number | null
Example:
419.26
Currency
currency
Optional
Currency of price and of the other prices of the row (the Currency input).
Type:string | null
Example:
EUR
Price per night
pricePerNight
Optional
price divided by the number of nights (Booking.com does not give it).
Type:number | null
Example:
209.63
Price before discount
priceBeforeDiscount
Optional
Crossed-out price for the whole stay; null when the offer has no discount.
Type:number | null
Example:
658.18
Discount (%)
discountPercent
Optional
Discount in percent: (priceBeforeDiscount - price) / priceBeforeDiscount, rounded to the unit; null when the offer has no discount.
Type:number | null
Example:
36
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.
Type:object[]
Example:
[
{
"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.
Type:number | null
Example:
33.8
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:object[]
Example:
[
{
"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).
Type:number | null
Example:
453.06
Price in the hotel currency
priceInHotelCurrency
Optional
The same price in the currency the property itself charges, when it differs from currency; null otherwise.
Type:number | null
Example:
239.53
Hotel currency
hotelCurrency
Optional
Currency the property charges (with priceInHotelCurrency); null when it is the same as currency.
Type:string | null
Example:
EUR
Price note
priceNote
Optional
Mention Booking.com puts under the price, in the requested language; null when it shows none.
Type:string | null
Example:
Includes taxes and fees
Available
isAvailable
Required
True when at least one room can be booked for the requested stay; false for a sold-out property (no price).
Type:boolean
Example:
true
Closed
isClosed
Optional
True when Booking.com marks the property as closed.
Type:boolean | null
Example:
false
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.
Type:integer | null
Example:
2
Free cancellation
freeCancellation
Optional
True when the recommended offer can be cancelled free of charge.
Type:boolean | null
Example:
true
Free cancellation until
freeCancellationUntil
Optional
Last moment of free cancellation of the recommended offer, ISO 8601 (UTC); null when it cannot be cancelled free.
Type:string | null
Example:
2026-11-09T23:00:00Z
No prepayment
noPrepayment
Optional
True when the recommended offer needs no prepayment (pay at the property).
Type:boolean | null
Example:
true
Meal plan
mealPlan
Optional
Meals included in the recommended offer, as Booking.com words it in the requested language; null when none.
Type:string | null
Example:
Breakfast included
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). null for a sold-out property.
Type:object | null
Example:
[object Object]
Stay
stay
Required
The stay the prices were read for: checkIn, checkOut, nights, adults, children, childrenAges, rooms.
Type:object
Example:
{
"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.
Type:boolean | null
Example:
true
Street address
address
Optional
Street and number, as Booking.com gives it.
Type:string | null
Example:
119 Avenue De Clichy
Full address
formattedAddress
Optional
Full address in one line, with district, postal code and country (profile).
Type:string | null
Example:
119 Avenue De Clichy, 17th arr., 75017 Paris, France
Postal code
postalCode
Optional
Postal code read from the full address when the format of the country is known; null otherwise, never guessed (profile).
Type:string | null
Example:
75017
District
district
Optional
Neighbourhood or district, as Booking.com names it.
Type:string | null
Example:
17th arr.
Display location
displayLocation
Optional
District and city as the search result shows them, in the requested language.
Type:string | null
Example:
5th arr., Paris
City
city
Optional
City of the property.
Type:string | null
Example:
Paris
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.
Type:string | null
Example:
Ile de France
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.
Type:string | null
Example:
France
Latitude
latitude
Optional
Type:number | null
Example:
48.889853
Longitude
longitude
Optional
Type:number | null
Example:
2.321209
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).
Type:string | null
Example:
0.4 miles from downtown
Distance from center (km)
distanceFromCenterKm
Optional
distanceFromCenter converted to kilometres, whatever the language. null when distanceFromCenter is.
Type:number | null
Example:
0.64
Public transport
publicTransport
Optional
Nearest public transport, as Booking.com words it.
Type:string | null
Example:
Saint-Michel station is within 100 yards
Central
isCentral
Optional
True when Booking.com marks the property as centrally located.
Type:boolean | null
Example:
true
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.
Offer badges Booking.com shows on the result (Late Escape Deal, Getaway Deal...). Empty when none.
Type:string[]
Example:
[
"Late Escape Deal"
]
Sponsored
sponsored
Optional
True when the result is an advertisement (Booking.com's Ad label); false otherwise.
Type:boolean | null
Example:
false
Preferred
isPreferred
Optional
True when Booking.com marks the property "Preferred Partner".
Type:boolean | null
Example:
true
Preferred Plus
isPreferredPlus
Optional
True when Booking.com marks the property "Preferred Partner Plus".
Type:boolean | null
Example:
true
Sustainable
isSustainable
Optional
True when the property holds a Booking.com sustainability badge.
Type:boolean | null
Example:
false
Sustainability certifications
sustainabilityCertifications
Optional
Names of the sustainability certifications Booking.com lists for the property. Empty when none.
Type:string[]
Example:
[
"Green Key (FEE)"
]
Newly opened
isNewlyOpened
Optional
True when Booking.com marks the property as newly opened.
Type:boolean | null
Example:
false
Third-party inventory only
isTpiExclusive
Optional
True when Booking.com flags the property as sold only through a third-party inventory partner (rare).
Type:boolean | null
Example:
false
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.
Type:boolean | null
Example:
false
Travel Proud
isTravelProud
Optional
True when the property holds Booking.com's Travel Proud badge (LGBTQ+ welcoming) (profile).
Type:boolean | null
Example:
true
Host type
hostType
Optional
professional = a company or a professional host; private = a private individual.
Type:string | null
Example:
professional
Options:
professionalprivatenull
Description
description
Optional
Property description as text, with its line breaks (profile).
Type:string | null
Example:
This hotel is just a 1-minute walk from Brochant Metro Station and 2789 feet from the lively Place de Clichy.
Description (HTML)
descriptionHtml
Optional
The same description with the HTML markup of the page (profile).
Type:string | null
Example:
<p>This hotel is just a 1-minute walk from Brochant Metro Station and 2789 feet from the lively Place de Clichy.</p>
Fine print
finePrint
Optional
The "important information" paragraphs of the property page, joined by a blank line (profile).
Type:string | null
Example:
Guests are required to show a photo ID and credit card upon check-in. Please note that all Special Requests are subject to availability and additional charges may apply.
Amenities
amenities
Optional
Flat list of the amenities the property offers (profile).
Type:string[]
Example:
[
"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).
Type:object[]
Example:
[
{
"group":"General",
"items":[
"Air conditioning",
"Heating"
]
}
]
Highlights
highlights
Optional
Property highlights Booking.com shows at the top of the page, in its order (profile).
Type:string[]
Example:
[
"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).
Type:string | null
Example:
14:00
Check-out time
checkOutTime
Optional
24-hour HH:mm (a window reads 07:00-12:00) (profile).
Type:string | null
Example:
12:00
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).
Type:object | null
Example:
[object Object]
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.
Type:object[]
Example:
[
{
"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.
Type:integer | null
Example:
15859420
Languages spoken
languagesSpoken
Optional
Two-letter codes of the languages the staff speaks (profile).
Type:string[]
Example:
[
"ar",
"en",
"es",
"fr",
"pt",
"ru"
]
Meals
meals
Optional
Meals the property serves: type (BREAKFAST...), style, cuisine, dietary, openFrom, openUntil (profile).
Type:object[]
Example:
[
{
"type":"BREAKFAST",
"style":[
"Buffet"
],
"cuisine":[],
"dietary":[],
"openFrom":"07:00",
"openUntil":"10:00"
}
]
Licence numbers
licenseNumbers
Optional
Registration / licence numbers the host gave to Booking.com (short-term rentals in Europe) (profile).
Licence statements Booking.com shows on the page (profile).
Type:string[]
Example:
[
"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).
Type:integer | null
Example:
24
Brands
brands
Optional
Brands of the property: id (the value of the chaincode filter), name, chainId (profile).
Type:object[]
Example:
[
{
"id":3086,
"name":"ibis Styles",
"chainId":24
}
]
Host profile
hostProfile
Optional
The host's own presentation, for homes run by a host (profile): name, yearsOnWebsite, managedProperties, rating, reviewCount, spokenLanguages, welcomeMessage, ownerInfo, neighbourhoodInfo, familyTips. null when the property has none.
Type:object | null
Example:
[object Object]
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). 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).
Type:object | null
Example:
[object Object]
Nearby places
nearbyPlaces
Optional
Places around the property: name, category (Airports, landmarks, restaurants, public transport, beaches...), 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), latitude, longitude. A time is null where the site gives none (a place too far to walk to) or words it in a way the Actor cannot read as minutes (the text is kept). null unless Nearby places is on (option includeNearbyPlaces).
Type:object[] | null
Example:
[object Object]
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).
Type:object[] | null
Example:
[object Object]
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, 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).
Type:object[] | null
Example:
[object Object]
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).
Type:integer | null
Example:
12
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).
Type:object[] | null
Example:
[object Object]
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).
Type:boolean | null
Example:
false
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.
Type:object[] | null
Example:
[object Object]
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.
Type:object | null
Example:
[object Object]
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.
Type:object[] | null
Example:
[object Object],[object Object]
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.
Type:object[] | null
Example:
[object Object],[object Object]
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.
Type:object[] | null
Example:
[object Object],[object Object]
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.
Type:object[] | null
Example:
[object Object],[object Object]
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).
Type:object | null
Example:
[object Object]
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).
Type:object[] | null
Example:
[object Object],[object Object]
Rank
rank
Optional
1-based position in the search results, in the requested order; null for a property given by URL or name.
Type:integer | null
Example:
1
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.
Type:string | null
Example:
Paris
Search URL
searchUrl
Optional
Booking.com search page equivalent to the search the property was found by; null for a property URL.