Get daily neighborhood occupancy and booking data for a listing.
GET/listings/:listing_id/neighborhood/occupancy
Returns a daily time series of occupancy and booking model data for the listing's local neighborhood cluster. This is the same data used to render the occupancy, expected bookings, and observed bookings series in the Wheelhouse pricing chart.
occupancy— raw occupancy rate (booked nights / calendar nights).adjusted_occupancy— occupancy computed against bookable (unblocked) nights only.expected_bookings— model-predicted booking count for the stay date.expected_bookings_sd— standard deviation of the expected bookings prediction.observed_bookings— actual booking count observed for the stay date.calendar_nights— total calendar nights in the cluster for the stay date.
Returns 404 if no neighborhood cluster is found for the listing's location, or if no
occupancy data has been generated for the cluster.
Request
Responses
- 200
- 401
- 403
- 404
- 406
- 422
- 429
Neighborhood occupancy and booking data.
API key authorization failed.
Listing authorization failed.
Listing not found, or no neighborhood cluster or occupancy data found for this listing's location.
Listing is inactive.
Listing is not covered by a Wheelhouse market, or has no location data.
Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the Rate Limits section in the overview for the recommended exponential backoff strategy.