Airbnb

Get Airbnb listing

Get an Airbnb listing with its description, host, amenities, house rules, ratings and photos.

GET/v1/airbnb/listings/{listingId}
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
listingIdstringrequiredpath

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}$

Response fields
88

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no listing has this id or the host removed it.

one of: found, not_found

datalistingId
string

The listing id asked for.

The listing when found; otherwise null.

datalistinglistingId
string

Listing id.

datalistingurl
string

Listing URL on airbnb.com.

datalistingname
stringnullable

Listing name the host gave it.

datalistingsummary
stringnullable

The site's one-line summary, e.g. `Condo in Greater London · ★5.0 · 1 bedroom · 1 bed · 1 private bath`.

datalistingpropertyType
stringnullable

Property type as shown, e.g. `Private room in condo`.

datalistingroomType
stringnullable

`Entire home/apt`, `Private room`, `Shared room` or `Hotel room`.

datalistingdescription
stringnullable

Full description as plain text, sections separated by blank lines.

datalistingdescriptionHtml
stringnullable

Full description with the site's own formatting (HTML).

Overview lines, e.g. `1 king bed`, `Private attached bathroom`.

datalistingoverview[]
stringoptional
datalistingmaxGuests
integernullable

Most guests, infants not counted.

datalistingbedrooms
numbernullable

Bedrooms, from the summary line.

datalistingbeds
numbernullable

Beds, from the summary line.

datalistingbathrooms
numbernullable

Bathrooms, from the summary line.

datalistingbathroomsText
stringnullable

Bathrooms as shown, e.g. `1 private bath`.

datalistingpetsAllowed
booleannullable

Whether pets are allowed.

Where the listing is, as precisely as the page shows it logged out.

datalistinglocationname
stringnullable

Area name, e.g. `Greater London`.

datalistinglocationsubtitle
stringnullable

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.

datalistinglocationcoordinateslatitude
number

Latitude.

datalistinglocationcoordinateslongitude
number

Longitude.

datalistinglocationisApproximate
booleannullable

True when the map shows an area rather than the place (most homes until booked).

Place hierarchy, e.g. `United Kingdom`, `England`, `London`.

datalistinglocationbreadcrumbs[]
stringoptional

Guest ratings.

datalistingratingaverage
numbernullable

Average rating out of 5.

datalistingratingreviewCount
integernullable

Reviews behind it.

Ratings per aspect.

datalistingratingcategories[]category
string

`cleanliness`, `accuracy`, `checkin`, `communication`, `location` or `value`.

datalistingratingcategories[]label
string

Label as shown, e.g. `Check-in`.

datalistingratingcategories[]rating
numbernullable

Average out of 5.

Share of reviews per star rating, 5 stars first.

datalistingratingdistribution[]stars
integer

Star rating, 1 to 5.

datalistingratingdistribution[]share
numbernullable

Share of reviews with that rating, 0 to 1.

datalistingisGuestFavorite
booleannullable

Whether it is a Guest favorite.

datalistingisNew
booleannullable

Whether the site marks it as new.

datalistingisLuxe
booleannullable

Whether it is an Airbnb Luxe home.

The host, as the listing page shows them to anyone: no contact details.

datalistinghostuserId
stringnullable

Host's Airbnb user id.

datalistinghostname
stringnullable

Host's first name as the page shows it.

datalistinghostprofileUrl
stringnullable

Host's public profile URL.

datalistinghostphotoUrl
stringnullable

Profile photo URL. Link only; not hosted by Social Fetch.

datalistinghostisSuperhost
booleannullable

Whether the host is a Superhost.

datalistinghostisVerified
booleannullable

Whether the host is verified.

datalistinghostyearsHosting
integernullable

Whole years hosting.

datalistinghostmonthsHosting
integernullable

Months hosting beyond `yearsHosting`.

datalistinghostrating
numbernullable

Host's average rating out of 5.

datalistinghostreviewCount
integernullable

Reviews of the host.

datalistinghostresponseRate
stringnullable

Response rate as shown, e.g. `100%`.

datalistinghostresponseTime
stringnullable

Response time as shown, e.g. `Responds within an hour`.

datalistinghostabout
stringnullable

What the host wrote about themselves.

Lines from the host's profile card, e.g. `My work: ...`.

datalistinghosthighlights[]
stringoptional

Highlights the page shows near the top. Some are summaries the site writes from reviews.

datalistinghighlights[]type
stringnullable

Kind, e.g. `LISTING_GUEST_FAVORITE` or `LISTING_SELF_CHECKIN`.

datalistinghighlights[]title
string

Heading as shown.

datalistinghighlights[]description
stringnullable

Line under it.

Every amenity, by section.

datalistingamenities[]group
stringnullable

Section, e.g. `Bathroom`.

datalistingamenities[]name
string

Amenity as shown, e.g. `Wifi`.

datalistingamenities[]description
stringnullable

Detail under it, when shown.

datalistingamenities[]available
boolean

False for an amenity the page lists as not included.

House rules, including check-in and check-out times.

datalistinghouseRules[]group
stringnullable

Section heading, when the page groups them.

datalistinghouseRules[]title
string

Item as shown.

datalistinghouseRules[]description
stringnullable

Detail under it, when shown.

Safety devices and property notes, e.g. cameras.

datalistingsafetyAndProperty[]group
stringnullable

Section heading, when the page groups them.

datalistingsafetyAndProperty[]title
string

Item as shown.

datalistingsafetyAndProperty[]description
stringnullable

Detail under it, when shown.

Where guests sleep.

datalistingsleepingArrangements[]room
string

Room, e.g. `Bedroom 1`.

datalistingsleepingArrangements[]beds
stringnullable

Beds as shown, e.g. `1 king bed`.

Every photo, in the photo tour's order.

datalistingphotos[]url
string

Photo URL. Link only; the image is not hosted by Social Fetch.

datalistingphotos[]caption
stringnullable

Caption, when the host wrote one.

datalistingphotos[]room
stringnullable

Room the photo tour files it under, e.g. `Bedroom`.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.