Airbnb
Search, listing detail, reviews, availability, and host/experience/service detail from Airbnb, served as plain REST.
Endpoints
| Endpoint | Path params | Query params | What it returns | Price | Data up to |
|---|---|---|---|---|---|
GET /airbnb/search |
— | query, place_id, checkin, checkout, adults, children, infants, price_min, price_max, bedrooms, beds, bathrooms, room_type, amenities, allows_pets, instant_book, guest_favorite, host_languages, cursor, currency |
Listing search results. | $0.003 | 1 min |
GET /airbnb/listing |
— | listing_id, checkin, checkout, adults, children, infants, pets, currency |
Full detail for one listing. | $0.003 | 5 min |
GET /airbnb/reviews |
— | listing_id, offset, limit, sort, tag, currency |
Reviews for one listing. | $0.003 | 5 min |
GET /airbnb/availability |
— | listing_id, month, year, count |
Calendar availability for one listing. | $0.003 | 15 min |
GET /airbnb/similar-listings |
— | listing_id, checkin, checkout, adults, currency |
Listings similar to one listing. | $0.003 | 5 min |
GET /airbnb/autosuggest |
— | query, currency |
Search-box autosuggest (places, categories). | $0.001 | 1 hr |
GET /airbnb/experience |
— | listing_id, adults, currency |
Detail for one "experience" listing. | $0.003 | 5 min |
GET /airbnb/service |
— | listing_id, adults, currency |
Detail for one "service" listing. | $0.003 | 5 min |
GET /airbnb/host |
— | host_id, reviews_offset, reviews_limit, currency |
Host profile and reviews. | $0.003 | 5 min |
Prices are per call, paid in USDC with x402. "Data up to" is the cache window: a repeated call inside it returns the same data.
Calling it
# x402: no account or API key. The server answers 402 with payment instructions; an x402 client pays and repeats the request.
curl -i "https://<base-url>/airbnb/search?query=Paris"
Responses are JSON. Field names follow the upstream source, so a response can be larger than the table above suggests.
Notes
room_type,sort, andhost_languagesare free text — Airbnb's own client does not validate them against a fixed list.availabilityalways returns prices in USD regardless of thecurrencyyou pass elsewhere — this matches Airbnb's own client behavior, not an oversight.experience/service/hostaccept any listing/host id; results for an id of the wrong kind come back with most fields empty rather than an error.
