Endpoint reference

Listing

Full listing detail — amenities, photos, host, and optional live price.

GET/v1/listing/{platform}/{id}

Full listing detail — amenities, photos, host, and optional live price.

Credits1 credit / platform

Cache TTL24 hours

ReturnsProperty

ShapeSingle

Full normalized detail for one listing: amenities (canonical taxonomy), photos, host, geo, ratings, and — when you pass dates — an embedded live price. The detail body is cached 24 h; any embedded live price is cached at the 1 h price TTL and composed at read time, so a stale price never rides on fresh detail.

Parameters

Request parameters
Parameter	Type	Required	Default	Notes
`platform`path	`enum`	Yes	—	vrbo \| booking \| airbnb \| google.
`id`path	`string`	Yes	—	Platform-native listing id (case-sensitive, verbatim from source).
`checkIn`	`date`	No	—	Pairs with checkOut; presence embeds a live price.
`checkOut`	`date`	No	—	Must be after checkIn.
`adults`	`integer`	No	`2`	≥ 1 (only used with dates).
`children`	`integer`	No	`0`	≥ 0.
`childAges[]`	`integer[]`	No	—	Length must equal children.
`currency`	`string`	No	`USD`	ISO-4217.

Request & response

/v1/listing/{platform}/{id}

Request

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

Response

{
  "data": {
    "id": "stays_booking_abramovic2",
    "platform": "booking",
    "platformListingId": "abramovic2",
    "name": "Apartments Abramović",
    "propertyType": "apartment",
    "location": { "lat": 43.51, "lng": 16.44, "city": "Split", "country": "HR" },
    "guestRating": 9.1, "ratingScale": 10, "reviewCount": 142,
    "maxOccupancy": 4, "bedrooms": 2, "bathrooms": 1,
    "amenities": ["pool", "kitchen", "air_conditioning", "wifi"],
    "images": ["https://…"],
    "host": { "name": "Marko", "isSuperhost": false },
    "price": { "currency": "USD", "nightlyPrice": 303, "totalPrice": 2122, "nights": 7 }
  },
  "meta": {
    "requestId": "req_li…",
    "platforms": ["booking"],
    "cached": false, "partial": false,
    "creditsCharged": 1, "currency": "USD", "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/listing/{platform}/{id}

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

platformidcheckIncheckOutAPI 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/listing//" \
  -H "Authorization: Bearer $SCOUTINGAPI_KEY"

Notes & gotchas

Airbnb price re-verification

When dates are supplied for Airbnb, the embedded price is re-verified against the availability actor so the nights match your request. If it can't be confirmed, the detail still returns and a price_unverified warning is added.