# Airbnb API reference

Use this as compact context for the live bluedoor Airbnb API.

Primary URLs:

- API base URL: https://api.bluedoor.sh/airbnb/v1
- OpenAPI JSON: https://bluedoor.sh/apis/airbnb/docs/openapi.json
- Upstream OpenAPI JSON: https://api.bluedoor.sh/airbnb/v1/openapi.json
- Docs: https://bluedoor.sh/apis/airbnb/docs
- Landing page: https://bluedoor.sh/apis/airbnb
- Data pages: https://bluedoor.sh/data/airbnb

Authentication and units:

- Anonymous callers get 100 units/day.
- Email-authenticated API keys get 10,000 units/day by default.
- Enterprise keys are handled by contact request.
- Every route has a fixed compute-unit cost.
- Metered responses include x-airbnb-unit-cost, x-airbnb-units-used, x-airbnb-units-remaining, x-airbnb-units-limit, and x-airbnb-tier.

Important routes:

- GET /v1/health
- GET /v1/capabilities
- GET /v1/endpoints
- GET /v1/sources
- POST /v1/estimate
- GET /v1/openapi.json
- POST /v1/listings/search (5 units)
- POST /v1/listings/search-radius (10 units)
- GET /v1/listings/{id} (1 unit)
- GET /v1/listings/{id}/availability (5 units)
- POST /v1/listings/availability-grid (50 units)
- POST /v1/comps/find (20 units)
- POST /v1/rates/compare (30 units)
- POST /v1/markets/snapshot (75 units)
- POST /v1/pricing/audit (40 units)

Examples:

```bash
curl "https://api.bluedoor.sh/airbnb/v1/listings/47048969"

curl "https://api.bluedoor.sh/airbnb/v1/listings/47048969/availability?month=7&year=2026&count=2"

curl "https://api.bluedoor.sh/airbnb/v1/listings/search" \
  -H "content-type: application/json" \
  -d '{"query":"South Beach, Miami Beach, FL","checkin":"2026-07-10","checkout":"2026-07-12","limit":5}'

curl "https://api.bluedoor.sh/airbnb/v1/rates/compare" \
  -H "content-type: application/json" \
  -d '{"query":"Palm Springs, CA","checkin":"2026-08-14","checkout":"2026-08-16","limit":30}'
```