> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/airbnb>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/airbnb.mdx>

---

# Airbnb API. Stays, prices, reviews and availability.

Search stays the way a guest does, with dates, guests and currency, read any public listing with its host, amenities and house rules, page through its reviews and see which nights are free. JSON in, JSON out.

- Stays and prices
- Guest reviews
- Availability calendars

Social Fetch exposes four routes under `/v1/airbnb`. `GET /v1/airbnb/search` takes a `location` (a city, region or neighbourhood as you would type it on the site), optional `checkIn` and `checkOut` dates, `adults`, `children`, `infants`, `pets` and a `currency`, and returns up to 18 stays a page with the total price for the stay, the nightly rate and the breakdown, rating and review count, badges, photos and map position. Without dates each stay is priced for its own next free dates, which the result names. `resolvedLocation` names the place the site matched, and a place it cannot find answers `lookupStatus: not_found`. Follow `page.nextCursor` for up to the 15 pages the site offers; `page.truncated` says when more stays match than that.

`GET /v1/airbnb/listings/{listingId}` returns one listing: name, description, property and room type, guests, bedrooms, beds and baths, every amenity, house rules, safety notes, sleeping arrangements, photos by room, ratings per category and the host as the page shows them. The listing id is the number in a listing URL, and the full URL works too.

`GET /v1/airbnb/listings/{listingId}/reviews` pages through guest reviews in four orders with translations into your choice of about 50 languages and host replies, and `.../availability` returns up to twelve months of the calendar, day by day, with minimum and maximum stays. Every response uses the `{ data, meta }` envelope; lookups set `data.lookupStatus` to `found` or `not_found`.

## What you can get

- Search stays for any place with check-in and check-out dates, adults, children, infants and pets, priced in any of 48 currencies.
- Prices with the total for the stay, nights, nightly rate, discounts and the original price, fees included and taxes stated.
- Full listings: description, property and room type, capacity, bedrooms, beds and baths, amenities, house rules, safety notes and photos by room.
- Ratings overall and for cleanliness, accuracy, check-in, communication, location and value, with the share of each star rating.
- Guest reviews newest, most relevant, highest or lowest rated first, 50 a page, with translations into about 50 languages and host replies.
- Availability calendars for up to twelve months: free nights, check-in and check-out days, minimum and maximum stays.

## Airbnb endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Stays search | GET /v1/airbnb/search | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/airbnb/search/get) |
| Listing | GET /v1/airbnb/listings/{listingId} | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/airbnb/listings/listingid/get) |
| Listing reviews | GET /v1/airbnb/listings/{listingId}/reviews | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/airbnb/listings/listingid/reviews/get) |
| Listing availability | GET /v1/airbnb/listings/{listingId}/availability | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/airbnb/listings/listingid/availability/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try a search, a listing, its reviews and its calendar.
2. **Search or look up.** `GET /v1/airbnb/search?location=London&checkIn=2027-03-01&checkOut=2027-03-04&adults=2` returns a page of stays. Take a stay's `listingId` to `GET /v1/airbnb/listings/{listingId}`, `.../reviews` and `.../availability`. Send `x-api-key` on every request.
3. **Branch and page.** Check `data.lookupStatus` before you store a row, follow `page.nextCursor` with the same parameters, and bill from `meta.creditsCharged`.

## Pricing

Every Airbnb route costs 1 credit per completed request, found, empty or not found. Each page of search results or reviews is its own request. Failed requests and invalid parameters are free. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Airbnb's own API is open only to approved hosting partners, and it does not cover search or other hosts' listings. Social Fetch gives you one JSON shape under `/v1/airbnb`: typed prices with their currency, ISO dates, listing ids as strings, `not_found` for removed listings and cursors that never repeat a stay. Hosts and guests appear as the listing page shows them to anyone: first names, photos and public profiles, never contact details or an exact address.

## FAQ

### Is there an Airbnb API for listings and prices?

Yes. Social Fetch has four Airbnb routes under /v1/airbnb: stays search with prices, a listing, a listing's guest reviews and its availability calendar. Authenticate with your Social Fetch API key in x-api-key.

### How do I get prices for specific dates?

Pass checkIn and checkOut (YYYY-MM-DD) with adults, children, infants and pets to GET /v1/airbnb/search. Each stay comes back with the total for those nights, the nightly rate and the breakdown in the currency you ask for (USD by default). Without dates, each stay is priced for its own next free dates, given as its checkIn and checkOut.

### Do the prices include fees and taxes?

The totals include the cleaning and service fees, as Airbnb shows them, so feesIncluded is always true. taxesIncluded says whether taxes are in the total: false when the site prices before taxes, which is the usual case.

### How do I find a listing id?

It is the number in a listing URL, for example 1900063 in airbnb.com/rooms/1900063. Pass the number or the whole URL from any Airbnb country site. Search results carry the listingId of every stay they return.

### How does paging work?

Search and reviews return page.hasMore and page.nextCursor. Pass the cursor back with the same parameters; one used with other parameters is refused with a free 400. Airbnb re-ranks stays between requests, so a stay already returned is left out of later pages and a page can hold fewer than 18 rows. Search reaches the 15 pages the site offers, and page.truncated says when more stays match.

### Does the API return host contact details?

No. Airbnb shows no phone number, email or exact address logged out, so none is returned. A listing names the host by first name with their photo, profile link, Superhost status, years hosting, response rate and what they wrote about themselves. Map positions are the approximate point the listing page shows.

### What happens when a listing has been removed?

The response is HTTP 200 with data.lookupStatus not_found, for the listing, its reviews and its calendar alike. The lookup is still charged, like any completed request.

### Can I use the Airbnb routes from MCP or Ask?

Yes. Every Airbnb route is a typed MCP tool and is reachable through Ask (POST /v1/ask) in plain English. Use the typed routes for production jobs, where the parameters and response shape are fixed.

## Related

- [Airbnb Search API](https://www.socialfetch.dev/platforms/airbnb/search): Stays for a place, dates and guests with prices (`GET /v1/airbnb/search`).
- [Airbnb Listing API](https://www.socialfetch.dev/platforms/airbnb/listings-listingid): One listing with host, amenities, rules and ratings (`GET /v1/airbnb/listings/{listingId}`).
- [Airbnb Reviews API](https://www.socialfetch.dev/platforms/airbnb/listings-listingid-reviews): Guest reviews with translations and host replies (`GET /v1/airbnb/listings/{listingId}/reviews`).
- [Airbnb Availability API](https://www.socialfetch.dev/platforms/airbnb/listings-listingid-availability): Free nights and stay limits day by day (`GET /v1/airbnb/listings/{listingId}/availability`).
