> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/booking>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/booking.mdx>

---

# Booking.com API. Stays, prices and reviews as JSON.

Property search for a destination and stay, priced in your currency, property details with rooms and house rules, and guest reviews with category scores. 3 routes under `/v1/booking`, one credit per request.

- 3 routes
- Prices + reviews
- 1 credit per request

Social Fetch exposes 3 routes under `/v1/booking`. Every response uses the `{ data, meta }` envelope and carries `data.lookupStatus`: `found` or `not_found`. HTTP 200 only means the request finished, so branch on `lookupStatus` before storing a row.

`GET /v1/booking/search?query=London` searches a destination (a city, region, district, landmark, airport or property name) for a stay. With no dates the stay starts 14 days from today for one night; with no guests it is 2 adults in 1 room; prices are in US dollars, in US English, as a visitor from the United States sees them. Set `checkIn`, `checkOut`, `adults`, `childrenAges`, `rooms`, `currency`, `language` and `country` to change any of that; `data.stay` echoes the stay the prices are for. Each property carries its `id`, name, link, type, stars, review score, location, photo and a `price` for the whole stay with its `currency` and whether taxes are included (`taxesIncluded`, and `taxesAndCharges` when they are added on top). The first page also lists every filter the site offers for the search in `availableFilters`; pass their ids, such as `class=5` or `fc=2`, in `filters`.

`GET /v1/booking/property?url=https://www.booking.com/hotel/gb/shangri-la-at-the-shard-london.html` reads one property by its page URL, the `url` of a search result: description, address and coordinates, review and category scores, brand, facilities and highlights, meals, rooms with their beds, size and occupancy (no prices, which depend on dates), up to 200 photos, house rules and policies, and guest questions with the property's answers.

`GET /v1/booking/properties/{propertyId}/reviews` pages through a property's guest reviews, 25 at a time, with the guests' average score per category. Take `propertyId` from the `id` of a search result or property.

## What you can get

- Property search for any destination with dates, adults, children's ages and rooms, up to 100 properties a page.
- Prices for the whole stay in any of 52 currencies, with the taxes and charges stated, the price before a discount and the property's own currency.
- Stars, review score and count, location score, address, coordinates, district, distance from the centre, photo, meals, cancellation and prepayment terms.
- The site's own filters (stars, review score, property type, free cancellation, meals, facilities, brands) and nine sort orders.
- Property details by page URL: description, address, brand, languages spoken, facilities and highlights, meals, rooms with beds, size and occupancy, and up to 200 photos.
- House rules and policies: check-in and check-out times, pets, children and extra beds, accepted cards, quiet hours, plus guest questions with the property's answers.
- Every guest review of a property: score, title, liked and disliked text, guest country and traveller type, room, dates, photos and the property's reply.
- Category scores for staff, facilities, cleanliness, comfort, value, location and wifi, and filters for language, traveller type, season and text.

## Booking.com endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Property search | GET /v1/booking/search | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/booking/search/get) |
| Property | GET /v1/booking/property | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/booking/property/get) |
| Property reviews | GET /v1/booking/properties/{propertyId}/reviews | 1 credit Failed requests are free A not-found answer is still charged | [docs](https://www.socialfetch.dev/docs/api/v1/booking/properties/propertyid/reviews/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try every Booking.com route on real destinations and properties.
2. **Search, open a property, read reviews.** Call `GET /v1/booking/search?query=London&currency=EUR&childrenAges=6`, pass a result's `url` to `GET /v1/booking/property` for its rooms and policies, and its `id` to `GET /v1/booking/properties/{propertyId}/reviews`. Send `x-api-key` on every request.
3. **Branch, page and bill.** Check `data.lookupStatus` before writing a row. Follow `page.nextCursor` while `page.hasMore` is true. Bill from `meta.creditsCharged` and log `meta.requestId` for support.

## Pricing

Every Booking.com route charges 1 credit per completed request, a not-found answer included. Credits never expire on pay-as-you-go packs. `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Booking.com's own APIs are for its affiliate and connectivity partners. Social Fetch returns the public search results, property pages and guest reviews any visitor sees, under one JSON envelope with typed `lookupStatus` values and absolute links. Photos are linked, never rehosted.

## FAQ

### Is there a Booking.com API for hotel prices and reviews?

Yes. Social Fetch has 3 Booking.com routes under /v1/booking: property search with prices for a stay, a property's details, rooms and policies, and its guest reviews. Authenticate with your Social Fetch API key in x-api-key.

### What stay are the prices for if I leave the dates out?

Check-in 14 days from today (UTC) and check-out one night later, for 2 adults in 1 room, in US dollars, as a visitor from the United States sees them. data.stay in the response states the dates, guests, currency, language and country the prices are for.

### Do prices include taxes?

It depends on the visitor country, as on the site itself. For the default country, us, prices are before taxes and charges: price.taxesIncluded is false and price.taxesAndCharges holds the amount added on top. For countries such as gb or de the price includes them and taxesIncluded is true. price.currency is always stated.

### How do I filter by stars, review score or free cancellation?

Pass the site's own filter ids, comma-separated, in filters: class=5 for 5 stars, review_score=90 for 9+, ht_id=204 for hotels, fc=2 for free cancellation, mealplan=1 for breakfast included. The first page of any search lists every filter it offers in availableFilters, with labels and counts.

### Can I page through every property in a destination?

Yes. Pass page.nextCursor back as cursor while page.hasMore is true; the cursor keeps the first page's stay. The default order, lowest price first, holds still between requests. The popularity order is reshuffled by the site, so with sort=popularity a property already returned is never repeated (page.droppedCount counts those left out) but a few can be missed.

### How do I get a property's rooms, facilities and house rules?

Pass the property's page URL, the url of a search result, to GET /v1/booking/property. It returns the description, facilities, meals, rooms with beds and occupancy, photos, policies and guest questions. Room prices depend on dates, so they come from the search.

### How do I get the reviews of a property?

Take the property's id from a search result or from GET /v1/booking/property and call GET /v1/booking/properties/{propertyId}/reviews. Reviews come 25 a page, sorted by relevance, newest, oldest or score, and can be filtered by language, travellerType, season and query text. scores holds the guests' average for each category.

### How much does the Booking.com API cost?

Every Booking.com route charges 1 credit per completed request. New accounts start with 100 free credits. Check meta.creditsCharged on each response for the amount actually billed.

### Does HTTP 200 mean the destination or property exists?

No. HTTP 200 means the request finished. Check data.lookupStatus: found means it was matched, not_found means the site matches the query to no destination, or no property has that URL or id. A property with no reviews yet is found with totalCount 0.

## Related

- [Booking.com Property Search API](https://www.socialfetch.dev/platforms/booking/search): Properties for a destination and stay, with prices and review scores (`GET /v1/booking/search`).
- [Booking.com Property API](https://www.socialfetch.dev/platforms/booking/property): A property's details, rooms, facilities and policies by page URL (`GET /v1/booking/property`).
- [Booking.com Reviews API](https://www.socialfetch.dev/platforms/booking/properties-propertyid-reviews): Every guest review of a property, with category scores (`GET /v1/booking/properties/{propertyId}/reviews`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language hotel or review question to the matching Booking.com operation.
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Booking.com tools from Cursor or Claude with the same credit metering as REST.
