Airbnb search
Search Airbnb with the standard SERP API request names and response hierarchy.
Use next_page_token from the response for the next page. The same engine is also available at the standard SERP API GET-style /api/v1/search?engine=airbnb.
Request
https://api.scrapercompany.com/v1/serp/airbnbAuthenticate with your API key in the x-api-key header (see Authentication).
Run this request on your own API key from this page, with the values you type. Signed out? Sign in or get an API key.
Body
JSON object. Unknown fields are rejected with 422.
- qstring | null
Destination text. Required unless
bounding_boxis supplied; ignored for map bounds only when the two conflict. - bounding_boxstring | null
Map bounds as
[[ne_lat,ne_lng],[sw_lat,sw_lng]]. Takes precedence overq. - airbnb_domainstringdefault
airbnb.comCountry/language Airbnb host, such as
airbnb.com,airbnb.caorfr.airbnb.ca.94 allowed values
airbnb.ae, airbnb.am, airbnb.at, airbnb.az, airbnb.ba, airbnb.be, airbnb.ca, airbnb.cat, airbnb.ch, airbnb.cl, airbnb.cn, airbnb.co.cr, airbnb.co.id, airbnb.co.in, airbnb.co.kr, airbnb.co.nz, airbnb.co.uk, airbnb.co.ve, airbnb.com, airbnb.com.ar, airbnb.com.au, airbnb.com.bo, airbnb.com.br, airbnb.com.bz, airbnb.com.co, airbnb.com.ec, airbnb.com.ee, airbnb.com.gt, airbnb.com.hk, airbnb.com.hn, airbnb.com.my, airbnb.com.ni, airbnb.com.pa, airbnb.com.pe, airbnb.com.ph, airbnb.com.py, airbnb.com.ro, airbnb.com.sg, airbnb.com.sv, airbnb.com.tr, airbnb.com.tw, airbnb.com.ua, airbnb.com.vn, airbnb.cz, airbnb.de, airbnb.dk, airbnb.es, airbnb.fi, airbnb.fr, airbnb.gr, airbnb.gy, airbnb.hu, airbnb.ie, airbnb.is, airbnb.it, airbnb.jp, airbnb.lt, airbnb.lu, airbnb.lv, airbnb.me, airbnb.mx, airbnb.nl, airbnb.no, airbnb.pl, airbnb.pt, airbnb.rs, airbnb.ru, airbnb.se, airbnb.si, ar.airbnb.com, bg.airbnb.com, de.airbnb.lu, es.airbnb.com, fr.airbnb.be, fr.airbnb.ca, fr.airbnb.ch, ga.airbnb.ie, he.airbnb.com, hi.airbnb.co.in, hr.airbnb.com, it.airbnb.ch, ka.airbnb.com, kn.airbnb.co.in, mk.airbnb.com, mr.airbnb.co.in, mt.airbnb.com.mt, sk.airbnb.com, sq.airbnb.com, sw.airbnb.com, th.airbnb.com, xh.airbnb.co.za, zh-t.airbnb.com, zh.airbnb.com, zu.airbnb.co.za
- currencystring | null
Airbnb-supported ISO 4217 display currency. Omit to use the selected domain's default.
51 allowed values
AED, AUD, BAM, BGN, BRL, CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, EGP, EUR, GBP, GHS, GTQ, HKD, HNL, HUF, IDR, ILS, INR, JPY, KES, KRW, KZT, MAD, MXN, MYR, NOK, NZD, PEN, PHP, PLN, QAR, RON, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, UGX, USD, UYU, VND, ZAR
- include_taxesbooleandefault
falseExpose tax-inclusive totals when Airbnb includes a tax line in the search price breakdown.
- check_in_datestring (date) | null
Exact check-in date,
YYYY-MM-DD. Cannot be mixed withtime_period. - check_out_datestring (date) | null
Exact departure date. Requires
check_in_date; defaults to the next day when omitted. - time_periodstring | null
Flexible date search:
weekend_trip,one_weekorone_month. Defaults toone_weekwhen no exact dates are supplied.One of
one_monthone_weekweekend_trip - adultsinteger | nullmin 0, max 16
Adults aged 13+, from 0 through 16. Defaults to one when another guest count is set.
- childreninteger | nullmin 0, max 15
Children aged 2–12. Maximum 15.
- infantsinteger | nullmin 0, max 5
Infants under 2. Maximum 5.
- petsinteger | nullmin 0, max 5
Pets. Maximum 5.
- price_mininteger | nullmin 0
Minimum displayed trip price.
- price_maxinteger | nullmin 0
Maximum displayed trip price.
- type_of_placestringdefault
anyany,room, orentire_home.One of
anyentire_homeroom - property_typesstring | null
Comma-separated
house,guesthouse,apartmentand/orhotel. - bedroomsinteger | nullmin 0, max 8
Minimum bedrooms, 0–8.
- bedsinteger | nullmin 0, max 8
Minimum beds, 0–8.
- bathroomsinteger | nullmin 0, max 8
Minimum bathrooms, 0–8.
- amenitiesstring | null
Comma-separated SERP API amenity names, such as
guest_favorite,wifi,kitchen,instant_book. - next_page_tokenstring | null
Opaque cursor returned in
pagination.next_page_token. - zero_retentionbooleandefault
falseAccepted for SERP API request compatibility. This endpoint never stores raw HTML or search results, regardless of the value.
Example request
curl -X POST "https://api.scrapercompany.com/v1/serp/airbnb" \
-H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"q": "Toronto",
"currency": "CAD",
"check_in_date": "2027-01-15",
"check_out_date": "2027-01-17",
"adults": 2
}'Response
200 — SERP-compatible Airbnb destination results with live prices. Metered responses carry x-credits-charged and x-credits-remaining headers (see credit headers).
{
"search_metadata": {
"id": "search_2af4914e869a4a36958659ef",
"status": "Success",
"created_at": "2026-08-06T18:46:11+00:00",
"request_time_taken": 1.3,
"parsing_time_taken": 0.02,
"total_time_taken": 1.32,
"request_url": "https://www.airbnb.ca/s/Toronto/homes?..."
},
"search_parameters": {
"engine": "airbnb",
"airbnb_domain": "airbnb.ca",
"currency": "CAD",
"q": "Toronto",
"check_in_date": "2027-02-06",
"check_out_date": "2027-02-08",
"adults": "2",
"include_taxes": "true"
},
"search_information": {
"query_displayed": "Homes in Toronto, Canada",
"results": "Over 1,000 homes in Toronto",
"check_in_date": "2027-02-06",
"check_out_date": "2027-02-08",
"adults": 2,
"guests": "2 guests"
},
"properties": [
{
"position": 1,
"id": "734254017349424949",
"title": "Chic Studio w Balcony Fast WiFi by Yonge-Dundas",
"description": "Condo in Toronto",
"link": "https://www.airbnb.ca/rooms/734254017349424949",
"booking_link": "https://www.airbnb.ca/rooms/734254017349424949?check_in=2026-09-10&check_out=2026-09-12&adults=2&children=0&infants=0&pets=0",
"booking_token": "eyJjaGVja19pbiI6IjIwMjYtMDktMTAiLCJwcm9wZXJ0eV9pZCI6IjczNDI1NDAxNzM0OTQyNDk0OSJ9",
"rating": 4.96,
"reviews": 166,
"price": {
"total_price": "$737 CAD",
"extracted_total_price": 737,
"total_with_taxes": "$737 CAD",
"extracted_total_with_taxes": 737,
"qualifier": "for 2 nights",
"extracted_qualifier": 2,
"price_per_qualifier": "2 nights x $310.00 CAD",
"extracted_price_per_qualifier": 310,
"breakdown": [
{
"description": "2 nights x $310.00 CAD",
"price": "$620.00 CAD",
"extracted_price": 620
},
{
"description": "Taxes",
"price": "$117.00 CAD",
"extracted_price": 117
}
]
},
"check_in_date": "2027-02-06",
"check_out_date": "2027-02-08",
"time_period": "Sep 10 – 12",
"accommodations": [
"1 bedroom",
"1 queen bed"
],
"gps_coordinates": {
"latitude": 43.654,
"longitude": -79.38
},
"has_free_cancellation": true,
"badges": [
"Guest favourite"
],
"images": [
"https://a0.muscache.com/im/pictures/example.jpeg"
]
}
],
"pagination": {
"next_page_token": "eyJzZWN0aW9uX29mZnNldCI6MH0="
}
}Response fields
Fields marked required are always present; others appear when they apply.
- search_metadataobjectrequired
Show 9 child fieldsHide child fields
- search_metadata.idstringrequired
- search_metadata.statusstringrequired
- search_metadata.created_atstringrequired
- search_metadata.collection_idstringrequired
- search_metadata.observed_atstringrequired
- search_metadata.request_time_takennumberrequired
- search_metadata.parsing_time_takennumberrequired
- search_metadata.total_time_takennumberrequired
- search_metadata.request_urlstringrequired
- search_parametersobjectrequired
Echo of the effective request. Every value is a string; parameters that were not set are omitted.
Show 2 child fieldsHide child fields
- search_parameters.enginestringrequired
One of
airbnb - search_parameters.airbnb_domainstringrequired
- search_informationobjectrequired
Show 10 child fieldsHide child fields
- search_information.query_displayedstringrequired
- search_information.resultsstringrequired
- search_information.check_in_datestring
- search_information.check_out_datestring
- search_information.time_periodstring
- search_information.adultsinteger
- search_information.childreninteger
- search_information.infantsinteger
- search_information.petsinteger
- search_information.guestsstringrequired
e.g.
2 guestsorAdd guests.
- propertiesarray of objectrequired
Show 20 child fieldsHide child fields
- properties[].positionintegerrequired
- properties[].idstringrequired
- properties[].titlestring
- properties[].descriptionstring
- properties[].linkstringrequired
- properties[].booking_linkstringrequired
- properties[].booking_tokenstringrequired
- properties[].ratingnumber
- properties[].reviewsinteger
- properties[].priceobject
Show 14 child fieldsHide child fields
- properties[].price.total_pricestringrequired
As displayed.
- properties[].price.extracted_total_pricenumber | nullrequired
- properties[].price.qualifierstring
e.g.
for 2 nights - properties[].price.extracted_qualifierinteger
- properties[].price.price_per_qualifierstring
- properties[].price.extracted_price_per_qualifiernumber | null
- properties[].price.original_pricestring
- properties[].price.extracted_original_pricenumber
- properties[].price.discountstring
- properties[].price.extracted_discountnumber
- properties[].price.breakdownarray of object
- properties[].price.total_with_taxesstring
Only with
include_taxesand a tax line. - properties[].price.extracted_total_with_taxesnumber | null
- properties[].price.provenanceobjectrequired
Where, when and how one normalized price was observed.
- properties[].check_in_datestring
- properties[].check_out_datestring
- properties[].time_periodstring
- properties[].accommodationsarray of string
- properties[].gps_coordinatesobject
Show 2 child fieldsHide child fields
- properties[].gps_coordinates.latitudenumberrequired
- properties[].gps_coordinates.longitudenumberrequired
- properties[].has_free_cancellationboolean
Only present (as true) when advertised.
- properties[].badgesarray of string
- properties[].imagesarray of string
- properties[].distancestring
- properties[].extracted_distancenumber
- paginationobject
Present only when another page exists.
Show 1 child fieldHide child fields
- pagination.next_page_tokenstringrequired
Errors
Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.
| Status | Meaning | Retry? |
|---|---|---|
401Unauthorized | Missing or invalid API key. {"detail":"missing or invalid API key"} | No, fix the request |
402Payment Required | Not enough credits for this request: the account's credits mode is {"detail":"insufficient credits: this request costs 5, 0 available. Credits renew 2026-11-01."} | No, fix the request |
422Unprocessable Content | Request validation failed. {"detail":[{"loc":["body","name"],"msg":"Field required","type":"missing"}]} | No, fix the request |
429Too Many Requests | Too many requests: the key's requests-per-minute limit was exceeded, or (in {"detail":"rate limit 60/min exceeded"} | Yes, with backoff |
502Bad Gateway | The upstream source failed, blocked the request or returned an unusable answer. Safe to retry later; failed requests are not charged. {"detail":"RuntimeError"} | Yes, with backoff |
503Service Unavailable | Temporarily unavailable: a dependency of this endpoint is down, or the upstream source changed its contract. Retry later. {"detail":"database unavailable: OperationalError"} | Yes, with backoff |
Try it
Press Try it above to run this request on your own key, with the values you type (sign in first). For a no-code walkthrough, use the workspace’s guided Try it.
- Export your key:
export SCRAPERCOMPANY_API_KEY=sk_...(no key yet? start a free trial). - Copy the cURL example above and run it in a terminal.
Questions about this page?
Send the page link and your question, and the team will answer.