Endpoint reference

Price

A real price quote for one listing, for your dates and occupancy.

GET/v1/price

A real price quote for one listing, for your dates and occupancy.

Credits1 credit / platform

Cache TTL1 hour

ReturnsPrice

ShapeSingle

Quote one listing for specific dates and occupancy. Pass the numeric platformListingId returned by /v1/search (preferred) or a full listing URL. The response is always a real numeric price or a typed error — never a wrong property's price.

Parameters

Request parameters
Parameter	Type	Required	Default	Notes
`platform`	`enum`	Yes	—	vrbo \| booking \| airbnb \| google.
`listingId`	`string`	Yes	—	Use the numeric platformListingId from /v1/search, or pass a url.
`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

Request

GET /v1/price?platform=booking&listingId=abramovic2&checkIn=2026-07-13&checkOut=2026-07-20&adults=2&currency=EUR
Host: api.scoutingapi.com
Authorization: Bearer scout_live_…

Response

{
  "data": {
    "platform": "booking",
    "listingId": "abramovic2",
    "currency": "EUR",
    "nightlyPrice": 303,
    "totalPrice": 2122,
    "fees": { "cleaning": null, "service": null, "taxes": null },
    "nights": 7,
    "occupancy": { "adults": 2, "children": 2, "childAges": [8, 13] },
    "source": "booking",
    "url": "https://www.booking.com/hotel/hr/abramovic2.html"
  },
  "meta": {
    "requestId": "req_pr…",
    "platforms": ["booking"],
    "cached": false, "partial": false,
    "creditsCharged": 1, "currency": "EUR", "pagination": null,
    "platformResults": [
      { "platform": "booking", "status": "ok", "creditsCharged": 1, "cached": false, "count": 1 }
    ],
    "warnings": []
  }
}

Code samples

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

GET /v1/price

curl -sS "https://api.scoutingapi.com/v1/price?platform=booking&listingId=abramovic2&checkIn=2026-07-13&checkOut=2026-07-20&adults=2&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 1 credit / platform.

Try itsandbox · 0 credits · no sign-up

GET/v1/price

platformlistingIdcheckIncheckOutadultsAPI key (optional)

Runs against the deterministic Booking 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" \
  -H "Authorization: Bearer $SCOUTINGAPI_KEY"

Notes & gotchas

Vrbo has two id forms — pass the numeric one

Vrbo's numeric expediaPropertyId (returned by /v1/search as platformListingId) resolves cleanly; a bare URL slug can be unresolvable. Always pass the numeric id from /v1/search, or the full listing URL. A Vrbo bare-id quote resolves via a priced location search and surfaces a price_resolved_via_search warning; when no confident match/price is found you get a typed error, never a wrong price.