> **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/search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/booking/search.mdx>

---

# Booking.com Property Search API

Properties for any destination and stay, priced in your currency, up to 100 a page.

`GET /v1/booking/search` searches a destination for a stay. `query` is a city, region, district, landmark, airport or property name. `checkIn` defaults to 14 days from today (UTC) and `checkOut` to one night later; `adults` defaults to 2, `rooms` to 1, and `childrenAges` lists each child's age (`5,9`). `currency` (default `USD`), `language` (default `en-us`) and `country` (default `us`) set how prices and labels read: the site decides from the visitor country whether prices include taxes. `filters` takes the site's own filter ids (one the site does not apply is a free 400) and `sort` one of nine orders, lowest price first by default; `limit` is 1 to 100 (25 by default).

The answer names the `destination` the site matched, echoes the `stay` the prices are for and counts the properties (`totalCount`). Each property carries `id` (pass it to the reviews route), `name`, `url`, `accommodationType`, `stars`, `reviewScore`, `reviewCount`, `locationScore`, `address`, `latitude`, `longitude`, `district`, `distanceFromCentre`, `photo`, `freeCancellation`, `noPrepayment`, `mealPlan`, its `rooms` and a `price`: `amount` for the whole stay, `currency`, `taxesIncluded`, `taxesAndCharges` when added on top, `originalAmount` before a discount and `perNight` (the nightly room rate, without the per-night fees `amount` includes; US visitors only). The first page lists `availableFilters`. Pass `page.nextCursor` back as `cursor` while `page.hasMore` is true.

## Request

- **Endpoint:** `GET /v1/booking/search`
- **Credits:** 1 credit
Failed requests are free
A not-found answer is still charged
- **Input:** by destination and stay
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/booking/search/get)
- **Platform page:** [/platforms/booking](https://www.socialfetch.dev/platforms/booking)

## FAQ

### What stay are the prices for by default?

Check-in 14 days from today (UTC), one night, 2 adults, 1 room, in US dollars, as a visitor from the United States sees them. data.stay states the stay every price in the answer is for.

### Are taxes included in the price?

As on the site, that depends on the visitor country. With country=us prices are before taxes and charges, and price.taxesAndCharges says how much is added. With country=gb, de and most of Europe the price includes them. price.taxesIncluded tells you which.

### Why does a later page hold fewer than limit properties?

The default order, lowest price first, is the one the site pages consistently. The site reshuffles its popularity order between requests, so a property can move across a page boundary: one already returned is left out, never repeated, and counted in page.droppedCount, and a few can be missed. Use popularity for the site's own top picks, not for a complete walk.

### How many credits does a call cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
