# Airbnb search (GET): `GET /api/v1/search`

Cost: 12 credits (12 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/airbnb-search-get

Drop-in GET endpoint for existing SERP API integrations.

Keep ``engine``, every existing query parameter and either the
``api_key`` query credential or Bearer token; only replace the origin.
``engine=airbnb`` takes the parameters listed here. ``engine=
google_autocomplete``, ``google_images`` and ``google_videos`` take
the standard SERP API parameter names for those engines (validated by the same
models as ``POST /v1/google/autocomplete``, ``/images``, ``/videos``)
and answer the same body; each costs what its POST route costs.

Parameters:

- `engine` (string; optional; default airbnb; one of airbnb, google_autocomplete, google_images, google_videos): `airbnb` (the parameters below), or `google_autocomplete`, `google_images`, `google_videos` (the parameters of `POST /v1/google/autocomplete`, `/images`, `/videos`: `q`, `gl`, `hl`, `location`, `uule`, `page` and each engine's filters).
- `q` (string | null; optional): Airbnb: destination text, required unless `bounding_box` is supplied. Google engines: the search query (required).
- `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.
- `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.
- `include_taxes` (boolean; optional; default false): Include tax-inclusive totals when Airbnb exposes a tax line.
- `check_in_date` (string (date) | null; optional): Exact check-in date in `YYYY-MM-DD` form.
- `check_out_date` (string (date) | null; optional): Exact check-out date; defaults to the next day.
- `time_period` (string | null; optional; one of one_month, one_week, weekend_trip): Flexible dates: `weekend_trip`, `one_week`, or `one_month`; cannot be mixed with exact dates.
- `adults` (integer | null; optional): Adults aged 13+, from 0 through 16.
- `children` (integer | null; optional): Children aged 2–12, from 0 through 15.
- `infants` (integer | null; optional): Infants under 2, from 0 through 5.
- `pets` (integer | null; optional): Pets, from 0 through 5.
- `price_min` (integer | null; optional): Minimum displayed trip price.
- `price_max` (integer | null; optional): 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): Minimum bedrooms, from 0 through 8.
- `beds` (integer | null; optional): Minimum beds, from 0 through 8.
- `bathrooms` (integer | null; optional): Minimum bathrooms, from 0 through 8.
- `amenities` (string | null; optional): Comma-separated SERP API amenity names.
- `next_page_token` (string | null; optional): Opaque cursor from `pagination.next_page_token` on the prior page.
- `zero_retention` (boolean; optional; default false): Accepted for SERP API compatibility; raw search HTML and results are never persisted.

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)
