Cheapest Room

Get the cheapest room at one hotel on one OTA — its name, its price including taxes and fees, its meal plan and whether it is refundable — instead of every room type and every rate. It is the same scrape as per-hotel OTA pricing with a much smaller answer.

Base URL: https://api.scrapeguys.com · Auth: X-API-Key: gsk_… with the ota:<slug> scope of the OTA you name · See the Overview.

Submit a job

The body is the /ota-price/ body: one hotel on one OTA for one stay. The fields that matter here are below; the Agoda guide is the full reference, and the Booking.com, MakeMyTrip and Expedia guides cover what differs per OTA.

Errors — 400 (validation, an unsupported ota or currency, a bare children count, children_ages on an OTA that cannot price them, a malformed ota_hotel_id, rooms above adults, a stay over 30 nights, or "ota '…' is not currently enabled"), 401 (missing, unknown or deactivated key), 403 (key lacks ota:<slug> for the OTA named), 429 (per-minute limit, or daily / monthly quota exhausted). No job is created on any of these.

Poll for results

Poll the poll_url every ~2 seconds until status is completed or failed. Statuses: pending → processing → completed | failed.

Errors — 404 ("Job not found." — unknown id, another client's job, or a Google Hotels scrape job, which polls on /scrape/), 401, 403 (key lacks the scope of the job's OTA).

Response schema

Which room

Of the rates the OTA quoted for your search, the one that costs least after taxes and fees among those that seat your party: ceil(adults / rooms) adults and ceil(children / rooms) children in one room, the same fit test as cheapest_fitting_price on the full matrix.

• Ranked on the all-in, not the pre-tax price. Tax is not a flat share of the price (India's hotel GST steps up above ₹7,500 a night), so the pre-tax order can name a rate that costs more once tax is on. It can therefore be a different rate from cheapest_fitting_price.
• Only stated taxes are added. A rate whose tax the OTA did not state cannot be compared, so it is not ranked against the rest. Only when no fitting rate states one does the cheapest of them stand in — by its pre-tax price, with price_includes_taxes: false.
• A bundle of rooms is never one room. Agoda can offer a package ("2 X Suite") to a party one room cannot seat; its price covers all of them, so it never counts as the room asked for.
• MakeMyTrip answers a party that no single room type matches with whole-booking combinations. A combination is priced per room as its share of the booking, and counts only when it was priced for exactly your adults, rooms and child ages — MakeMyTrip often re-splits a childful party into more rooms or re-prices the children as 12-year-olds, and such a combination is never used.
• Booking.com prices any number of rooms as that many of the one-room rate.

Faster answers from search data

For common searches, Cheapest Room answers from a lighter source than the OTA's full room list and falls back to the full route whenever the lighter one cannot give the same answer. The response shape is the same. Eligible jobs are one room, adults only, desktop; MakeMyTrip and Agoda also need INR, and Agoda jobs must not send tax_required.

• Booking.com — answered from Booking's search data. cancellation_text is worded as the hotel page words it, from the free-cancellation deadline in the property's local time. When search names no meal, meal_plan is "Room only" (EP).
• MakeMyTrip — answered from the hotel's card on the search listing. cancellation_text may omit the deadline ("Free Cancellation"), and on stays of several nights price is rounded to the whole rupee.
• Agoda — answered from Agoda's search results for the hotel. When two room types tie on price, the room named may be the other of the two.

The first request for a hotel on MakeMyTrip or Agoda is always answered from the full room list. In these cases the job's /ota-price/<job_id>/ view has result.source: "search" and holds only the one rate, not the full room matrix.

When cheapest_room is null

Next: Destination Search →