# Agoda rooms: `POST /v1/ota/agoda`

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

Agoda: every room type and rate plan for one stay window.

Request body (JSON):

- `property_id` (string; required; min length 1): Numeric id returned by `POST /v1/ota/agoda/search`, or from the Agoda URL — the digits in `agoda.com/…/hotel/…-h8795952.html`, or the `hotelId` query parameter.
- `check_in` (string (date); required): First night of the stay, `YYYY-MM-DD`.
- `check_out` (string (date) | null; optional): Departure date. An alternative to `nights` — if both are given, this wins.
- `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, AUD, BRL, CAD, CHF, CZK, EUR, GBP, HKD, IDR, INR, JPY, KRW, MYR, NZD, PHP, PLN, SEK, SGD, THB, TWD, USD, ZAR): One of 23 supported. Unlike Hotels.com these ARE comparable — Agoda converts one underlying rate.
- `tax_breakdown` (boolean; optional; default false): Also read Agoda's "per night before taxes" view and return each offer's `price_before_taxes` plus the derived stay `taxes_and_fees` (with its own provenance). Doubles the upstream request; same credit cost.
- `probe_min_stay` (boolean; optional; default true): Agoda answers a minimum-stay restriction as "sold out" (measured: Moxy Boston 2026-10-20 is sold out at 1-4 nights and priced at 7, the minimum Booking and Expedia state). When Agoda says sold out, re-ask the same check-in at 2, 3, 4, 5 and 7 nights and report `availability: min_stay` with `min_stay_quote` if one prices. False keeps Agoda's flag as is.
- `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 agoda_property)
  - `search_parameters.property_id` (string; required)
  - `search_parameters.check_in_date` (string (date); required)
  - `search_parameters.check_out_date` (string (date); required)
  - `search_parameters.adults` (integer; required)
  - `search_parameters.rooms` (integer; required)
  - `search_parameters.currency` (string; required)
- `property` (object; required)
  - `property.property_id` (string; required)
  - `property.name` (string; required)
  - `property.price_per_night` (number | null; required): Cheapest priced offer.
  - `property.currency` (string; required): ISO code of the cheapest offer (the requested currency when nothing priced).
  - `property.currency_display` (string | null; required)
  - `property.tax_inclusive` (boolean | null; required)
  - `property.sold_out` (boolean; required)
  - `property.provenance` (object | null; required): Provenance of the cheapest priced row; null when nothing priced.
  - `property.rooms` (array of object; required)
- `meta` (object; required)
  - `meta.source` (string; required; one of agoda)
  - `meta.collection_id` (string; required)
  - `meta.observed_at` (string; required)
  - `meta.nights` (integer; required)
  - `meta.elapsed_s` (number; required)
  - `meta.room_types` (integer; required)
  - `meta.offers` (integer; required)
  - `meta.comparable_across_markets` (boolean; required): Always true.

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)
