# Social Fetch API - Booking.com endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 3 documented Booking.com operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/booking/search Search Booking.com properties Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/booking/search/get.mdx SDK: client.booking.searchProperties({ query: "London" }) Parameters: - query (required, string) - Where to stay: a city, region, district, landmark, airport or property name, e.g. `London`, `Cornwall` or `Heathrow Airport`. - checkIn (optional, string) - Check-in date, `YYYY-MM-DD`, today or later. Default 14 days from today. - checkOut (optional, string) - Check-out date, `YYYY-MM-DD`, after `checkIn` and at most 90 nights later. Default one night after check-in. - adults (optional, integer) - Adults travelling, 1 to 30. Default 2. - childrenAges (optional, array) - Ages of the children travelling, comma-separated, each 0 to 17, e.g. `5,9`. Omit when no children travel. - rooms (optional, integer) - Rooms needed, 1 to 30 and no more than the adults. Default 1. - currency (optional, string) - Currency of every price, as a three-letter code such as `USD`, `EUR`, `GBP` or `JPY`. Default `USD`. - language (optional, string) - 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`. - country (optional, string) - 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. - filters (optional, array) - 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. - sort (optional, string, enum: popularity | homes_first | price_lowest_first | price_highest_first | stars_highest_first | stars_lowest_first | stars_and_price | distance | review_score) - 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`. - limit (optional, integer) - Rows per page, 1 to 100. Default 25. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/booking/search?query=London" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/booking/property Get a Booking.com property Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/booking/property/get.mdx SDK: client.booking.getProperty({ url: "https://www.booking.com/hotel/gb/shangri-la-at-the-shard-london.html" }) Parameters: - url (required, string) - 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. - language (optional, string) - 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 (optional, string) - Currency of the prices the page shows (meals, extra beds), as a three-letter code such as `USD`, `EUR`, `GBP` or `JPY`. Default `USD`. Outcome field: `data.lookupStatus` in `found`, `not_found` 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" ## GET /v1/booking/properties/{propertyId}/reviews List Booking.com property reviews Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/booking/properties/propertyid/reviews/get.mdx SDK: client.booking.listPropertyReviews({ propertyId: "280149" }) Parameters: - propertyId (required, integer) - Booking.com property id, e.g. `280149` (The Savoy, London): `id` from the property search endpoint. - sort (optional, string, enum: relevance | newest | oldest | score_highest | score_lowest) - Order: `relevance` (the site's own), `newest`, `oldest`, `score_highest` or `score_lowest`. Default `relevance`. - language (optional, string) - Only reviews written in this language, as a code such as `en`, `fr`, `de` or `zh`. Omit for every language. - travellerType (optional, string, enum: families | couples | groups_of_friends | solo_travellers | business_travellers) - Only reviews by this kind of guest: `families`, `couples`, `groups_of_friends`, `solo_travellers` or `business_travellers`. Omit for all. - season (optional, string, enum: mar_may | jun_aug | sep_nov | dec_feb) - Only stays in these months: `mar_may`, `jun_aug`, `sep_nov` or `dec_feb`. Omit for the whole year. - query (optional, string) - Only reviews that mention this text, e.g. `breakfast`, up to 100 characters. - limit (optional, integer) - Rows per page, 1 to 25. Default 25. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/booking/properties/280149/reviews" \ -H "x-api-key: YOUR_API_KEY"