Booking.com

Get a Booking.com property

Get a Booking.com property's details: rooms, facilities, meals, photos, house rules, guest questions and review scores.

GET/v1/booking/property
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
urlstringrequiredquery

Booking.com property page URL, e.g. `https://www.booking.com/hotel/gb/the-savoy.html`: `url` from the property search endpoint. A language suffix and query string are ignored.

max 2048 chars · pattern: ^(?:[Hh][Tt][Tt][Pp][Ss]?:\/\/)?(?:[A-Za-z0-9-]+\.)?[Bb][Oo][Oo][Kk][Ii][Nn][Gg]\.[Cc][Oo][Mm]\/[Hh][Oo][Tt][Ee][Ll]\/[A-Za-z]{2}\/[A-Za-z0-9_.-]{1,200}\.[Hh][Tt][Mm][Ll]?(?:[?#].*)?$

languagestringoptionalquery

Language of names, labels and descriptions, as the site's own code: `en-us`, `en-gb`, `de`, `fr`, `es`, `it`, `ja`, `zh-cn` and so on. Default `en-us`.

currencystringoptionalquery

Currency of the prices the page shows (meals, extra beds), as a three-letter code such as `USD`, `EUR`, `GBP` or `JPY`. Default `USD`.

Response fields
136

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the site has no property at this URL.

one of: found, not_found

The property; null when not found.

datapropertyid
integer

Property id. Pass it as `propertyId` to the property reviews endpoint.

datapropertyname
string

Property name.

datapropertyurl
string

Property page URL.

datapropertypageName
string

The property's page name in its URL, e.g. `the-savoy`.

datapropertyaccommodationType
stringnullable

Kind of property: `hotel`, `apartment`, `hostel`, `guest_house` and so on; null when unknown.

datapropertyaccommodationTypeId
integernullable

The site's id for the kind of property.

datapropertystars
numbernullable

Star or quality rating, 1 to 5; null when none.

datapropertystarsType
stringnullable

`stars` for an official or property-provided star rating, `squares` for the site's own quality rating of homes.

one of: stars, squares, other, null

datapropertydescription
stringnullable

The property's description in `language`, as the page shows it: the site translates it where the property wrote none in that language.

datapropertyfinePrint
stringnullable

Must-know information the property adds for guests.

datapropertyaddress
stringnullable

Street address.

datapropertycity
stringnullable

City.

datapropertypostalCode
stringnullable

Postal code.

datapropertyregion
stringnullable

Region or state.

datapropertycountryCode
string

Two-letter country code, lower case.

datapropertylatitude
numbernullable

Latitude.

datapropertylongitude
numbernullable

Longitude.

datapropertyreviewScore
numbernullable

Guest review score, 1 to 10; null when not shown.

datapropertyreviewCount
integernullable

Guest reviews counted in the score.

Guests' average score per category.

datapropertyscores[]category
string

Category key: `staff`, `facilities`, `cleanliness`, `comfort`, `value`, `location`, `wifi`.

datapropertyscores[]label
stringnullable

Category name as the site shows it, e.g. `Cleanliness`.

datapropertyscores[]score
numbernullable

Average score, 1 to 10.

datapropertyscores[]count
integernullable

Reviews that scored this category.

datapropertycurrency
stringnullable

The property's own currency, e.g. `GBP`.

The hotel brand or chain, when the property belongs to one.

datapropertybrandid
integer

The site's brand id.

datapropertybrandname
string

Brand name, e.g. `Shangri-La Group`.

datapropertybrandlogo
stringnullable

Logo URL. Link only; not hosted by Social Fetch.

Languages the staff speak, as codes such as `en` or `fr`.

datapropertylanguagesSpoken[]
stringoptional

The facilities the site lists as most popular, e.g. `Free WiFi`.

datapropertypopularFacilities[]
stringoptional

Highlights by category, as the page groups them.

datapropertyhighlights[]category
string

Category, e.g. `Wellness`.

What the property offers in it, e.g. `Sauna`.

datapropertyhighlights[]items[]
stringoptional

Meals offered; one the property does not offer is left out.

datapropertymeals[]type
string

Meal, lower case: `breakfast`, `brunch`, `lunch`, `dinner`, `hightea`, `cocktail_hour`.

datapropertymeals[]offer
stringnullable

How it is offered, lower case: `included` in the rate, `optional_paid` at extra cost, or `both`.

datapropertymeals[]price
stringnullable

Price as the site words it, in `currency`, e.g. `$55.38`; null when included or not shown.

How it is served, e.g. `Buffet`.

datapropertymeals[]styles[]
stringoptional

Cuisines, e.g. `Continental`.

datapropertymeals[]cuisines[]
stringoptional

Dietary options, e.g. `Vegetarian`.

datapropertymeals[]dietary[]
stringoptional

What is served, e.g. `Pastries`.

datapropertymeals[]food[]
stringoptional

Drinks, e.g. `Coffee`.

datapropertymeals[]drinks[]
stringoptional

When it is served, as the property gives it.

datapropertymeals[]hoursfrom
stringnullable

Earliest time, as the site words it, e.g. `3:00 PM`.

datapropertymeals[]hoursuntil
stringnullable

Latest time, as the site words it, e.g. `11:00 PM`.

datapropertymeals[]score
numbernullable

Guests' score for it, 1 to 10.

datapropertymeals[]scoreCount
integernullable

Reviews behind `score`.

Rooms and units, without prices (those depend on dates).

datapropertyrooms[]id
integer

The site's room id.

datapropertyrooms[]name
stringnullable

Room or unit name.

datapropertyrooms[]description
stringnullable

The property's description of the room.

datapropertyrooms[]sizeM2
numbernullable

Floor area in square metres, when the property gives it.

Beds in the room's first bed arrangement; empty when not given.

datapropertyrooms[]beds[]type
string

Bed type, lower case, e.g. `extra_large_double_bed`, `single_bed`, `sofa_bed`.

datapropertyrooms[]beds[]count
integernullable

How many.

datapropertyrooms[]bedArrangements
integernullable

How many bed arrangements a guest can choose between.

datapropertyrooms[]maxGuests
integernullable

Most guests the room sleeps, children included.

datapropertyrooms[]maxAdults
integernullable

Most adults.

datapropertyrooms[]maxChildren
integernullable

Most children.

datapropertyrooms[]bathrooms
integernullable

Bathrooms, for a unit that lists them.

datapropertyrooms[]smoking
booleannullable

Whether smoking is allowed in the room.

The room's facilities, e.g. `Air conditioning`.

datapropertyrooms[]facilities[]
stringoptional

Room photo URLs. Link only; not hosted by Social Fetch.

datapropertyrooms[]photos[]
stringoptional

The gallery, main photo first.

datapropertyphotos[]id
integer

The site's photo id.

datapropertyphotos[]url
string

Photo URL, up to 1024 by 768 pixels. Link only; not hosted by Social Fetch.

datapropertyphotos[]caption
stringnullable

The site's description of the photo.

datapropertyphotos[]width
integernullable

Width of the original, in pixels.

datapropertyphotos[]height
integernullable

Height of the original, in pixels.

datapropertyphotoCount
integer

Photos in the gallery; more than `photos` holds when the gallery is longer than the list.

House rules and policies.

Check-in window.

datapropertypoliciescheckInfrom
stringnullable

Earliest time, as the site words it, e.g. `3:00 PM`.

datapropertypoliciescheckInuntil
stringnullable

Latest time, as the site words it, e.g. `11:00 PM`.

Check-out window.

datapropertypoliciescheckOutfrom
stringnullable

Earliest time, as the site words it, e.g. `3:00 PM`.

datapropertypoliciescheckOutuntil
stringnullable

Latest time, as the site words it, e.g. `11:00 PM`.

datapropertypoliciesminCheckInAge
integernullable

Youngest age a guest can check in at.

datapropertypoliciespets
stringnullable

Whether pets are allowed, lower case: `yes`, `no`, `upon_request`.

datapropertypoliciespetCharges
stringnullable

Lower case, e.g. `free` or `charges_may_apply`.

datapropertypolicieschildrenAllowed
booleannullable

Whether children may stay.

datapropertypoliciesminChildAge
integernullable

Youngest child age allowed.

datapropertypoliciescribsAllowed
booleannullable

Whether cribs are offered.

datapropertypoliciesextraBedsAllowed
booleannullable

Whether extra beds are offered.

Bed charges for children, by age band.

datapropertypolicieschildRules[]ageFrom
integernullable

Youngest age it covers.

datapropertypolicieschildRules[]ageTo
integernullable

Oldest age it covers; null for no upper limit.

datapropertypolicieschildRules[]bed
stringnullable

Bed it is for, lower case: `crib`, `extra_bed` or `existing_bed`.

datapropertypolicieschildRules[]price
stringnullable

Price as the site words it in the property's currency, e.g. `£90`.

datapropertypolicieschildRules[]priceType
stringnullable

Lower case, e.g. `free`, `fixed` or `percentage`.

datapropertypolicieschildRules[]priceMode
stringnullable

Lower case, e.g. `per_night` or `per_stay`.

datapropertypoliciesgroupLimit
integernullable

Rooms above which a booking counts as a group, with other terms.

Quiet hours, when the property sets them.

datapropertypoliciesquietHoursfrom
stringnullable

Earliest time, as the site words it, e.g. `3:00 PM`.

datapropertypoliciesquietHoursuntil
stringnullable

Latest time, as the site words it, e.g. `11:00 PM`.

Curfew, when the property sets one.

datapropertypoliciescurfewfrom
stringnullable

Earliest time, as the site words it, e.g. `3:00 PM`.

datapropertypoliciescurfewuntil
stringnullable

Latest time, as the site words it, e.g. `11:00 PM`.

datapropertypoliciespartiesAllowed
booleannullable

False when the property says parties are not allowed.

datapropertypoliciessmokingAllowed
booleannullable

False when the property says smoking is not allowed.

Cards the property accepts, e.g. `Visa`.

datapropertypoliciesacceptedCards[]
stringoptional
datapropertypoliciesacceptsCash
booleannullable

Whether the property accepts cash.

Further house rules as the site words them, e.g. a local regulation or an ID requirement.

datapropertypoliciesrules[]
stringoptional

Guest questions with the property's answers, as the page shows them (up to 20).

datapropertyquestions[]id
integer

The site's question id.

datapropertyquestions[]question
string

The guest's question.

datapropertyquestions[]answer
stringnullable

The property's answer.

datapropertyquestions[]askedOn
stringnullable

When it was asked, as the site words it.

datapropertyquestions[]answeredOn
stringnullable

When it was answered, as the site words it.

datapropertypreferredPartner
booleannullable

Whether the site marks it a preferred partner.

datapropertytravelProud
booleannullable

Whether it carries the site's LGBTQ+ friendly badge.

datapropertywheelchairAccessible
booleannullable

Whether the site marks it wheelchair accessible.

datapropertysustainable
booleannullable

Whether it has a sustainability certification on the site.

datapropertynewlyOpened
booleannullable

Whether the site marks it newly opened.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/booking/property?url=https://www.booking.com/hotel/gb/shangri-la-at-the-shard-london.html" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Booking.com property details.