Airbnb

Airbnb Search API

Search Airbnb stays - stay-total and per-night price with the full price-item ledger, rating and review count, bedrooms, beds and baths, coordinates, Guest Favorite and Superhost badges and images - as JSON. This is the only Airbnb endpoint that carries prices. 18 listings per page. Costs 1 credit per request.

POST/api/v1/airbnb/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

locationstringrequired

Where to search: a city, a region, a ZIP, or a pasted airbnb.com/s/ URL. 1-200 characters. A location Airbnb cannot resolve is a 404, not an empty result - it answers an unparseable one with a full grid geolocated off our proxy.

Example: Austin, TX

check_instring

Check-in date, YYYY-MM-DD. Must be sent together with check_out. Omit both and the transport defaults to 30 days out for 5 nights, and the response sets dates_are_defaulted true.

Example: 2026-09-08

check_outstring

Check-out date, YYYY-MM-DD. Must be later than check_in and sent together with it.

Example: 2026-09-13

adultsinteger

Adult guests, 1 or more.

childreninteger

Children aged 2-12, 0 or more.

infantsinteger

Infants under 2, 0 or more.

petsinteger

Pets, 0 or more.

min_pricenumber

Minimum price for the WHOLE STAY, in currency - not per night. Must not exceed max_price.

max_pricenumber

Maximum price for the WHOLE STAY, in currency - not per night.

room_typeenum<string>

entire_home, private_room, shared_room or hotel_room. Validated before the scrape: an unrecognised value is not an error upstream, Airbnb answers it with the UNFILTERED set under a 200, so forwarding it would bill a scrape for a filter that never ran.

min_bedroomsinteger

Minimum bedrooms, 0 or more.

min_bedsinteger

Minimum beds, 0 or more.

min_bathroomsinteger

Minimum bathrooms, 0 or more.

superhostboolean

Superhost listings only.

instant_bookboolean

Instant Book listings only.

guest_favoriteboolean

Guest Favorite listings only.

free_cancellationboolean

Listings with free cancellation only.

amenitiesstring

Comma-separated amenities, 1-200 characters: wifi, air_conditioning, pool, kitchen, free_parking, washer, self_check_in, tv - or raw numeric Airbnb amenity ids. An unrecognised NAME is rejected before the scrape, for the same reason room_type is.

Example: wifi,pool

currencystringdefault:USD

ISO 4217 currency, 3 letters. Leave it out and Airbnb prices off the proxy exit, so two identical requests can disagree.

pageinteger

Results page, 1-based. 18 listings per page. Cannot be combined with cursor.

cursorstring

next_cursor from a previous response, 1-500 characters. It WINS over page, so sending both is rejected rather than silently ignoring page.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.airbnb.search("Austin, TX", check_in="2026-09-08", check_out="2026-09-13")
print(results)

Response

"url": "https://www.airbnb.com/s/Austin--TX/homes?refinement_paths%5B%5D=%2Fhomes&checkin=2026-09-08&checkout=2026-09-13&currency=USD&locale=en",

"location": "Austin, TX",

"resolved_location": "Austin, TX",

"city": "Austin",

"state": "Texas",

"country": "United States",

"place_precision": "city",

"check_in": "2026-09-08",

"check_out": "2026-09-13",

"nights": 5,

"dates_are_defaulted": true,

"currency": "USD",

"guests": {},

"page": 1,

"page_count": 15,

"next_cursor": "eyJzZWN0aW9uX29mZnNldCI6MCwiaXRlbXNfb2Zmc2V0IjoxOCwidmVyc2lvbiI6MX0=",

"count": 18,

"response_time": 3866,

"credits_used": 1,

"credits_remaining": 4820

}