Get a hotel's official-site rates
Read rooms and rate plans straight from the hotel's own booking engine.
Overview
POST /v1/official takes a hotel's website, finds its booking link, detects its booking engine (50+ supported), and returns the rooms and rate plans the hotel sells directly — including member rates where the engine shows them. You never pick the vendor.
Cost | 4 credits per successful call; 19 for the few hotel sites that need more work to read (the x-credits-charged header shows what a call cost) |
Latency | Usually a few seconds; a call can take up to a minute |
Input | The hotel's homepage or property page (a direct booking URL also works) and the stay dates |
Make the request
curl -X POST "https://api.scrapercompany.com/v1/official" \
-H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.ihg.com/intercontinental/hotels/us/en/new-york/nychc/hoteldetail", "check_in": "2027-01-15", "nights": 1, "currency": "USD"}'Read the rooms
Response (shortened)
{
"engine": "brand_ihg",
"detected_by": "url",
"check_in": "2027-01-15",
"check_out": "2027-01-16",
"nights": 1,
"currency": "USD",
"sold_out": false,
"cheapest_rate": 631,
"cheapest_member_rate": 612.07,
"member_rates_returned": 2,
"rooms_returned": 1,
"elapsed_s": 1,
"rooms": [
{
"name": "Premium Room",
"code": "CDXG",
"max_occupancy": 2,
"available": true,
"cheapest_rate": 631,
"rates": [
{
"price": 631,
"price_total": 779.26,
"currency": "USD",
"rate_plan": "Early Saver Rate",
"tax_inclusive": false,
"access_type": "public",
"is_discounted": false
},
{
"price": 612.07,
"price_total": 757.54,
"currency": "USD",
"rate_plan": "Early Saver Member Exclusive",
"tax_inclusive": false,
"access_type": "member",
"loyalty_program": "IHG One Rewards",
"is_discounted": false
},
{
"price": null,
"currency": "USD",
"rate_plan": "Reward Nights",
"access_type": "points",
"loyalty_program": "IHG One Rewards",
"points": 123000
}
]
}
]
}| Field | Meaning |
|---|---|
engine | The booking engine that was detected. |
cheapest_rate | Lowest public rate for the stay; cheapest_member_rate is the lowest member rate, when shown. |
rooms[].rates[] | Every rate plan per room: price, price_total, tax, fees, rate_plan, currency. |
access_type | public, member, points_and_cash or points. |
tax_inclusive | Whether price includes tax. null means the engine did not say, not that tax is excluded. |
Supported engines
The API supports over 50 booking engines, with more added regularly. Detection is automatic, so there is nothing to configure per hotel. When a hotel's engine is not supported yet, the call answers 422 and is not charged; ask support to add it.
When it fails
| Status | Meaning | What to do |
|---|---|---|
422 | The site's booking engine couldn't be identified or isn't supported (detail says which). | Try a direct booking URL, or ask support to add the engine. |
503 | The hotel's website or booking engine could not answer for now, or the engine failed. | Retry later with backoff, using the Retry-After header. Not charged. |
Questions about this page?
Send the page link and your question, and the team will answer.