# Airbnb Search API

> Search Airbnb stays by location and dates, with listing name, price, rating, reviews, room type, photos and coordinates.

Source: https://www.sandbase.ai/apis/airbnb/search
API reference: https://www.sandbase.ai/apis/airbnb/search#api

## Facts

- Provider: Airbnb
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/airbnb/search`
- Price: $0.01 per call
- Capabilities: api, airbnb, travel, lodging
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/airbnb/search` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `q` | string | no |  |
| `map_bounds` | string | no |  |
| `airbnb_domain` | string | no |  |
| `currency` | string | no |  |
| `check_in_date` | string | no |  |
| `check_out_date` | string | no |  |
| `adults` | string | no |  |
| `children` | string | no |  |
| `infants` | string | no |  |
| `pets` | string | no |  |
| `room_type` | string | no |  |
| `min_price` | string | no |  |
| `max_price` | string | no |  |
| `bedrooms` | string | no |  |
| `beds` | string | no |  |
| `bathrooms` | string | no |  |
| `property_types` | string | no |  |
| `amenities` | string | no |  |
| `accessibility_features` | string | no |  |
| `host_languages` | string | no |  |
| `instant_book` | string | no |  |
| `self_check_in` | string | no |  |
| `guest_favorite` | string | no |  |
| `luxe` | string | no |  |
| `page` | string | no |  |
| `json_restrictor` | string | no |  |

## FAQ

### How do I use the Airbnb Search API?

Send a POST request to https://api.sandbase.ai/v1/api/airbnb/search with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Airbnb Search API cost?

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Airbnb Search API accept?

No parameters are required. Optional: q (string), map_bounds (string), airbnb_domain (string), currency (string), check_in_date (string) and check_out_date (string) and 20 more. The Parameters table and the Playground on this page list every field.

### What does the Airbnb Search API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Airbnb developer account or API key?

No. Airbnb Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Airbnb API access separately.

## README

### Airbnb Search

Search Airbnb stays by location and dates, with listing name, price, rating, reviews, room type, photos and coordinates.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/airbnb/search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "Austin, Texas"}'
```

The result is returned in `outputs[0].data` as structured JSON.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `q` | string | No | Parameter defines the destination to search for. You can use anything that you would use in a regular Airbnb search: a city, a region, a neighborhood, an address, or a landmark (e.g., `Austin, TX`, `Lake Tahoe`, or `Paris, France`). Either  |
| `map_bounds` | string | No | Parameter defines the GPS coordinates of the map area to search in, like moving the map on Airbnb. Only places within these bounds are shown. Its value must be 4 comma-separated numbers matching the following format: `north` + `,` + `east`  |
| `airbnb_domain` | string | No | Parameter defines the Airbnb domain to use. The domain sets the language, the region, and the default currency of the results (e.g., `airbnb.co.uk` for English (United Kingdom) in GBP, or `fr.airbnb.ca` for French (Canada) in CAD). It defau |
| `currency` | string | No | Parameter defines the currency of the returned prices. It defaults to the currency of the Airbnb domain (e.g., `USD` for `airbnb.com`, or `EUR` for `airbnb.fr`). Head to the Airbnb currencies page for a full list of supported currency codes |
| `check_in_date` | string | No | Parameter defines the check-in date. The format is **YYYY-MM-DD** (e.g., `2026-12-12`). It must be used together with `check_out_date`. When dates aren't set, Airbnb suggests dates for each place (usually a 5-night stay), and returns prices |
| `check_out_date` | string | No | Parameter defines the check-out date. The format is **YYYY-MM-DD** (e.g., `2026-12-16`). It must be used together with `check_in_date`, and be later than it. |
| `adults` | string | No | Parameter defines the number of adults (ages 13 or above). |
| `children` | string | No | Parameter defines the number of children (ages 2 to 12). |
| `infants` | string | No | Parameter defines the number of infants (under 2). |
| `pets` | string | No | Parameter defines the number of pets. When set, only places allowing pets are shown. |
| `room_type` | string | No | Parameter defines the type of place to show. It defaults to any type. Available options: `entire_home` - Entire home `private_room` - Private room To only show hotels, use `hotel` in `property_types`. |
| `min_price` | string | No | Parameter defines the minimum trip price, including all fees, like Airbnb's price range filter (e.g., `500`). It's in the currency of the results. When dates aren't set, it applies to a 5-night stay. |
| `max_price` | string | No | Parameter defines the maximum trip price, including all fees, like Airbnb's price range filter (e.g., `2000`). It's in the currency of the results. When dates aren't set, it applies to a 5-night stay. |
| `bedrooms` | string | No | Parameter defines the minimum number of bedrooms. |
| `beds` | string | No | Parameter defines the minimum number of beds. |
| `bathrooms` | string | No | Parameter defines the minimum number of bathrooms. |
| `property_types` | string | No | Parameter defines the property types to show. It's a comma-separated list of options (e.g., `house,guesthouse`). Available options: `house` - House `apartment` - Apartment `guesthouse` - Guesthouse `hotel` - Hotel |
| `amenities` | string | No | Parameter defines the amenities the places must have. It's a comma-separated list of options (e.g., `wifi,pool,free_parking`). Head to the Airbnb amenities page for a full list of supported amenities. |
| `accessibility_features` | string | No | Parameter defines the accessibility features the places must have. It's a comma-separated list of options (e.g., `step_free_access,step_free_shower`). Head to the Airbnb accessibility features page for a full list of supported accessibility |
| `host_languages` | string | No | Parameter defines the languages the host must speak. It's a comma-separated list of language codes (e.g., `en,es`). Head to the Airbnb host languages page for a full list of supported languages. |
| `instant_book` | string | No | Parameter defines whether to only show places that can be booked without waiting for the host's approval. It can be set to `true` or `false` (default). |
| `self_check_in` | string | No | Parameter defines whether to only show places with self check-in. It can be set to `true` or `false` (default). |
| `guest_favorite` | string | No | Parameter defines whether to only show Guest favorites, the most loved homes on Airbnb according to guests. It can be set to `true` or `false` (default). |
| `luxe` | string | No | Parameter defines whether to only show Airbnb Luxe places, luxury homes with elevated design. It can be set to `true` or `false` (default). |
| `page` | string | No | Value is used to get results on a specific page. (e.g., `1` (default) is the first page of results, `2` is the 2nd page of results, `3` is the 3rd page of results, etc.). Airbnb returns up to 18 results per page, and up to 15 pages. |
| `json_restrictor` | string | No | Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details. |

#### Pricing

$0.010 per successful call. Failed calls are not charged.