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 ("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, for places on a map search_maps. 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
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:
[
{
"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
This page as Markdown: /docs/tools/get_airbnb_listing.md. Something wrong or missing: hello@parel.si.