# Airbnb (United Kingdom) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search Airbnb UK listings and access detailed information including pricing, availability calendars, and guest reviews. Plan your trips by comparing properties and experiences across locations with real-time data on rates and booking availability.

**Category:** Travel | **Website:** [airbnb.co.uk/](https://airbnb.co.uk/) | **Docs:** [parse.bot/marketplace/bb146e7a-508c-460e-a019-78054521fa7d/airbnb-co-uk-api](https://parse.bot/marketplace/bb146e7a-508c-460e-a019-78054521fa7d/airbnb-co-uk-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-airbnb-co-uk-api-bb146e7a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_experience_availability

Check upcoming availability for an Airbnb Experience by its ID. Returns up to 5 upcoming time slots with capacity information. A single request; no pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `experience_id` | string | Yes | The numeric experience ID (e.g. '165149') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-airbnb-co-uk-api-bb146e7a/get_experience_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"experience_id":"<string>"}'
```

### get_listing_availability

Get the availability calendar for a listing for the next 12 months. Returns day-by-day availability and pricing for each month. A single request; no pagination needed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `room_id` | string | Yes | The numeric room ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-airbnb-co-uk-api-bb146e7a/get_listing_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_id":"<string>"}'
```

### get_listing_details

Get full details for a specific listing by its room ID, including HTML description, amenities list, host info, rating, reviews count, location coordinates, and cover image. A single GraphQL round-trip; no pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `room_id` | string | Yes | The numeric room ID (e.g. '13512606') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-airbnb-co-uk-api-bb146e7a/get_listing_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_id":"<string>"}'
```

### get_listing_reviews

Get guest reviews for a specific listing. Returns reviews sorted by quality (best first). Supports manual pagination via offset and limit parameters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of reviews to return |
| `offset` | integer | No | Pagination offset |
| `room_id` | string | Yes | The numeric room ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-airbnb-co-uk-api-bb146e7a/get_listing_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","room_id":"<string>"}'
```

### search_listings

Search for accommodation listings by location with optional date and guest filters. Returns up to 18 listings per page. Paginates via an opaque cursor returned as next_cursor. Each listing includes coordinates, rating summary, and a total-stay price for the given dates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adults` | integer | No | Number of adults |
| `checkin` | string | No | Check-in date in YYYY-MM-DD format. Defaults to 7 days from today if omitted. |
| `checkout` | string | No | Check-out date in YYYY-MM-DD format. Defaults to 14 days from today if omitted. |
| `cursor` | string | No | Pagination cursor from a previous search_listings response's next_cursor field |
| `location` | string | Yes | Location string using Airbnb URL slug format (e.g. 'London--United-Kingdom', 'Paris--France', 'New-York--NY--United-States') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-airbnb-co-uk-api-bb146e7a/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","checkin":"<string>","checkout":"<string>","cursor":"<string>","location":"<string>"}'
```