# Airbnb search: `POST /v1/serp/airbnb`

Cost: 12 credits (12 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/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 body (JSON):

- `q` (string | null; optional): Destination text. Required unless `bounding_box` is supplied; ignored for map bounds only when the two conflict.
- `bounding_box` (string | null; optional): Map bounds as `[[ne_lat,ne_lng],[sw_lat,sw_lng]]`. Takes precedence over `q`.
- `airbnb_domain` (string; optional; default airbnb.com; one of 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): Country/language Airbnb host, such as `airbnb.com`, `airbnb.ca` or `fr.airbnb.ca`.
- `currency` (string | null; optional; one of 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): Airbnb-supported ISO 4217 display currency. Omit to use the selected domain's default.
- `include_taxes` (boolean; optional; default false): Expose tax-inclusive totals when Airbnb includes a tax line in the search price breakdown.
- `check_in_date` (string (date) | null; optional): Exact check-in date, `YYYY-MM-DD`. Cannot be mixed with `time_period`.
- `check_out_date` (string (date) | null; optional): Exact departure date. Requires `check_in_date`; defaults to the next day when omitted.
- `time_period` (string | null; optional; one of one_month, one_week, weekend_trip): Flexible date search: `weekend_trip`, `one_week` or `one_month`. Defaults to `one_week` when no exact dates are supplied.
- `adults` (integer | null; optional; min 0, max 16): Adults aged 13+, from 0 through 16. Defaults to one when another guest count is set.
- `children` (integer | null; optional; min 0, max 15): Children aged 2–12. Maximum 15.
- `infants` (integer | null; optional; min 0, max 5): Infants under 2. Maximum 5.
- `pets` (integer | null; optional; min 0, max 5): Pets. Maximum 5.
- `price_min` (integer | null; optional; min 0): Minimum displayed trip price.
- `price_max` (integer | null; optional; min 0): Maximum displayed trip price.
- `type_of_place` (string; optional; default any; one of any, entire_home, room): `any`, `room`, or `entire_home`.
- `property_types` (string | null; optional): Comma-separated `house`, `guesthouse`, `apartment` and/or `hotel`.
- `bedrooms` (integer | null; optional; min 0, max 8): Minimum bedrooms, 0–8.
- `beds` (integer | null; optional; min 0, max 8): Minimum beds, 0–8.
- `bathrooms` (integer | null; optional; min 0, max 8): Minimum bathrooms, 0–8.
- `amenities` (string | null; optional): Comma-separated SERP API amenity names, such as `guest_favorite,wifi,kitchen,instant_book`.
- `next_page_token` (string | null; optional): Opaque cursor returned in `pagination.next_page_token`.
- `zero_retention` (boolean; optional; default false): Accepted for SERP API request compatibility. This endpoint never stores raw HTML or search results, regardless of the value.

Response fields:

- `search_metadata` (object; required)
  - `search_metadata.id` (string; required)
  - `search_metadata.status` (string; required)
  - `search_metadata.created_at` (string; required)
  - `search_metadata.collection_id` (string; required)
  - `search_metadata.observed_at` (string; required)
  - `search_metadata.request_time_taken` (number; required)
  - `search_metadata.parsing_time_taken` (number; required)
  - `search_metadata.total_time_taken` (number; required)
  - `search_metadata.request_url` (string; required)
- `search_parameters` (object; required): Echo of the effective request. Every value is a string; parameters that were not set are omitted.
  - `search_parameters.engine` (string; required; one of airbnb)
  - `search_parameters.airbnb_domain` (string; required)
- `search_information` (object; required)
  - `search_information.query_displayed` (string; required)
  - `search_information.results` (string; required)
  - `search_information.check_in_date` (string; optional)
  - `search_information.check_out_date` (string; optional)
  - `search_information.time_period` (string; optional)
  - `search_information.adults` (integer; optional)
  - `search_information.children` (integer; optional)
  - `search_information.infants` (integer; optional)
  - `search_information.pets` (integer; optional)
  - `search_information.guests` (string; required): e.g. `2 guests` or `Add guests`.
- `properties` (array of object; required)
  - `properties[].position` (integer; required)
  - `properties[].id` (string; required)
  - `properties[].title` (string; optional)
  - `properties[].description` (string; optional)
  - `properties[].link` (string; required)
  - `properties[].booking_link` (string; required)
  - `properties[].booking_token` (string; required)
  - `properties[].rating` (number; optional)
  - `properties[].reviews` (integer; optional)
  - `properties[].price` (object; optional)
  - `properties[].check_in_date` (string; optional)
  - `properties[].check_out_date` (string; optional)
  - `properties[].time_period` (string; optional)
  - `properties[].accommodations` (array of string; optional)
  - `properties[].gps_coordinates` (object; optional)
  - `properties[].has_free_cancellation` (boolean; optional): Only present (as true) when advertised.
  - `properties[].badges` (array of string; optional)
  - `properties[].images` (array of string; optional)
  - `properties[].distance` (string; optional)
  - `properties[].extracted_distance` (number; optional)
- `pagination` (object; optional): Present only when another page exists.
  - `pagination.next_page_token` (string; required)

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
