Flagship endpoint

Price compare

Cross-OTA price comparison for one property — the flagship endpoint.

GET/v1/price-compare

Cross-OTA price comparison for one property — the flagship endpoint.

Credits5 credits

Cache TTL1 hour

ReturnsPriceCompare

ShapeSingle

Compare the price of one property across booking platforms in a single call, resolved through the Google Hotels backbone. The response carries the offers plus ScoutingAPI-computed min and median as first-class fields, so you can read the cheapest and typical cross-OTA price without re-deriving them. No cross-platform short-term-rental price-comparison API exists elsewhere — this is the wedge.

Parameters

Request parameters
Parameter	Type	Required	Default	Notes
`name`	`string`	One of	—	Property name to resolve.
`googleHotelId`	`string`	One of	—	Precise Google Hotels id.
`location`	`string`	One of	—	Disambiguating place / "lat,lng".
`checkIn`	`date`	Yes	—	YYYY-MM-DD; not in the past.
`checkOut`	`date`	Yes	—	Must be after checkIn.
`adults`	`integer`	No	`2`	≥ 1.
`children`	`integer`	No	`0`	≥ 0.
`childAges[]`	`integer[]`	No	—	Length must equal children.
`currency`	`string`	No	`USD`	ISO-4217; pass-through + echo.

Request & response

/v1/price-compare

Request

GET /v1/price-compare?name=Hotel%20X%20Sibenik&location=Sibenik,HR&checkIn=2026-07-13&checkOut=2026-07-20&adults=2&currency=EUR
Host: api.scoutingapi.com
Authorization: Bearer scout_live_…

Response

{
  "data": {
    "property": "Hotel X, Sibenik",
    "checkIn": "2026-07-13",
    "checkOut": "2026-07-20",
    "currency": "EUR",
    "min": 2122,
    "median": 2151,
    "offers": [
      { "ota": "booking.com", "totalPrice": 2122, "currency": "EUR", "url": "https://…" },
      { "ota": "expedia", "totalPrice": 2180, "currency": "EUR", "url": "https://…" }
    ]
  },
  "meta": {
    "requestId": "req_pc…",
    "platforms": ["google"],
    "cached": false, "partial": false,
    "creditsCharged": 5, "currency": "EUR", "pagination": null,
    "platformResults": [
      { "platform": "google", "status": "ok", "creditsCharged": 5, "cached": false, "count": 1 }
    ],
    "warnings": []
  }
}

Code samples

The same call in every language that matters — all returning the identical unified schema.

GET /v1/price-compare

curl -sS "https://api.scoutingapi.com/v1/price-compare?name=Hotel%20X%20Sibenik&location=Sibenik,HR&checkIn=2026-07-13&checkOut=2026-07-20&currency=EUR" \
  -H "Authorization: Bearer $SCOUTINGAPI_KEY"

Try it

Run this endpoint against the deterministic sandbox right now — a real 200, zero credits, no sign-up. The credit cost of the equivalent live call is 5 credits.

Try itsandbox · 0 credits · no sign-up

GET/v1/price-compare

namelocationcheckIncheckOutcurrencyAPI key (optional)

Runs against the deterministic Google Hotels sandbox fixture — a real 200, zero credits.

Response

Run the call to see a live, deterministic sandbox response.

Copy as curl

curl -sS "https://api.scoutingapi.com/v1/price-compare" \
  -H "Authorization: Bearer $SCOUTINGAPI_KEY"

Notes & gotchas

min & median are computed for you

Both min and median are first-class, ScoutingAPI-computed fields expressed in the response currency, derived across every offer's totalPrice. They are null only when there are no offers.

Flagship endpoint