Hotels.com Rates Scraper

Hotels.com Rates Scraper prices hotels on Hotels.com for the stay you choose. Headline price returns the nightly and total price Hotels.com shows, with currency verification and the reason when a stay cannot be booked (minimum stay, sold out). Rooms lists every room type and rate plan. Find property id turns a hotel name into its Hotels.com id. Use it for rate shopping, parity checks against Expedia and Booking.com, and travel price research.

Powered by the ScraperCompany API: requests, proxies, retries and anti-bot handling run on ScraperCompany's servers, so you don't need your own proxies or API key. Start a run, get structured JSON.

What can this scraper do?

• Headline nightly and total price for any stay of 1-30 nights.
• Every room type and rate plan in Rooms mode.
• 11 Hotels.com sites: US, UK, Canada, Australia, New Zealand, Ireland, Germany, France, Italy, Netherlands and EU, each in its own currency.
• Reports why a stay is unavailable (minimum stay, sold out) instead of an empty answer.
• Find property id from a hotel name and city.

Modes

Mode	What it returns	Price per request
rates	Nightly and total price for one stay, with currency and availability	$0.012
rooms	Every room type and rate plan for one stay	$0.012
search	Hotels.com property id for a hotel name and city	$0.002

What data can you extract?

Field	Description
property.price_per_night / nightly	Nightly price shown by Hotels.com
property.total / total_text	Total price for the stay
property.currency / currency_verified	Returned currency and whether it matched the request
property.available / unavailable_reason	Availability and reason when not bookable
rooms[].name / cheapest_rate / rate_plans	Room types and rate plans (Rooms mode)
matches[] / recommended_match	Candidates with property id, address, coordinates and confidence (Find property id mode)
provenance	Where and when the price was observed

Every dataset item also carries input (the exact request that was sent), request_id (quote it to support), billed and scraped_at.

How to use Hotels.com Rates Scraper

1. Open Hotels.com Rates Scraper in Apify Console and go to the Input tab.
2. Enter Hotels.com property ids (digits after /h in the hotel URL), a check-in date and a market. Only know the name? Use Find property id mode.
3. Adjust the options if needed. Dates accept an exact date (2026-12-01) or a relative one (30 days from today), so saved tasks and schedules never go stale.
4. Click Start and wait for the run to finish.
5. Download the results from the Output tab as JSON, CSV, Excel or HTML, or fetch them with the Apify API.

Input example

This is the default input; running the Actor without changes uses it.

{
  "mode": "rates",
  "propertyIds": [
    "12570"
  ],
  "check_in": "30 days",
  "hotelNames": [
    "Moxy Boston Downtown"
  ],
  "includeErrors": true,
  "maxConcurrency": 3,
  "maxRetries": 2
}

Output example

One dataset item per request (trimmed here; real items contain every field the API returns):

{
  "mode": "rates",
  "endpoint": "/v1/ota/hotels",
  "input": {
    "property_id": "12570",
    "check_in": "2026-10-31"
  },
  "meta": {
    "comparable_across_markets": false,
    "egress_mode": "direct",
    "elapsed_s": 2.35,
    "nights": 1,
    "source": "hotels",
    "wire_bytes": 6066
  },
  "property": {
    "available": true,
    "currency": "USD",
    "currency_verified": true,
    "fees_included": null,
    "lead_text": "$475",
    "nightly": 374,
    "nightly_text": "$374 nightly",
    "price_per_night": 475,
    "price_per_night_is": "stay_total",
    "property_id": "12570",
    "provenance": {
      "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
      "collector": "scrapingme.ota.hotels",
      "derivation": "parsed_display_price",
      "egress_mode": "direct",
      "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
      "observed_at": "2026-08-07T01:23:45.678Z",
      "price_basis": "stay_headline",
      "requested_currency": "USD",
      "requested_market": "US",
      "returned_currency": "USD",
      "schema_version": 1,
      "source": "hotels_com",
      "source_kind": "ota_offer",
      "source_property_id": "12570",
      "upstream_rate_id": null
    },
    "taxes_and_fees_included": null,
    "total": 475,
    "total_text": "$475",
    "unavailable_reason": null
  },
  "search_parameters": {
    "adults": 2,
    "check_in_date": "2026-11-17",
    "check_out_date": "2026-11-18",
    "currency": "USD",
    "engine": "hotels_property",
    "market": "US",
    "property_id": "12570"
  },
  "request_id": "req_3f9c0d6e2b8a4c1f9e7d5b3a1c0e8f6d",
  "billed": true,
  "scraped_at": "2026-10-01T14:03:27.512Z"
}

A request that fails is saved with an error message instead (turn off Include failed requests to skip those). Failed requests are never charged.

How much does it cost?

This Actor uses pay-per-event pricing: you pay for successful API requests, not for compute time.

Event	Charged when	Price	Per 1,000
rates-request	One property priced for one stay: headline price, or every room type and rate plan.	$0.012	$12.00
search-request	One hotel name looked up on Hotels.com (returns its property id).	$0.002	$2.00

For example, 1,000 requests in the default mode cost $12.00.

• Failed requests (errors, invalid input, blocked upstream after retries) are free.
• Requests where the source returns nothing at all (no results, nothing priced) are saved but not charged.
• Set Maximum cost per run when you start a run and the Actor stops cleanly before going over it.

FAQ

Do I need proxies or a ScraperCompany API key?

No. Proxy rotation, retries and anti-bot handling run on the ScraperCompany side, and the Actor is already connected to the API. You only pay the per-event prices above.

Why can't I compare prices between markets?

Hotels.com shows prices on a different basis per country (with or without taxes and fees), so a US and a UK price for the same room are not directly comparable. Compare within one market.

Is the Hotels.com id the same as the Expedia id?

Often, but not always. Use each site's own Find property id mode to be sure.

Is it legal to scrape this data?

The Actor collects publicly available information that anyone can see without logging in. You are responsible for how you use the results: respect the source site's terms, copyright and privacy law (such as GDPR) and do not collect personal data without a lawful basis. If in doubt, ask a lawyer.

What happens when a request is blocked or rate-limited?

Rate limits (HTTP 429) and temporary errors (5xx) are retried automatically with exponential backoff, respecting Retry-After. If a request still fails it is saved with the error message and not charged, and the rest of the batch keeps going. A run only fails when every request failed.

Why did a request return an error?

Read the error field: validation problems (for example a malformed date or an unknown id) are reported exactly as the API sees them. Fix the input and run again; failed requests cost nothing.

How many requests can I run at once?

Any number per run. The Actor sends up to 3 requests in parallel by default (change it under Run options); larger batches simply take longer.

Use it from your code

Call the Actor from any language through the Apify API. With the JavaScript client (npm install apify-client):

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('scrapercompany/hotels-com-rates-scraper').call({
    "mode": "rates",
    "propertyIds": [
        "12570"
    ],
    "check_in": "30 days"
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

With Python (pip install apify-client):

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("scrapercompany/hotels-com-rates-scraper").call(run_input={
    "mode": "rates",
    "propertyIds": ["12570"],
    "check_in": "30 days",
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

You can also schedule runs, chain them with webhooks, or connect them to Make, Zapier, n8n, Google Sheets and other integrations from the Integrations tab.

Related scrapers

• Expedia Hotel Rates Scraper
• Booking.com Hotel Rates Scraper
• Hotel Reviews Scraper

Support

Questions, a field you need, or a site that stopped working? Open an issue on the Issues tab or contact us at scrapercompany.com. Include the request_id from the dataset item so we can trace the request.