docs / airbnb

Airbnb

Search stays, get listing details, reviews and availability.

base /airbnb/v18 endpoints

post/airbnb/v1/stays.search2 credits

search stays in a location

Parameter	Required
query	optional
checkin	optional
checkout	optional
adults	optional

Try in playground →

post/airbnb/v1/stays.detail3 credits

full listing (PDP, raw passthrough)

Parameter	Required
listing_id	optional

Try in playground →

post/airbnb/v1/stays.reviews1 credit

listing reviews (paginated)

Parameter	Required
listing_id	required

Try in playground →

post/airbnb/v1/stays.availability_calendar2 credits

availability calendar (≤12 months)

Parameter	Required
listing_id	required

Try in playground →

post/airbnb/v1/stays.price_checkout1 credit

checkout price breakdown

Parameter	Required
listing_id	required
checkin	required
checkout	required

Try in playground →

post/airbnb/v1/properties.search2 credits

alias of stays.search

Parameter	Required
query	optional
checkin	optional
checkout	optional
adults	optional

Try in playground →

post/airbnb/v1/properties.detail3 credits

alias of stays.detail

Parameter	Required
listing_id	optional

Try in playground →

post/airbnb/v1/autocomplete1 credit

location autocomplete (raw passthrough)

Try in playground →

Example request · stays.search

curl -X POST https://api.reefapi.com/airbnb/v1/stays.search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"Istanbul, Turkey","checkin":"2026-08-10","checkout":"2026-08-15","adults":2}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}