Search Airbnb stays
Search Airbnb stays in a place for your dates and guests, with prices, ratings and photos.
Headers
Get your API keyAPI key (`sfk_...`)
Where to stay: a city, region, neighbourhood or address, as you would type it on the site, e.g. `London` or `Hay-on-Wye`. Add the country to tell places apart, e.g. `Paris, France`.
min 1 chars · max 100 chars
Check-in date, `YYYY-MM-DD`. Pass it with `checkOut`. Default: no dates, so each listing is priced for the next dates it is free (its own `checkIn` and `checkOut` say which).
Check-out date, `YYYY-MM-DD`, after `checkIn`.
Adults, 1 to 16. Default 1.
≥ 1 · ≤ 16
Children aged 2 to 12, 0 to 15. Default 0.
≥ 0 · ≤ 15
Infants under 2, 0 to 5. Default 0.
≥ 0 · ≤ 5
Pets, 0 to 5. Default 0.
≥ 0 · ≤ 5
Currency for prices, a three-letter code such as `USD`, `EUR` or `GBP`. Default `USD`.
Pass `page.nextCursor` from the previous response to get the next page. It only works with the same parameters. Omit it for the first page.
min 1 chars · max 4096 chars · pattern: ^[A-Za-z0-9_.-]+$
Endpoint-specific response payload.
`found` when the site placed the location, with an empty list when nothing is free; `not_found` when it could not place it.
one of: found, not_found
The `location` searched.
The place the site matched it to, e.g. `London, United Kingdom`. Check it: a vague location can match somewhere else. Null when `lookupStatus` is `not_found`.
Check-in date searched, if any.
Check-out date searched, if any.
Adults searched.
Children searched.
Infants searched.
Pets searched.
Currency of every price.
Matching stays the site reports, when it gives a number; null when it says only `Over 1,000`.
The site's own count line, e.g. `Over 1,000 homes in London`.
A page of up to 18 listings in the site's own order. The site re-ranks between requests, so a listing an earlier page returned is left out of later pages, and a page can hold fewer rows.
Listing id. Pass it as `listingId` to the listing, reviews and availability endpoints.
Listing URL on airbnb.com.
Listing name the host gave it.
Card heading, e.g. `Apartment in Shoreditch` or a hotel's name.
Card line under the heading, e.g. `Hotel in City of London`.
Neighbourhood or town the card names, e.g. `Camden`.
Map position as the site shows it: for most homes an approximate point near the listing, never the exact address.
Latitude.
Longitude.
Average guest rating out of 5; null for a new listing.
Reviews behind the rating; null for a new listing.
True when the card shows `New` instead of a rating.
Whether the card carries the `Guest favorite` badge.
Whether the card carries the `Superhost` badge.
Badges as shown, e.g. `Guest favorite`.
Details the card lists, e.g. `2 king beds`, `1 bath`.
Booking messages the card shows, e.g. `Free cancellation`.
Photo URLs the card shows. Links only; not hosted by Social Fetch.
Hotel or property id, for a room in a hotel; null for a home.
Check-in date the price is for, `YYYY-MM-DD`: your `checkIn`, or the listing's next free dates when you passed none.
Check-out date the price is for, `YYYY-MM-DD`.
Price for the stay; null when the card shows none.
Total for the stay in `currency`, as the result card shows it.
Total as shown, e.g. `$1,374`.
Total before a discount, when the card shows one struck through.
Total before a discount as shown.
Currency of every amount, e.g. `USD`.
Nights the total covers.
Nightly rate in the breakdown, before discounts.
Always true: the site's totals include the cleaning and service fees.
one of: true
Whether taxes are in the total: false when the site says `before taxes`; null when it says neither.
The price details the card opens: nights, discounts, total.
Line as shown, e.g. `5 nights x $331.10` or `Early booking discount`.
Amount in `currency`; negative for a discount.
Amount as shown, e.g. `-$281.45`.
Page number of this response, from 1.
Whether another page is available.
Pass as `cursor` to get the next page; null on the last page.
Last page the site offers for this search, at most 15.
True when more stays match than the site's 15 pages reach: the list ends early. Narrow the search (dates, a smaller place) to reach the rest.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/airbnb/search?location=London" \
-H "x-api-key: YOUR_API_KEY"Responses
Airbnb stays for a place and dates.