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
| Field | Type | Meaning |
|---|---|---|
type | string | Row type: parity (charged) or status (free). |
query | string | The input this row came from: the Google Hotels URL, entity token or property name as given. |
hotel_name | string / null | Property name as Google Hotels shows it. |
entity_id | string / null | Google Hotels entity token; reuse it in the hotels input. |
hotel_id | string / null | Google's numeric hotel id (name lookups only). |
hotel_url | string / null | Google Hotels page of the property. |
stars | integer / null | Hotel class, 1–5 (name lookups only). |
rating | number / null | Google rating, 1–5 (name lookups only). |
reviews | integer / null | Number of Google reviews (name lookups only). |
check_in | string | Check-in date, YYYY-MM-DD. |
check_out | string | Check-out date, YYYY-MM-DD. |
nights | integer / null | Nights in the stay. |
adults | integer / null | Adults per room used for pricing. |
children | integer / null | Children per room used for pricing. |
currency | string / null | Currency of every price in the row (ISO code). |
sources | array / null | Every 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_sources | integer / null | How many sources carried a rate. |
min_source | string / null | The cheapest source. |
min_price | number / null | Nightly rate of the cheapest source. |
max_source | string / null | The dearest source. |
max_price | number / null | Nightly rate of the dearest source. |
spread_pct | number / null | (max − min) ÷ min × 100, one decimal. The size of the parity gap across all sources. |
median_price | number / null | Median nightly rate across sources. |
official_source | string / null | The property's own listing (official site), when Google lists one. |
official_price | number / null | Nightly rate on the official site; null when Google lists no official site. |
official_is_cheapest | boolean / null | True when no source beats the official site; null when there is no official site. |
undercut_by | array / null | Sources cheaper than the official site, cheapest first. Empty when direct is the cheapest or there is no official site. |
undercut_pct | number / null | How far the cheapest source beats the official site: (official − min) ÷ official × 100. 0 when direct is cheapest; null when there is no official site. |
status | string / null | Status rows: ok, filtered, no_rates, not_found, duplicate, unpaid or error. |
filtered | boolean / null | Status rows: true when minSpreadPct dropped the property (not billed). |
error | string / null | Status rows: error message, null when the job succeeded. |
fetched_at | string | UTC 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.
| Event | USD each | What is charged |
|---|---|---|
parity | $0.01 | One 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
- Input schema and sample input
- Prepared MCP call and pricing events
- Full Actor instructions and limits
- REST API
Public contract checked 2026-11-11. Active build: 1.0.10. Refresh live details before a large or recurring run.