# Airbnb (Chinese) — 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 for Airbnb accommodations and retrieve detailed information including property descriptions, guest reviews, availability calendars, and experience listings from the Chinese Airbnb platform. View comprehensive stay options with real-time availability data and verified guest feedback to help plan your next booking.

**Category:** Travel | **Website:** [zh.airbnb.com/](https://zh.airbnb.com/) | **Docs:** [parse.bot/marketplace/ef94e7e4-26c1-4710-bb11-6dda96a5349d/zh-airbnb-com-api](https://parse.bot/marketplace/ef94e7e4-26c1-4710-bb11-6dda96a5349d/zh-airbnb-com-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-zh-airbnb-com-api-ef94e7e4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing_availability

Get the availability calendar for a listing starting from a specific month and year. Returns 12 months of calendar data including per-day availability, booking constraints (min/max nights), and condition ranges. Each day includes whether it is available for check-in, check-out, and whether it is bookable.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | The Airbnb listing ID (numeric string). |
| `month` | integer | No | Starting month number (1-12). Defaults to the current month when omitted. |
| `year` | integer | No | Starting year (e.g. 2026). Defaults to the current year when omitted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zh-airbnb-com-api-ef94e7e4/get_listing_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"<string>","month":"<integer>","year":"<integer>"}'
```

### get_listing_details

Get full details for a specific Airbnb property listing, including description, amenities, location, host info, photos, reviews summary, and house rules. Provide optional checkin/checkout dates and guests count to see pricing information. Returns structured sections that each cover a different aspect of the listing (reviews, location, policies, booking).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `checkin` | string | No | Check-in date in YYYY-MM-DD format for pricing. |
| `checkout` | string | No | Check-out date in YYYY-MM-DD format for pricing. |
| `guests` | integer | No | Number of guests for pricing. |
| `listing_id` | string | Yes | The Airbnb listing ID (numeric string). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zh-airbnb-com-api-ef94e7e4/get_listing_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"checkin":"<string>","checkout":"<string>","guests":"<integer>","listing_id":"<string>"}'
```

### get_listing_reviews

Retrieve guest reviews for a specific Airbnb listing with pagination support. Returns up to 20 reviews per request sorted by quality by default. Each review includes the reviewer info, rating, comments, date, and optional host response. Use offset to paginate through all reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | The Airbnb listing ID (numeric string). |
| `offset` | integer | No | Pagination offset for reviews (increments of 20). |

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

### search_listings

Search for Airbnb property listings by location, dates, guests, and price filters. Returns paginated results with listing summaries including pricing, ratings, and photos. Paginates via an opaque cursor returned in paginationInfo.nextPageCursor. Without checkin/checkout dates, the server picks nearby available date ranges automatically.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `checkin` | string | No | Check-in date in YYYY-MM-DD format. |
| `checkout` | string | No | Check-out date in YYYY-MM-DD format. |
| `cursor` | string | No | Pagination cursor from a previous search response's paginationInfo.nextPageCursor. |
| `guests` | integer | No | Number of adult guests. |
| `price_max` | integer | No | Maximum total price filter. |
| `price_min` | integer | No | Minimum total price filter. |
| `query` | string | No | Search location query (city, region, or address). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zh-airbnb-com-api-ef94e7e4/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"checkin":"<string>","checkout":"<string>","cursor":"<string>","guests":"<integer>","price_max":"<integer>","price_min":"<integer>","query":"<string>"}'
```