# Airbnb Room Scraper (x402)

> Airbnb Room Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Extracts structured listing data from Airbnb room URLs or IDs, optionally including availability and pricing for specific dates and guest counts.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/airbnb-rooms?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/airbnb-room-scraper-x402-23e57c3c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yDsAFC8SZhmMQcwBFz-yK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability airbnb-room-scraper-x402-23e57c3c -d '<json body>'
```

Example prompt: Can you pull the structured listing details — title, room type, property type, capacity, and description — for this Airbnb room https://www.airbnb.com/rooms/12345678, for 2 adults checking in on 2025-08-01 and checking out on 2025-08-07, in USD?

## When to prefer this

Use this endpoint when you need structured, machine-readable data from one or more specific Airbnb listings — especially when you already have the room URLs or IDs and want details like room type, capacity, description, and optionally availability pricing for specific dates and guest configurations. Prefer it over manual browsing or generic web scrapers because it returns clean, typed JSON with Airbnb-specific fields, charges only on successful non-empty runs, and handles locale and currency normalization natively.

## Known failure modes

- Invalid or private Airbnb room URL returns empty items array (no charge)
- Check-out date before or equal to check-in date causes validation error
- Room ID not found on Airbnb returns empty result
- Airbnb blocks scraping request intermittently, returning empty run (no charge)
- Malformed URL in startUrls array causes parsing failure

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of results and an array of room records, each containing the listing URL, title, room ID, overview, room type, property type, description, and maximum person capacity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pets": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Number of pets for dated booking details."
  },
  "adults": {
   "type": "integer",
   "default": 2,
   "minimum": 1,
   "description": "Number of adult guests for dated booking details."
  },
  "locale": {
   "type": "string",
   "default": "en",
   "description": "Language used for listing text, such as en, fr, de, es, or tr."
  },
  "checkIn": {
   "type": "string",
   "description": "Arrival date in YYYY-MM-DD. Set both dates to request availability and a price."
  },
  "infants": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Number of infants for dated booking details."
  },
  "checkOut": {
   "type": "string",
   "description": "Departure date in YYYY-MM-DD; must be after check-in."
  },
  "children": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Number of children for dated booking details."
  },
  "currency": {
   "type": "string",
   "default": "USD",
   "description": "Three-letter currency code for booking prices, such as USD, EUR, GBP, or TRY."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Maximum number of room records to save. Set 0 for no limit."
  },
  "startUrls": {
   "type": "array",
   "description": "Direct public room URLs or numeric room IDs. Paste one or more rooms to extract."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "title": null,
    "roomId": null,
    "overview": null,
    "roomType": null,
    "description": null,
    "propertyType": null,
    "personCapacity": null
   }
  ],
  "product": "airbnb-rooms"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/airbnb-room-scraper-x402-23e57c3c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)