> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_airbnb_listing

# get_airbnb_listing

> One Airbnb listing by link or id: type of place, guests, bedrooms, rating, reviews, description and photos. ₹0.12 per listing; a result that finds nothing is ₹0.

## What it does

One Airbnb listing, by its URL or its id (the number after /rooms/): data[] with one row holding name, type ("Entire apartment"), city, latitude and longitude, guests, bedrooms, beds and baths, rating and review_count, the description, photos and the listing URL. There is no price, because Airbnb prices a stay by its dates, and it does not search for listings: find listing links with [`search_web`](https://parel.si/docs/tools/search_web.md) ("site:airbnb.com/rooms Goa villa").

Use it to read the details of stays you already have links for, or to compare a few; for hotels use [`search_hotels`](https://parel.si/docs/tools/search_hotels.md), for places on a map [`search_maps`](https://parel.si/docs/tools/search_maps.md). Flat price per listing; a listing that does not exist is free. About one second.

India: works for listings in India; text comes back in the language the host wrote it in.

## Inputs

Generated from the contract captured from staging on 2026-11-17.

| Field | Type | Required | Description |
|---|---|---|---|
| `listing` | string | yes | The listing's URL or its id, the number after /rooms/ ("678901120783302718"). |

## What drives the cost

One listing per call, by URL or id; no search and no price. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.12** per listing (`cost_paise: 12`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_airbnb_listing"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_airbnb_listing"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_airbnb_listing","input":{"listing":"678901120783302718"}}'
```

## What comes back

`data`, as the live check of 2026-11-17 recorded it, trimmed:

```json
[
  {
    "baths": 1,
    "bedrooms": 1,
    "beds": 1,
    "city": "New York City",
    "description": "Make Chelsea your home in New York. You'll feel right at home in this Chelsea condo.  Relax after a long day with a smart TV and sound system. Walk to dozens of great restaurants, or cook up a storm in the chef's kitchen. If you'd like to e…",
    "guests": 2,
    "latitude": 40.7426,
    "listing_id": "678901120783302718",
    "longitude": -74.0011,
    "name": "Your home in New York: Chic & Spacious Chelsea 1BR",
    "photos": [
      "https://a0.muscache.com/im/pictures/miso/Hosting-678901120783302718/original/94ecde23-c90d-40f8-9f70-95f963a0725b.jpeg",
      "https://a0.muscache.com/im/pictures/miso/Hosting-678901120783302718/original/20f11c99-9da1-4ec7-921a-4e4b800f6e26.jpeg",
      "https://a0.muscache.com/im/pictures/miso/Hosting-678901120783302718/original/66f7f878-5f41-41b7-90d3-98b2bc3285e4.jpeg"
    ],
    "rating": 5,
    "review_count": 9,
    "type": "Entire condo",
    "url": "https://www.airbnb.com/rooms/678901120783302718"
  }
]
```

## Notes

- One listing per call, by URL or id; no search and no price.
- A removed or unknown listing comes back empty and is free.
- Find listing links with search_web on site:airbnb.com/rooms plus the place.

## Siblings

- [`search_web`](https://parel.si/docs/tools/search_web.md)
- [`search_hotels`](https://parel.si/docs/tools/search_hotels.md)
- [`search_maps`](https://parel.si/docs/tools/search_maps.md)
