# Booking.com rooms: `POST /v1/ota/booking/rooms`

Cost: 12 credits (12 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/booking-rooms

Booking.com room types and rate plans for one stay window.

Fills the gap left by `/v1/rooms`: Google's entity page frequently carries
no room detail for the Booking.com row, so this goes to Booking directly.

Prices come from the property page's room grid, enriched with room
size and occupancy when Booking.com provides them.

Each rate plan carries `tax_included` / `taxes_and_fees` from the page
JSON (amount wins even when the excludes list is empty), and
`partner_offer` for TPI rows. Partner `room_id` is set only when the
row reliably ties to a parent room; otherwise it is null.

Request body (JSON):

- `pagename` (string; required; min length 2): URL slug returned by `POST /v1/ota/booking/search`, e.g. `moxy-boston-downtown` from `booking.com/hotel/us/moxy-boston-downtown.html`.
- `country` (string; optional; default us; one of ad, ae, af, ag, ai, al, am, ao, aq, ar, as, at, au, aw, ax, az, ba, bb, bd, be, bf, bg, bh, bi, bj, bl, bm, bn, bo, bq, br, bs, bt, bv, bw, by, bz, ca, cc, cd, cf, cg, ch, ci, ck, cl, cm, cn, co, cr, cu, cv, cw, cx, cy, cz, de, dj, dk, dm, do, dz, ec, ee, eg, eh, er, es, et, fi, fj, fk, fm, fo, fr, ga, gb, gd, ge, gf, gg, gh, gi, gl, gm, gn, gp, gq, gr, gs, gt, gu, gw, gy, hk, hm, hn, hr, ht, hu, id, ie, il, im, in, io, iq, ir, is, it, je, jm, jo, jp, ke, kg, kh, ki, km, kn, kp, kr, kw, ky, kz, la, lb, lc, li, lk, lr, ls, lt, lu, lv, ly, ma, mc, md, me, mf, mg, mh, mk, ml, mm, mn, mo, mp, mq, mr, ms, mt, mu, mv, mw, mx, my, mz, na, nc, ne, nf, ng, ni, nl, no, np, nr, nu, nz, om, pa, pe, pf, pg, ph, pk, pl, pm, pn, pr, ps, pt, pw, py, qa, re, ro, rs, ru, rw, sa, sb, sc, sd, se, sg, sh, si, sj, sk, sl, sm, sn, so, sr, ss, st, sv, sx, sy, sz, tc, td, tf, tg, th, tj, tk, tl, tm, tn, to, tr, tt, tv, tw, tz, ua, ug, uk, um, us, uy, uz, va, vc, ve, vg, vi, vn, vu, wf, ws, xk, ye, yt, za, zm, zw): Two-letter segment before the slug in that URL.
- `check_in` (string (date); required): First night of the stay, `YYYY-MM-DD`.
- `nights` (integer; optional; default 1; min 1, max 30): Length of stay. Ignored when `check_out` is supplied.
- `adults` (integer; optional; default 2; min 1, max 8): Adults in the room. Two is the hotel default; pass one for a hostel, which is priced per bed. Any value 1-8 works.
- `rooms` (integer; optional; default 1; min 1, max 8): Rooms requested.
- `currency` (string; optional; default USD; one of AED, ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, CZK, DKK, EGP, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY, KRW, MXN, MYR, NOK, NZD, PEN, PHP, PLN, QAR, RON, SAR, SEK, SGD, THB, TRY, TWD, USD, VND, ZAR): ISO 4217 code for the returned prices. Major currencies include AED, AUD, BRL, CAD, CHF, CNY, EUR, GBP, HKD, INR, JPY, KRW, MXN, NZD, SGD, USD; all 39 supported codes are listed in the enum.
- `country_market` (string | null; optional; one of AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UK, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW): Visitor country (point of sale), two letters, e.g. `GB`. Booking and Agoda price by the visitor's country - measured 2026-10-03, Booking showed a GB visitor 321 USD where US and CA visitors saw 276 for the same night - so this asks for the price a visitor from that country sees. The answer's `point_of_sale` block says whether that country was actually served; when it was not, the price is the default market's. Omit for the previous behaviour.

Response fields:

- `pagename` (string; required)
- `hotel_id` (string; required): Empty string when the room catalogue was unavailable.
- `property_name` (string; required)
- `check_in` (string (date); required)
- `check_out` (string (date); required)
- `nights` (integer; required)
- `currency` (string; required): The requested currency.
- `requested_currency` (string; required): ISO 4217 code you asked for.
- `returned_currency` (string | null; required): ISO 4217 code the page priced in; null when it did not say.
- `hotel_currency` (string | null; required): The property's own currency (ISO 4217); null when not stated.
- `sold_out` (boolean | null; required)
- `availability` (string; required; one of available, sold_out, error): `available` (a plan is priced), `sold_out` (Booking.com marks the property sold out) or `error` (see `availability_reason`).
- `is_soldout` (boolean | null; required)
- `availability_reason` (string | null; required): Why the property is not `available`, in words (for example the page's room data was cut off, or rooms are listed but none is priced for these dates).
- `min_length_of_stay` (integer | null; required)
- `rendered` (boolean; required): False when the page came back without a populated room grid.
- `catalogue_from_graphql` (boolean; required): Whether room size / occupancy enrichment was available.
- `adults` (integer | null; required): Party size per room that `cheapest_rate` must seat.
- `children` (integer; required)
- `cheapest_rate` (number | null; required): Lowest `price` among plans that seat the party, in `returned_currency`.
- `cheapest_rate_basis` (string; required; one of requested_occupancy, occupancy_unknown, no_plan_fits, none): How `cheapest_rate` was chosen.
- `cheapest_rate_any_occupancy` (number | null; required)
- `cheapest_public_rate` (number | null; required): Lowest price for the party that needs no sign-in: member plans count at their `public_price`.
- `price_includes_tax` (boolean | null; required): True/False when every plan that says agrees; null otherwise. Check `tax_included` per plan.
- `collection_id` (string; required)
- `observed_at` (string; required)
- `rooms` (array of object; required)
  - `rooms[].name` (string; required)
  - `rooms[].room_id` (string; required)
  - `rooms[].beds` (string; required)
  - `rooms[].room_size` (number | null; required)
  - `rooms[].max_persons` (integer | null; required)
  - `rooms[].cheapest_rate` (number | null; required): Lowest price in this room that seats the party.
  - `rooms[].cheapest_rate_any_occupancy` (number | null; required)
  - `rooms[].rate_plans` (array of object; required)

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
