Hotel Rate Feed for Revenue Management

Get competitor hotel prices for exact stay dates, nights, guests and currency. Only hotels that are confirmed to be the ones you asked for produce quotes, and each quote states what is still unknown. The output is built for hotel revenue management systems (RMS), rate-shopping dashboards and pricing analysts.

What this Actor adds over a raw scraper

Raw hotel-price scrapers return whatever the search engine finds for a name. In our tests the source returned a different Hilton for "Hilton Garden Inn Times Square Central". Fewer than a third of quotes named the room, and almost none stated taxes or cancellation terms. This Actor guards against that:

• Hotel identity check. A result is confirmed by Google hotel identifier (googleEntityToken) or by coordinates within a radius you set. Without either, the Actor checks that every distinguishing word of your hotel name appears in the returned name (a probable match). A different hotel is rejected as mismatch with the reason and is not charged.
• Comparability labels. Each quote is comparable, partial or not-comparable and lists unknownFields (room name, taxes and fees, cancellation policy, meal plan). A lower price is never presented as a parity violation.
• Change mode. With a named state store, changes mode returns only new quotes and price moves since the previous run, which suits daily RMS feeds.
• Match report. The SUMMARY record lists every requested hotel with its match status, returned hotel, offer count and min, median and official price.

Input

Field	Description
hotels	1–50 hotels: name, optional city, googleEntityToken or cid, latitude and longitude
stays	1–10 stays: nights (1–14) and either checkIn (YYYY-MM-DD) or checkInDaysAhead (0–365 days after the run date, UTC)
adults, children, rooms	Party size
currency, market	For example EUR and es, or USD and us
matchRadiusMeters	Coordinate tolerance, default 300 m
includeProbable	Set to false to deliver only identifier- or coordinate-confirmed hotels
mode, stateStoreId	snapshot, or changes with a named store
reportNewQuotes	In changes mode, set to false to receive only price moves of quotes already tracked
maxChildChargeUsd	Spending limit for the underlying price source in this run

Example:

{
  "hotels": [
    { "name": "H10 Metropolitan", "city": "Barcelona", "latitude": 41.387772, "longitude": 2.167697 },
    { "name": "Catalonia Plaza Catalunya", "city": "Barcelona" }
  ],
  "stays": [{ "checkInDaysAhead": 45, "nights": 2 }],
  "adults": 2,
  "currency": "EUR",
  "market": "es"
}

checkInDaysAhead is counted from the run date in UTC, so a saved task or schedule keeps asking for future dates. In changes mode prices are compared per exact stay date, so when the date moves forward, its quotes are reported as new quotes rather than price moves. Use checkIn when you track one fixed date.

Output

One dataset item per confirmed quote:

• hotelName, matchStatus (matched or probable), matchBasis (id, geo or name), matchReason
• checkIn, checkOut, nights, adults, children, rooms
• channel (seller, for example the official site or an OTA), official, roomName, totalPrice, perNight, currency
• comparability, unknownFields, taxesKnown, cancellationKnown
• change (new, price-up, price-down), previousPrice, observedAt, sourceRunId

Rejected hotels and hotels without offers appear only in the SUMMARY record. They are never charged.

Pricing

• $0.005 per delivered confirmed quote, plus a small start fee.
• Rejected hotels, empty results and unchanged quotes in changes mode are not charged.
• The underlying price source is billed separately. The Actor runs factden/google-hotels-scraper in your account. That actor charges its own published prices: in our tests $0.01–0.03 per stay for three hotels. maxChildChargeUsd caps that spend.

Data source and terms

Prices come from Google Hotels results collected by the third-party Actor factden/google-hotels-scraper. This Actor does not contact Google directly. Google's terms restrict automated access. You are responsible for checking that your use of the data complies with the terms that apply to you and to the source. Prices are observations at observedAt, not bookable offers, and they may exclude taxes, fees or conditions.

Limits

• Matching by name alone is probable, not proof. Add identifiers or coordinates for confirmed matches.
• Up to 50 hotels × 10 stays per run. One source run is made per stay.
• Room types, meal plans and cancellation terms are often missing in the source and are reported as unknown.