Official hotel websites API: Direct booking rates and parity checks

Endpoints

POST/v1/officialOfficial site rates4 credits

Example

Official site rates, with POST /v1/official. Set SCRAPERCOMPANY_API_KEY to your key and run it; the full parameter list is in the API reference.

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": "2026-12-25",
    "nights": 1,
    "currency": "USD"
  }'

200 response

{
  "search_parameters": {
    "engine": "official_brand_ihg",
    "source_url": "https://www.ihg.com/intercontinental/hotels/us/en/new-york/nychc/hoteldetail",
    "booking_url": "https://www.ihg.com/intercontinental/hotels/us/en/new-york/nychc/hoteldetail",
    "check_in_date": "2027-02-15",
    "check_out_date": "2027-02-16",
    "adults": 2,
    "currency": "USD"
  },
  "engine": "brand_ihg",
  "source_url": "https://www.ihg.com/intercontinental/hotels/us/en/new-york/nychc/hoteldetail",
  "booking_url": "https://www.ihg.com/intercontinental/hotels/us/en/new-york/nychc/hoteldetail",
  "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
  "observed_at": "2026-08-07T01:23:45.678Z",
  "property_ref": "NYCHC",
  "check_in": "2027-02-15",
  "check_out": "2027-02-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,
      "quantity": 9,
      "available": true,
      "cheapest_rate": 631,
      "rates": [
        {
          "currency": "USD",
          "rate_plan": "Reward Nights",
          "rate_code": "IVANI",
          "rate_category": "points",
          "rate_category_source": "brand_flag",
          "refundable": true,
          "access_type": "points",
          "loyalty_points": 123000,
          "loyalty_program": "IHG One Rewards",
          "points": 123000,
          "points_basis": "stay",
          "is_discounted": false
        }
      ]
    }
  ],
  "loyalty": {
    "program": "IHG One Rewards",
    "exposed_unauthenticated": {
      "program": "IHG One Rewards",
      "member": true,
      "points": true,
      "points_and_cash": true,
      "login_required_for": []
    },
    "rates_by_access_type": {
      "public": 2,
      "member": 2,
      "points": 1,
      "points_and_cash": 2,
      "corporate": 0,
      "qualified": 0
    },
    "public_best": {
      "room": "Premium Room",
      "room_code": "CDXG",
      "rate_plan": "Early Saver Rate",
      "price": 631,
      "currency": "USD"
    },
    "member_best": {
      "room": "Premium Room",
      "room_code": "CDXG",
      "rate_plan": "Early Saver Member Exclusive",
      "price": 612.07,
      "currency": "USD",
      "discount_vs_public": {
        "amount": 18.93,
        "percent": 3,
        "public_price": 631,
        "public_rate_plan": "Early Saver Rate",
        "currency": "USD",
        "basis": "room_cheapest_public"
      }
    },
    "points_best": {
      "room": "Premium Room",
      "room_code": "CDXG",
      "rate_plan": "Reward Nights",
      "access_type": "points",
      "points": 123000,
      "points_basis": "stay"
    },
    "points_plus_cash_best": {
      "room": "Premium Room",
      "room_code": "CDXG",
      "rate_plan": "Reward Nights (points + cash)",
      "access_type": "points_and_cash",
      "points": 103000,
      "points_basis": "stay",
      "cash_component": 149,
      "currency": "USD"
    },
    "points_value_cents_per_point": {
      "value": 0.513,
      "unit": "cents_per_point",
      "derivation": "derived",
      "formula": "(public_cash - cash_component) / points * 100",
      "currency": "USD",
      "room": "Premium Room",
      "public_cash": 631,
      "public_rate_plan": "Early Saver Rate",
      "cash_component": 0,
      "points": 123000,
      "points_rate_plan": "Reward Nights",
      "points_access_type": "points",
      "public_price_basis": "stay"
    }
  }
}