ScraperCompany Hotel Rates API (All-in-One)

ScraperCompany Hotel Rates is the power-user Actor: it exposes every travel endpoint of the ScraperCompany API behind one input. Choose an endpoint (Google Hotels price calendar, OTA offers, destination search, Booking.com, Hotels.com, Expedia, Agoda, Tripadvisor, Vrbo, Hostelworld, Airbnb search and calendars, official hotel websites, cross-OTA rate comparison, Google Flights) and pass the same JSON body the API takes. Batch many requests across different endpoints in one run. If you prefer guided forms, each source also has its own dedicated Actor.

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?

• 40+ travel endpoints in one Actor, each billed at its own price.
• Google Hotels: price calendars (330 nights), OTA offers, room matrix, stay prices, destination search, details, reviews.
• OTAs: Booking.com, Hotels.com, Expedia, Agoda, Tripadvisor, Vrbo, Hostelworld rates, rooms, search and reviews.
• Airbnb search and priced availability calendars; official hotel websites (30+ booking engines).
• Rate comparison across four OTAs, and Google Flights search, date grid and booking options.
• Batch mixed endpoints with requests; relative dates like "30 days" work in any date field.

Endpoints

Endpoint	What it returns	Price per request
/v1/search	Google Hotels: find property token by name	$0.002
/v1/calendar	Google Hotels: price calendar (up to 330 nights)	$0.008
/v1/serp/google_hotels_calendar	Google Hotels: price calendar, SERP format	$0.008
/v1/stay	Google Hotels: price one stay window	$0.005
/v1/offers	Google Hotels: every OTA's offer for a stay	$0.005
/v1/rooms	Google Hotels: room matrix across OTAs	$0.005
/v1/serp/google_hotels_property	Google Hotels: property offers, SERP format	$0.005
/v1/hotels/search	Google Hotels: destination search	$0.005
/v1/serp/google_hotels	Google Hotels: destination search, SERP format	$0.005
/v1/hotels/property	Google Hotels: property details	$0.005
/v1/hotels/resolve	Google Hotels: resolve name with address	$0.018
/v1/hotels/reviews	Google Hotels: reviews	$0.003
/v1/official	Official hotel website rates	$0.006
/v1/ota/booking	Booking.com: price calendar (up to 365 dates)	$0.012
/v1/ota/booking/rooms	Booking.com: rooms and rate plans	$0.012
/v1/ota/booking/search	Booking.com: find hotel slug	$0.002
/v1/ota/booking/reviews	Booking.com: reviews	$0.003
/v1/ota/hotels	Hotels.com: headline price	$0.012
/v1/ota/hotels/rooms	Hotels.com: rooms and rate plans	$0.012
/v1/ota/hotels/search	Hotels.com: find property id	$0.002
/v1/ota/hotels/reviews	Hotels.com: reviews	$0.003
/v1/ota/expedia	Expedia: rooms and rates	$0.012
/v1/ota/expedia/search	Expedia: find property id	$0.002
/v1/ota/expedia/reviews	Expedia: reviews	$0.003
/v1/ota/agoda	Agoda: rooms and rates	$0.012
/v1/ota/agoda/search	Agoda: find property id	$0.002
/v1/ota/tripadvisor	Tripadvisor: OTA offers for a stay	$0.012
/v1/ota/tripadvisor/search	Tripadvisor: find location id	$0.002
/v1/ota/tripadvisor/reviews	Tripadvisor: reviews	$0.003
/v1/ota/vrbo	Vrbo: listing quote	$0.012
/v1/ota/vrbo/search	Vrbo: destination search	$0.002
/v1/ota/hostelworld	Hostelworld: rooms and rates	$0.012
/v1/ota/compare	Compare Booking.com, Hotels.com, Agoda, Expedia	$0.03
/v1/serp/airbnb	Airbnb: search	$0.012
/v1/airbnb/calendar	Airbnb: availability calendar with prices	$0.012
/v1/serp/airbnb_property_availability_calendar	Airbnb: availability calendar, SERP format	$0.012
/v1/serp/google_flights	Google Flights: search	$0.005
/v1/serp/google_flights_return	Google Flights: return / next-leg options	$0.005
/v1/serp/google_flights_booking	Google Flights: booking options	$0.005
/v1/serp/google_flights_calendar	Google Flights: date-grid prices	$0.008
/v1/serp/google_flights_location_search	Google Flights: airport/city lookup	$0.002

What data can you extract?

Field	Description
endpoint	Endpoint that served the request
input	The exact body sent
(endpoint fields)	Every field the endpoint returns, unchanged: see each endpoint in the API reference
request_id / billed / scraped_at	Traceability and billing

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 ScraperCompany Hotel Rates API (All-in-One)

