> **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/search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/airbnb/search.mdx>

---

# Airbnb Search API

The stays Airbnb shows for a place, up to 18 a page, priced for your dates and guests.

`GET /v1/airbnb/search` takes `location` (a city, region or neighbourhood as you would type it on the site), `checkIn` and `checkOut` (`YYYY-MM-DD`, both or neither), `adults` (default 1), `children`, `infants`, `pets` and `currency` (default `USD`). Each stay has `listingId`, `url`, `name`, `title`, `subtitle`, `area`, `coordinates`, `rating`, `reviewCount`, badges, highlights such as beds and baths, photos and a `price` with the total, nights, nightly rate, the breakdown and the original price before a discount.

Without dates each stay is priced for its own next free dates, given as its `checkIn` and `checkOut`. `data.resolvedLocation` is the place the site matched, and `data.totalResultsText` its own count line. Place names with accents or in other scripts work too, such as `Zürich` or `東京`; a place the site cannot find answers `lookupStatus: not_found`. Follow `page.nextCursor` with the same parameters, up to page 15; `page.truncated` is true when more stays match than those pages reach.

## Request

- **Endpoint:** `GET /v1/airbnb/search`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by location and dates
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/airbnb/search/get)
- **Platform page:** [/platforms/airbnb](https://www.socialfetch.dev/platforms/airbnb)

## FAQ

### Do the prices include fees?

Yes. Totals include the cleaning and service fees, as the site shows them (feesIncluded: true). taxesIncluded is false when the site prices before taxes, which is the usual case, and null when it does not say.

### Which currencies are supported?

Any of the 48 three-letter codes Airbnb prices in, such as USD, EUR, GBP, JPY or CHF. An unknown code is refused with a free 400, because the site would quietly answer in dollars.

### Why can a page hold fewer than 18 stays?

Airbnb re-ranks stays between requests, so a stay already returned on an earlier page can come back later. Those repeats are left out, so each stay appears once across the pages you fetch with the cursor.

### How many credits does a request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.
