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

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

Booking.com forward horizon — 61 dates per call.

`price` is the hotel's undiscounted base rate per night, before Booking
promotions and excluding taxes and charges, not the payable rate. It
equals the crossed-out price only on hotels running a Late Escape Deal
(OYO Red Hill Chennai, 2026-10-17: calendar 3,323 INR = crossed-out
3,322.57 vs 1,196 INR payable + 93.81 taxes and charges); other deals
strike through a lower figure. For payable prices and parity use
`POST /v1/ota/booking/rooms`; use this for availability and trend.

12 credits when at least one night is priced; free when the calendar is
empty or every day is unpriced. A partial calendar (some priced nights)
is charged in full. Sold-out rooms on
`POST /v1/ota/booking/rooms` stay charged.

Request body (JSON):

- `pagename` (string; required; min length 2): URL slug returned by `POST /v1/ota/booking/search`. For `booking.com/hotel/us/moxy-boston-downtown.html` the slug is `moxy-boston-downtown` and `country` is `us`.
- `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; min length 2, max length 2): The two-letter segment in the URL *before* the slug — part of the property's address on Booking, not your own location.
- `start` (string (date) | null; optional): Defaults to today.
- `days` (integer; optional; default 61; min 1, max 365): Booking truncates any single response to 61 days, so larger windows are paged automatically — a year is 6 calls, not 1.
- `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.
- `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.
- `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:

- `search_parameters` (object; required)
  - `search_parameters.engine` (string; required; one of booking_calendar)
  - `search_parameters.pagename` (string; required)
  - `search_parameters.country` (string; required)
  - `search_parameters.start_date` (string (date); required)
  - `search_parameters.days` (integer; required)
  - `search_parameters.currency` (string; required)
  - `search_parameters.adults` (integer; required)
  - `search_parameters.rooms` (integer; required)
- `property` (object; required)
  - `property.pagename` (string; required)
  - `property.hotel_id` (integer | null; required): Booking.com's numeric hotel id as returned upstream.
- `calendar` (array of object; required)
  - `calendar[].stay_date` (string (date); required)
  - `calendar[].available` (boolean; required)
  - `calendar[].price` (number | null; required): Null for unsellable dates.
  - `calendar[].currency` (string; required)
  - `calendar[].min_length_of_stay` (integer | null; required)
  - `calendar[].provenance` (object; required): Where, when and how one normalized price was observed.
- `unavailable_dates` (array of string (date); required)
- `meta` (object; required)
  - `meta.source` (string; required; one of booking)
  - `meta.collection_id` (string; required)
  - `meta.observed_at` (string; required)
  - `meta.calls` (integer; required)
  - `meta.elapsed_s` (number; required)
  - `meta.dates` (integer; required)
  - `meta.priced` (integer; 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)
