Get a Booking.com property
Get a Booking.com property's details: rooms, facilities, meals, photos, house rules, guest questions and review scores.
Headers
Get your API keyAPI key (`sfk_...`)
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]?(?:[?#].*)?$
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`.
Currency of the prices the page shows (meals, extra beds), as a three-letter code such as `USD`, `EUR`, `GBP` or `JPY`. Default `USD`.
Endpoint-specific response payload.
`not_found` when the site has no property at this URL.
one of: found, not_found
The property; null when not found.
Property id. Pass it as `propertyId` to the property reviews endpoint.
Property name.
Property page URL.
The property's page name in its URL, e.g. `the-savoy`.
Kind of property: `hotel`, `apartment`, `hostel`, `guest_house` and so on; null when unknown.
The site's id for the kind of property.
Star or quality rating, 1 to 5; null when none.
`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
The property's description in `language`, as the page shows it: the site translates it where the property wrote none in that language.
Must-know information the property adds for guests.
Street address.
City.
Postal code.
Region or state.
Two-letter country code, lower case.
Latitude.
Longitude.
Guest review score, 1 to 10; null when not shown.
Guest reviews counted in the score.
Guests' average score per category.
Category key: `staff`, `facilities`, `cleanliness`, `comfort`, `value`, `location`, `wifi`.
Category name as the site shows it, e.g. `Cleanliness`.
Average score, 1 to 10.
Reviews that scored this category.
The property's own currency, e.g. `GBP`.
The hotel brand or chain, when the property belongs to one.
The site's brand id.
Brand name, e.g. `Shangri-La Group`.
Logo URL. Link only; not hosted by Social Fetch.
Languages the staff speak, as codes such as `en` or `fr`.
The facilities the site lists as most popular, e.g. `Free WiFi`.
Highlights by category, as the page groups them.
Category, e.g. `Wellness`.
What the property offers in it, e.g. `Sauna`.
Meals offered; one the property does not offer is left out.
Meal, lower case: `breakfast`, `brunch`, `lunch`, `dinner`, `hightea`, `cocktail_hour`.
How it is offered, lower case: `included` in the rate, `optional_paid` at extra cost, or `both`.
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`.
Cuisines, e.g. `Continental`.
Dietary options, e.g. `Vegetarian`.
What is served, e.g. `Pastries`.
Drinks, e.g. `Coffee`.
When it is served, as the property gives it.
Earliest time, as the site words it, e.g. `3:00 PM`.
Latest time, as the site words it, e.g. `11:00 PM`.
Guests' score for it, 1 to 10.
Reviews behind `score`.
Rooms and units, without prices (those depend on dates).
The site's room id.
Room or unit name.
The property's description of the room.
Floor area in square metres, when the property gives it.
Beds in the room's first bed arrangement; empty when not given.
Bed type, lower case, e.g. `extra_large_double_bed`, `single_bed`, `sofa_bed`.
How many.
How many bed arrangements a guest can choose between.
Most guests the room sleeps, children included.
Most adults.
Most children.
Bathrooms, for a unit that lists them.
Whether smoking is allowed in the room.
The room's facilities, e.g. `Air conditioning`.
Room photo URLs. Link only; not hosted by Social Fetch.
The gallery, main photo first.
The site's photo id.
Photo URL, up to 1024 by 768 pixels. Link only; not hosted by Social Fetch.
The site's description of the photo.
Width of the original, in pixels.
Height of the original, in pixels.
Photos in the gallery; more than `photos` holds when the gallery is longer than the list.
House rules and policies.
Check-in window.
Earliest time, as the site words it, e.g. `3:00 PM`.
Latest time, as the site words it, e.g. `11:00 PM`.
Check-out window.
Earliest time, as the site words it, e.g. `3:00 PM`.
Latest time, as the site words it, e.g. `11:00 PM`.
Youngest age a guest can check in at.
Whether pets are allowed, lower case: `yes`, `no`, `upon_request`.
Lower case, e.g. `free` or `charges_may_apply`.
Whether children may stay.
Youngest child age allowed.
Whether cribs are offered.
Whether extra beds are offered.
Bed charges for children, by age band.
Youngest age it covers.
Oldest age it covers; null for no upper limit.
Bed it is for, lower case: `crib`, `extra_bed` or `existing_bed`.
Price as the site words it in the property's currency, e.g. `£90`.
Lower case, e.g. `free`, `fixed` or `percentage`.
Lower case, e.g. `per_night` or `per_stay`.
Rooms above which a booking counts as a group, with other terms.
Quiet hours, when the property sets them.
Earliest time, as the site words it, e.g. `3:00 PM`.
Latest time, as the site words it, e.g. `11:00 PM`.
Curfew, when the property sets one.
Earliest time, as the site words it, e.g. `3:00 PM`.
Latest time, as the site words it, e.g. `11:00 PM`.
False when the property says parties are not allowed.
False when the property says smoking is not allowed.
Cards the property accepts, e.g. `Visa`.
Whether the property accepts cash.
Further house rules as the site words them, e.g. a local regulation or an ID requirement.
Guest questions with the property's answers, as the page shows them (up to 20).
The site's question id.
The guest's question.
The property's answer.
When it was asked, as the site words it.
When it was answered, as the site words it.
Whether the site marks it a preferred partner.
Whether it carries the site's LGBTQ+ friendly badge.
Whether the site marks it wheelchair accessible.
Whether it has a sustainability certification on the site.
Whether the site marks it newly opened.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
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
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.