# Airbnb Room Details Scraper

> Airbnb Room Details Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Extracts structured listing data from one or more Airbnb room URLs or IDs, optionally with dated pricing and availability for specific guest counts.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-details-scraper-d927cc05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2L6_8TiMJAPks_qe0SNnX

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-details-scraper-d927cc05 -d '<json body>'
```

Example prompt: Pull the listing details for this Airbnb room — https://www.airbnb.com/rooms/12345678 — for 2 adults checking in on 2025-08-10 and checking out on 2025-08-15, priced in USD.

## When to prefer this

Use this endpoint when you need structured, machine-readable Airbnb listing data — room type, capacity, description, pricing — from one or more specific room URLs or IDs. It is ideal when you already know which listings to inspect and want clean JSON output without scraping Airbnb manually. It supports dated availability and multi-guest pricing, making it suitable for travel planning agents, rental comparison tools, and property research pipelines.

## Known failure modes

- Invalid or private Airbnb URL returns an empty items array
- Check-out date before check-in date may produce no pricing data
- Unsupported locale or currency code may fall back to defaults
- Rate limiting or Airbnb blocking may result in empty or partial results
- Malformed room IDs return empty records

## 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 room URL, title, room ID, overview text, room type, full description, property type, and person capacity. Failed or empty runs are not billed.

## 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-details-scraper-d927cc05/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)
