Get Airbnb listing
Get an Airbnb listing with its description, host, amenities, house rules, ratings and photos.
Headers
Get your API keyAPI key (`sfk_...`)
Airbnb listing id: the number in the listing URL (`airbnb.com/rooms/1900063`), e.g. `1900063`. The full listing URL also works. Search results return it as `listingId`.
pattern: ^[1-9]\d{0,19}$
Endpoint-specific response payload.
`not_found` when no listing has this id or the host removed it.
one of: found, not_found
The listing id asked for.
The listing when found; otherwise null.
Listing id.
Listing URL on airbnb.com.
Listing name the host gave it.
The site's one-line summary, e.g. `Condo in Greater London · ★5.0 · 1 bedroom · 1 bed · 1 private bath`.
Property type as shown, e.g. `Private room in condo`.
`Entire home/apt`, `Private room`, `Shared room` or `Hotel room`.
Full description as plain text, sections separated by blank lines.
Full description with the site's own formatting (HTML).
Overview lines, e.g. `1 king bed`, `Private attached bathroom`.
Most guests, infants not counted.
Bedrooms, from the summary line.
Beds, from the summary line.
Bathrooms, from the summary line.
Bathrooms as shown, e.g. `1 private bath`.
Whether pets are allowed.
Where the listing is, as precisely as the page shows it logged out.
Area name, e.g. `Greater London`.
Full place line, e.g. `Greater London, England, United Kingdom`.
Map position as the site shows it: for most homes an approximate point near the listing, never the exact address.
Latitude.
Longitude.
True when the map shows an area rather than the place (most homes until booked).
Place hierarchy, e.g. `United Kingdom`, `England`, `London`.
Guest ratings.
Average rating out of 5.
Reviews behind it.
Ratings per aspect.
`cleanliness`, `accuracy`, `checkin`, `communication`, `location` or `value`.
Label as shown, e.g. `Check-in`.
Average out of 5.
Share of reviews per star rating, 5 stars first.
Star rating, 1 to 5.
Share of reviews with that rating, 0 to 1.
Whether it is a Guest favorite.
Whether the site marks it as new.
Whether it is an Airbnb Luxe home.
The host, as the listing page shows them to anyone: no contact details.
Host's Airbnb user id.
Host's first name as the page shows it.
Host's public profile URL.
Profile photo URL. Link only; not hosted by Social Fetch.
Whether the host is a Superhost.
Whether the host is verified.
Whole years hosting.
Months hosting beyond `yearsHosting`.
Host's average rating out of 5.
Reviews of the host.
Response rate as shown, e.g. `100%`.
Response time as shown, e.g. `Responds within an hour`.
What the host wrote about themselves.
Lines from the host's profile card, e.g. `My work: ...`.
Highlights the page shows near the top. Some are summaries the site writes from reviews.
Kind, e.g. `LISTING_GUEST_FAVORITE` or `LISTING_SELF_CHECKIN`.
Heading as shown.
Line under it.
Every amenity, by section.
Section, e.g. `Bathroom`.
Amenity as shown, e.g. `Wifi`.
Detail under it, when shown.
False for an amenity the page lists as not included.
House rules, including check-in and check-out times.
Section heading, when the page groups them.
Item as shown.
Detail under it, when shown.
Safety devices and property notes, e.g. cameras.
Section heading, when the page groups them.
Item as shown.
Detail under it, when shown.
Where guests sleep.
Room, e.g. `Bedroom 1`.
Beds as shown, e.g. `1 king bed`.
Every photo, in the photo tour's order.
Photo URL. Link only; the image is not hosted by Social Fetch.
Caption, when the host wrote one.
Room the photo tour files it under, e.g. `Bedroom`.
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/listings/1900063" \
-H "x-api-key: YOUR_API_KEY"Responses
Airbnb listing.