Skip to content
Docs

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
        }
      ]
    }
  ]
}
FieldMeaning
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

StatusMeaningWhat 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.

Parity monitoring

Pair this with OTA rates for the same night to see whether any channel undercuts the hotel's own price.

Questions about this page?

Send the page link and your question, and the team will answer.

Email support