Endpoint reference
Availability
Day-by-day availability for a known listing over a date window.
/v1/availabilityDay-by-day availability for a known listing over a date window.
Get day-by-day availability for a known listing (or a batch of listings) on one platform over a date window. Each day reports whether it is available, its minimum-night requirement, and whether check-in / check-out / booking is allowed.
Parameters
| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
platform | enum | Yes | — | Single platform (not a fan-out endpoint). |
listingId | string | One of | — | A single listing id on platform. |
listingIds[] | string[] | One of | — | A batch of listing ids on platform. |
url | string | One of | — | Full listing URL (alternative to an id). |
startDate | date | Yes | — | YYYY-MM-DD; not in the past. |
endDate | date | Yes | — | After startDate; window ≤ 365 days. |
onlyAvailable | boolean | No | false | If true, only bookable dates are returned. |
Request & response
GET /v1/availability?platform=airbnb&listingId=42307961&startDate=2026-07-13&endDate=2026-07-20
Host: api.scoutingapi.com
Authorization: Bearer scout_live_…{
"data": [
{
"platform": "airbnb",
"listingId": "42307961",
"dates": [
{ "date": "2026-07-13", "available": true, "minNights": 7, "checkIn": true, "checkOut": false, "bookable": true },
{ "date": "2026-07-14", "available": true, "minNights": 7, "checkIn": false, "checkOut": false, "bookable": true }
]
}
],
"meta": {
"requestId": "req_av…",
"platforms": ["airbnb"],
"cached": false, "partial": false,
"creditsCharged": 3, "currency": "USD", "pagination": null,
"platformResults": [
{ "platform": "airbnb", "status": "ok", "creditsCharged": 3, "cached": false, "count": 1 }
],
"warnings": []
}
}Code samples
The same call in every language that matters — all returning the identical unified schema.
curl -sS "https://api.scoutingapi.com/v1/availability?platform=airbnb&listingId=42307961&startDate=2026-07-13&endDate=2026-07-20" \
-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 3 credits / listing-window.
/v1/availabilityRuns against the deterministic Airbnb sandbox fixture — a real 200, zero credits.
Run the call to see a live, deterministic sandbox response.
curl -sS "https://api.scoutingapi.com/v1/availability" \
-H "Authorization: Bearer $SCOUTINGAPI_KEY"Notes & gotchas
Window cap: 365 days