1. Open ScraperCompany Hotel Rates API (All-in-One) in Apify Console and go to the Input tab.
2. Pick an Endpoint and write its Request body in JSON (the default prices a Google Hotels calendar for 30 nights). To batch, fill Batch of requests with {"endpoint": ..., "body": ...} objects.
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 prices 30 nights for the example Google Hotels property. A batch looks like {"requests": [{"endpoint": "/v1/ota/agoda", "body": {"property_id": "8795952", "check_in": "30 days"}}, {"endpoint": "/v1/ota/booking/search", "body": {"name": "Moxy Boston Downtown", "city": "Boston"}}]}.

{
  "endpoint": "/v1/calendar",
  "body": {
    "token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
    "days": 30,
    "currency": "USD",
    "market": "US"
  },
  "includeErrors": true,
  "maxConcurrency": 3,
  "maxRetries": 2
}

Output example

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

{
  "endpoint": "/v1/calendar",
  "input": {
    "token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
    "days": 30,
    "currency": "USD",
    "market": "US"
  },
  "calendar_elapsed_s": 0.14,
  "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
  "coverage": "84/84",
  "elapsed_s": 0.31,
  "market": "US",
  "observed_at": "2026-08-07T01:23:45.678Z",
  "rates": [
    {
      "adults": 2,
      "currency": "USD",
      "fees": 25,
      "implied_tax_rate": 0.203217,
      "los": 1,
      "market": "US",
      "provenance": {
        "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
        "collector": "scrapingme.google_calendar",
        "derivation": "normalized_upstream",
        "egress_mode": "direct",
        "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
        "observed_at": "2026-08-07T01:23:45.678Z",
        "price_basis": "room_base_before_taxes_and_fees",
        "requested_currency": "USD",
        "requested_market": "US",
        "returned_currency": "USD",
        "schema_version": 1,
        "source": "google_hotels_calendar",
        "source_kind": "calendar",
        "source_property_id": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
        "upstream_rate_id": null
      },
      "rate": 332.01,
      "rate_base": 332.01,
      "rate_total": 424.48,
      "rates_include_tax": false,
      "stay_date": "2026-08-04",
      "tax": 67.47
    }
  ],
  "requested_days": 90,
  "tax_profile": {
    "implied_tax_rate": 0.2032,
    "rates_include_tax": false
  },
  "token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
  "unpriced_dates": [
    "2026-08-19"
  ],
  "validation": {
    "ok": true,
    "problems": []
  },
  "wire_bytes": 29804,
  "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
search-request	A search or lookup endpoint: property token, OTA id search, Vrbo search, airport lookup.	$0.002	$2.00
review-page	One page of reviews from Google Hotels, Booking.com, Expedia, Hotels.com or Tripadvisor.	$0.003	$3.00
property-request	Google Hotels offers, rooms, stay, details or destination search; Google Flights search, return or booking options.	$0.005	$5.00
official-request	Rates from a hotel's own booking engine.	$0.006	$6.00
calendar-request	Google Hotels price calendar or Google Flights date grid.	$0.008	$8.00
ota-request	Booking.com, Hotels.com, Expedia, Agoda, Tripadvisor, Vrbo, Hostelworld rates; Airbnb search or calendar.	$0.012	$12.00
resolve-request	Hotel name resolved to candidates with address and phone.	$0.018	$18.00
comparison-request	One hotel compared across Booking.com, Hotels.com, Agoda and Expedia.	$0.03	$30.00
offers-page	Google Hotels calendar with mainstream basis or source spot-checks: one per extra offers page.	$0.005	$5.00
priced-night	One Airbnb check-in date priced with Airbnb's own quote.	$0.0015	$1.50

Each endpoint is charged at its own price (see the table above). For example, 1,000 Google Hotels calendars cost $8.00, 1,000 Booking.com price calendars $12.00, and 1,000 property-token lookups $2.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.

Where are the request fields documented?

In the ScraperCompany API reference at https://api.scrapercompany.com/docs. The body you send here is passed to the endpoint unchanged (except relative dates, which are converted to YYYY-MM-DD).

Should I use this or a dedicated Actor?

Use the dedicated Actors (Booking.com, Google Hotels, Airbnb, ...) for guided forms and tailored dataset views. Use this one when you already know the API or need several endpoints in one run.

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/scrapercompany-hotel-rates').call({
    "endpoint": "/v1/ota/agoda",
    "body": {
        "property_id": "8795952",
        "check_in": "30 days",
        "nights": 1,
        "currency": "USD"
    }
});
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/scrapercompany-hotel-rates").call(run_input={
    "endpoint": "/v1/ota/agoda",
    "body": {
        "property_id": "8795952",
        "check_in": "30 days",
        "nights": 1,
        "currency": "USD",
    },
})
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

• Google Hotels Price Calendar Scraper
• Booking.com Hotel Rates Scraper
• Hotel Price Comparison

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.