MCP + API · kestrel/hotel-rate-parity

Hotel Rate Parity Checker — OTA Price Comparison

Check hotel rate parity on Google Hotels by name or URL. Each stay compares OTA and official site rates: nightly price, cancellation, booking link, cheapest source, spread and direct booking rate. Find parity violations: who undercuts the hotel and by how much. Available rates only; rate shopping.

Open Actor Download MCP config

Connect this tool

Add this URL as a remote MCP server in your client, then sign in to Apify. For a client-specific setup, use Apify's configurator.

https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/hotel-rate-parity
Generic MCP client configuration
{
  "mcpServers": {
    "kestrel-hotel-rate-parity": {
      "url": "https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/hotel-rate-parity"
    }
  }
}

Understand the output before you run

Two row types share one dataset: parity (one property and stay with every booking source side by side and the parity math; charged) and status (per property and stay; never charged).

Declared dataset fields and row types · Output locations and dataset links

Use the declared dataset schema for item fields; the output schema describes where results are stored. Optional fields may be null or absent. If an integration shows a sampled schema without an optional field, check this declaration, the Actor instructions and actual returned rows before concluding that the field is unsupported.

Inspect 32 declared output fields
FieldTypeMeaning
typestringRow type: parity (charged) or status (free).
querystringThe input this row came from: the Google Hotels URL, entity token or property name as given.
hotel_namestring / nullProperty name as Google Hotels shows it.
entity_idstring / nullGoogle Hotels entity token; reuse it in the hotels input.
hotel_idstring / nullGoogle's numeric hotel id (name lookups only).
hotel_urlstring / nullGoogle Hotels page of the property.
starsinteger / nullHotel class, 1–5 (name lookups only).
ratingnumber / nullGoogle rating, 1–5 (name lookups only).
reviewsinteger / nullNumber of Google reviews (name lookups only).
check_instringCheck-in date, YYYY-MM-DD.
check_outstringCheck-out date, YYYY-MM-DD.
nightsinteger / nullNights in the stay.
adultsinteger / nullAdults per room used for pricing.
childreninteger / nullChildren per room used for pricing.
currencystring / nullCurrency of every price in the row (ISO code).
sourcesarray / nullEvery booking source Google lists for the stay, cheapest first: {source, source_id, official, price_nightly, price_total, free_cancellation, url}. url is the source's own booking link with the dates filled in when Google exposes it.
n_sourcesinteger / nullHow many sources carried a rate.
min_sourcestring / nullThe cheapest source.
min_pricenumber / nullNightly rate of the cheapest source.
max_sourcestring / nullThe dearest source.
max_pricenumber / nullNightly rate of the dearest source.
spread_pctnumber / null(max − min) ÷ min × 100, one decimal. The size of the parity gap across all sources.
median_pricenumber / nullMedian nightly rate across sources.
official_sourcestring / nullThe property's own listing (official site), when Google lists one.
official_pricenumber / nullNightly rate on the official site; null when Google lists no official site.
official_is_cheapestboolean / nullTrue when no source beats the official site; null when there is no official site.
undercut_byarray / nullSources cheaper than the official site, cheapest first. Empty when direct is the cheapest or there is no official site.
undercut_pctnumber / nullHow far the cheapest source beats the official site: (official − min) ÷ official × 100. 0 when direct is cheapest; null when there is no official site.
statusstring / nullStatus rows: ok, filtered, no_rates, not_found, duplicate, unpaid or error.
filteredboolean / nullStatus rows: true when minSpreadPct dropped the property (not billed).
errorstring / nullStatus rows: error message, null when the job succeeded.
fetched_atstringUTC timestamp of the fetch.

Start with a small sample

Use call-actor with the JSON below. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Change the target to match your request. This input validates against build 1.0.10; it is not a promise that the source has matching rows today.

{
  "actor": "kestrel/hotel-rate-parity",
  "input": {
    "hotels": [
      "https://www.google.com/travel/hotels/entity/ChkIhLCQwvjO2IYWGg0vZy8xMXE0bTZieDkyEAE"
    ],
    "checkIn": "30 days",
    "nights": 1,
    "currency": "USD"
  },
  "callOptions": {
    "maxTotalChargeUsd": 0.25,
    "timeout": 300
  },
  "waitSecs": 30
}

After completion, use get-dataset-items with storages.datasets.default.id. If still running, poll get-actor-run using the returned runId. Check status rows and errors before treating an empty dataset as no matches.

Call from Python, JavaScript or REST

Python SDK 3 example · JavaScript SDK 2 example · curl + jq example. Each uses this same small input, reads APIFY_TOKEN from your environment, sets a five-minute run timeout and exports all dataset row types as JSON Lines. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Inspect the run and source status before treating results as complete. Installation and usage.

Pricing and limits

Current listed event prices in USD. Some Actors charge for successful source checks even when no output rows match. The event descriptions below define those differences.

EventUSD eachWhat is charged
parity$0.01One hotel and stay with every booking site's rate (Booking.com, Expedia, Agoda…), cheapest and dearest, spread, median, official-site rate and who undercuts it (row keys hotel_name, entity_id, check_in, sources, min_source, min_price, max_source, max_price, spread_pct, median_price, official_price, undercut_by, undercut_pct): $10 per 1,000 rows (1 cent per hotel and stay). One row per hotel and stay however many sources (about 18, 4 to 36): 10 hotels × 7 dates (sweepDays 6) = 70 rows = $0.70. Not charged: hotels with no rate, rows under minSpreadPct, names that match nothing, duplicates, status rows. No start fee; proxy and compute are included in the event price. The run stops at the maximum cost per run you set when starting it (Apify run option maxTotalChargeUsd), never above it.

Contracts for agents

Public contract checked 2026-11-11. Active build: 1.0.10. Refresh live details before a large or recurring run.