Skip to main content
GET
Search Airbnb Listings

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

adults
integer

Number of adult guests

必填范围: 0 <= x <= 16
airbnb_domain
string
默认值:airbnb.com

Airbnb domain to search (affects language and regional results)

amenities
string

Comma-separated list of amenity keys (e.g., "wifi,pool,kitchen"). Supports hundreds of amenities including wifi, pool, kitchen, air_conditioning, heating, washer, dryer, parking, pets_allowed, wheelchair_accessible, gym, hot_tub, ev_charger, and many more. Also supports special filters: guest_favorite, instant_book, luxe.

bathrooms
integer

Minimum number of bathrooms

必填范围: 0 <= x <= 8
bedrooms
integer

Minimum number of bedrooms

必填范围: 0 <= x <= 8
beds
integer

Minimum number of beds

必填范围: 0 <= x <= 8
bounding_box
string

Geographic bounding box coordinates for map-based search. Format: [[ne_lat,ne_lng],[sw_lat,sw_lng]]. Either q or bounding_box is required.

check_in_date
string

Check-in date in YYYY-MM-DD format. Must be a future date. Cannot be used together with time_period.

Pattern: ^\d{4}-\d{2}-\d{2}$
check_out_date
string

Check-out date in YYYY-MM-DD format. Must be after check-in date. Requires check_in_date to be set.

Pattern: ^\d{4}-\d{2}-\d{2}$
children
integer

Number of children guests

必填范围: 0 <= x <= 15
currency
enum<string>
默认值:USD

Currency code for pricing. Defaults to USD on airbnb.com; country-specific domains use their own local currency unless this parameter is set.

可用选项:
USD,
AUD,
BRL,
BGN,
BAM,
CAD,
CLP,
CNY,
COP,
CRC,
CZK,
DKK,
EGP,
AED,
EUR,
GHS,
GTQ,
HNL,
HKD,
HUF,
INR,
IDR,
ILS,
JPY,
KZT,
KES,
MYR,
MXN,
MAD,
TWD,
NZD,
NOK,
PEN,
PHP,
PLN,
GBP,
QAR,
RON,
RUB,
SAR,
SGD,
ZAR,
KRW,
SEK,
CHF,
THB,
TRY,
UGX,
UAH,
UYU,
VND
engine
enum<string>
必填

Search engine identifier

可用选项:
airbnb
include_taxes
enum<string>
默认值:false

When true, returns tax-inclusive search-card pricing. Each property's price then carries total_with_taxes and itemizes its tax lines in breakdown, without any extra per-property call. Applies to airbnb.com, where taxes normally appear only at checkout; other country-specific domains are unaffected (many, like EU domains, already show tax-inclusive totals by default). The nightly prices are the same as the default response; taxes are itemized on top.

可用选项:
true,
false
infants
integer

Number of infant guests

必填范围: 0 <= x <= 5
next_page_token
string

Token for pagination to retrieve subsequent pages of results

pets
integer

Number of pets

必填范围: 0 <= x <= 5
price_max
integer

Maximum price filter per night

必填范围: x >= 0
price_min
integer

Minimum price filter per night

必填范围: x >= 0
property_types
string

Comma-separated list of property type keys

q
string

Search query for location (e.g., "Barcelona", "Paris"). Either q or bounding_box is required.

time_period
enum<string>
默认值:one_week

Flexible trip length for searches without specific dates. Cannot be used together with check_in_date.

可用选项:
weekend_trip,
one_week,
one_month
type_of_place
enum<string>

Type of accommodation

可用选项:
any,
room,
entire_home

响应

成功响应

search_metadata
object
search_parameters
object
search_information
object
properties
object[]

List of property results

pagination
object
error
string

Error message when no results are found