Skip to main content
POST /v1/data/airbnb/listings/run Pricing: $0.002 per listing ($2.00 per 1,000).

Ways to call it

  • URL: set urls
  • Location: set location (optional: maxResults, checkIn, checkOut, adults, children, infants, pets, priceMin, …)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
Airbnb listing URLs (https://www.airbnb.com/rooms/…) to fetch details for.
string
Place to search (e.g. “Paris, France” or “Lisbon”). Returns listings in that area.
integer
default:"100"
How many listings to return from a location search. Defaults to 100; at most 5,000. Not used with listing URLs, which return one listing per URL.Min 1; max 5000.
integer
Minimum nightly price filter (location search only).
integer
Maximum nightly price filter (location search only).
integer
Minimum number of bedrooms (location search only).
integer
Minimum number of beds (location search only).
integer
Minimum number of bathrooms (location search only).
date
Check-in date for availability and price.Use together with checkout.
date
Check-out date for availability and price.Use together with checkin.
integer
Number of adults in the party.
integer
Number of children (ages 2-12).
integer
Number of infants (under 2).
integer
Number of pets.
string
default:"en-US"
Language and region for the listing data.93 allowed values, for example en-US, az-AZ, id-ID, bs-BA, ca-ES, cs-CZ, sr-ME, da-DK, de-DE, de-AT. Fetch the full list with GET /v1/data/airbnb/listings?expand=options.
string
default:"USD"
Currency for prices.48 allowed values, for example USD, CZK, AUD, BRL, BGN, CAD, CLP, CNY, COP, CRC. Fetch the full list with GET /v1/data/airbnb/listings?expand=options.

Example

Response fields

Each row in data is one listing, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For review text use airbnb/reviews.