Search Booking.com properties
Search Booking.com properties for a destination and stay, with prices, ratings and review scores.
Headers
Get your API keyAPI key (`sfk_...`)
Where to stay: a city, region, district, landmark, airport or property name, e.g. `London`, `Cornwall` or `Heathrow Airport`.
min 1 chars · max 100 chars
Check-in date, `YYYY-MM-DD`, today or later. Default 14 days from today.
pattern: ^\d{4}-\d{2}-\d{2}$
Check-out date, `YYYY-MM-DD`, after `checkIn` and at most 90 nights later. Default one night after check-in.
pattern: ^\d{4}-\d{2}-\d{2}$
Adults travelling, 1 to 30. Default 2.
≥ 1 · ≤ 30
Ages of the children travelling, comma-separated, each 0 to 17, e.g. `5,9`. Omit when no children travel.
Rooms needed, 1 to 30 and no more than the adults. Default 1.
≥ 1 · ≤ 30
Currency of every price, as a three-letter code such as `USD`, `EUR`, `GBP` or `JPY`. Default `USD`.
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`.
Visitor country, as a two-letter code such as `us`, `gb`, `de` or `jp`. The site decides from it whether prices include taxes. Default `us`, where prices are shown before taxes and charges.
The site's own filters, comma-separated, e.g. `class=5` (5 stars), `review_score=90` (9+), `ht_id=204` (hotels) or `fc=2` (free cancellation). A first page lists them all in `availableFilters`. A filter the site does not apply to this search is answered with a 400, not charged, never with unfiltered results.
Order. `price_lowest_first` (default) is the order the site pages consistently: two 300-row walks of the same search share 275 to 300 rows. A row with a deal can sit a few places below where its discounted price would put it, as on the site. `popularity` is the site's own "top picks" order, with its paid placements (`sponsored`), but the site reshuffles it between requests: two 300-row walks of London shared 163 to 292 rows, and one walk returned up to 43 rows twice (dropped, see `page.droppedCount`), so paging it misses rows. Also `price_highest_first`, `stars_highest_first`, `stars_lowest_first`, `stars_and_price`, `homes_first`, `distance` (as consistent as price for a city or a landmark, less for a region or a country) and `review_score`.
one of: popularity, homes_first, price_lowest_first, price_highest_first, stars_highest_first, stars_lowest_first, stars_and_price, distance, review_score
Rows per page, 1 to 100. Default 25.
≥ 1 · ≤ 100
Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page.
min 1 chars · max 1024 chars · pattern: ^[A-Za-z0-9_-]+$
Endpoint-specific response payload.
`not_found` when the site matches the query to no destination.
one of: found, not_found
The matched destination; null when not found.
The site's id for the destination.
Destination type: `city`, `region`, `country`, `district`, `landmark`, `airport`, `hotel` and so on.
Destination name as the site resolved the query.
Two-letter country code, lower case.
The stay the prices are for, with every default filled in, so a later page or a repeat search can ask for the same stay.
Check-in date, `YYYY-MM-DD`.
Check-out date, `YYYY-MM-DD`.
Nights.
Adults.
Children's ages.
Rooms.
Currency the prices were asked in.
Language of the answer.
Visitor country the answer is for.
Properties the site counts for the stay. It moves slightly from request to request as availability changes.
Properties on this page. A property the page before returned, or one the site repeats within the page, is left out and counted in `page.droppedCount`, so a page can hold fewer than `limit`.
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
Guest review score, 1 to 10; null when not shown.
The score's word, e.g. `Superb`.
Guest reviews counted in the score.
Guest score for the location, 1 to 10, when shown.
Score from reviews collected elsewhere, for a property with few of its own, when shown.
Reviews behind `externalReviewScore`.
Street address.
City.
Two-letter country code, lower case.
Latitude.
Longitude.
Area as the site shows it, e.g. `Westminster Borough, London`.
Distance as the site words it, e.g. `0.3 miles from centre`.
Nearest station as the site words it, when shown.
Main photo URL. Link only; not hosted by Social Fetch.
Price of the stay; null when the property shows none.
Price of the whole stay for the rooms and guests asked, as the site shows it, in `currency`.
Currency of every amount here, e.g. `USD`.
The price as the site shows it, e.g. `US$205.12`.
Whether `amount` already includes taxes and charges. False when the site shows them on top (`taxesAndCharges`).
Taxes and charges the site adds on top of `amount`; null when `amount` includes them.
Price before a discount, when the site shows one; null otherwise.
The site's average nightly room rate, in `currency`, null when the site does not send it: it sends it only to visitors from the US, and not for every property. It leaves out the per-night fees a property charges on top of the room (a resort, facility or tourism fee) that `amount` includes, so `amount` can be more than `perNight` times the nights: a New York stay at $30 a night in fees shows $90 more over three nights. Before taxes, like `amount` for a US visitor.
The same stay in the property's own currency, when the site shows it.
The property's own currency, e.g. `GBP`.
Whether the property has nothing left for the stay.
Whether a free cancellation rate is offered.
Whether a rate without prepayment is offered.
Meals included, as the site words it, e.g. `Breakfast included`.
The rooms or units the price is for.
Room or unit name.
How many of it.
Beds in it.
Bedrooms in it, for a home.
Bathrooms in it, for a home.
Floor area as the site words it, when shown.
Facilities the site highlights on the row, e.g. `Fitness centre`.
Whether the row is a paid placement.
Whether the property holds a sustainability certification.
Filters the site offers for this search, on the first page only (empty on later pages).
Filter group key, e.g. `class` or `ht_id`.
Group name as the site shows it, e.g. `Property rating`.
The group's options.
Pass it in `filters`, e.g. `class=5`.
Option name as the site shows it, e.g. `5 stars`.
Properties it would leave, when shown.
Whether the search already applies it.
Pagination state for the current page.
Whether another page is available.
Pass as `cursor` to get the next page; null on the last page.
Position of this page's first row in the full list.
≥ 0
Rows the site sent for this page that were left out because the page before, or this page, already had them: the site's order moved between requests. This page holds that many fewer than it could; keep following `nextCursor`. 0 when nothing was dropped.
≥ 0
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/search?query=London" \
-H "x-api-key: YOUR_API_KEY"Responses
Booking.com properties for the stay.