Read an Airbnb listing
GET /airbnb/listing — bearer auth, JSON responses, billed per successful request.
Read an Airbnb listing
Retrieves a single Airbnb listing as a structured object containing description, location, capacity, host details, amenities, house rules, check-in/out policies, safety information, cancellation policy, ratings, recent reviews, availability calendar, photo tour, and pricing for the requested dates. The listing is fetched from the URL's native Airbnb site using the request's locale, currency, guest count, and dates; the URL's query parameters are discarded.
When to use it: Use for one-off listing lookups where you need comprehensive data including dynamic pricing, or when you require immediate results rather than batch collection. For large-scale extraction, use /crawl instead; this endpoint returns 202 with a job ID if the fetch is slow, which you then collect via /crawl/{job}.
Notes
checkinandcheckoutare interdependent: both required or both omitted. Without them, the listing returns without pricing.premiumdefaults totrue; explicitly sendfalseto use the standard proxy pool.- Failed reads (500 responses) refund credits, but the attempt still counts against the target Airbnb site's rate limits.
| Parameter | In | Type | Description |
|---|---|---|---|
| url * | query | string<uri> | An Airbnb listing, `https://www.airbnb.com/rooms/<id>`, on any of Airbnb's sites. Anything else is refused. |
| adults | query | integer | How many adults are staying. Left to Airbnb when absent. |
| checkin | query | string<date> | The first night, as `YYYY-MM-DD`, today or later. **Requires `checkout`.** Optional: without dates Airbnb still shows the listings, it just prices no stay in particular. |
| checkout | query | string<date> | The day you leave, as `YYYY-MM-DD`, after `checkin`. **Requires `checkin`.** |
| locale | query | string | The language the page is shown in, the way Airbnb writes it: a language, or a language and region. Left to Airbnb when absent. |
| currency | query | string | The currency to price in, as a three-letter ISO 4217 code. Left to Airbnb when absent, which usually means the site's currency. |
| premium | query | string | Go through the premium proxy pool rather than the standard one. **On by default**; send `false` to use the standard pool. Free either way. `true`, `false`, `1`, `0`, `yes`, `no`, `on`, `off`, in any case. Anything else is refused rather than read as `false`. |
| country | query | string | The country to appear to be browsing from, as a two-letter ISO 3166-1 alpha-2 code. Free. Airbnb prices by where you are, so this can change the answer. Required to use `city`. |
| city | query | string | The city inside that country, as the pool spells it. **Requires `country`.** Free here, where on `/crawl` it doubles the price. |
| key | query | string | The API key, as an alternative to the `Authorization` header. Ignored when a header is present. |
curl -X GET "https://app.irmu.com/api/airbnb/listing?url=&adults=&checkin=&checkout=&locale=¤cy=&premium=&country=&city=&key=" \
-H "Authorization: Bearer $IRMU_API_KEY"{
"url": "https://www.airbnb.com/rooms/965075981702341405",
"place_id": "965075981702341405",
"locale": "en",
"currency": "INR",
"checkin": "2026-11-20",
"checkout": "2026-11-25",
"adults": null,
"listing": {
"id": "965075981702341405",
"name": "Rooftop studio near the old city",
"title": "Room in Jaipur, India",
"location": {
"name": "Jaipur, Rajasthan, India",
"latitude": 26.91,
"longitude": 75.82,
"exact": false
},
"rating": 4.9,
"reviewCount": 212,
"host": {
"name": "Aditi",
"superhost": true
},
"amenities": [
"Wifi",
"Kitchen",
"Air conditioning"
],
"checkIn": "Check in after 2:00 PM",
"cancellationPolicy": {
"until": "18 Nov",
"refund": "full",
"terms": "..."
},
"price": {
"total": 14800,
"taxes": 1776,
"nights": 5,
"nightlyRate": 2960,
"perNight": 2960
},
"available": true,
"reviews": [
{
"rating": 5,
"text": "Lovely stay.",
"date": "October 2026"
}
],
"calendar": [
{
"date": "2026-11-20",
"available": true,
"checkin": true,
"checkout": false,
"minNights": 1,
"maxNights": 30
}
],
"url": "https://www.airbnb.com/"
},
"credits_charged": 30,
"credits_remaining": 970,
"job_id": "0198a9b6-1f4c-7c3e-9a2b-5d8e6f0a1b23_0198a9b6-2a71-7f0d-8c44-9e1b3c5d7f02",
"status": "done",
"position": null,
"debug": null,
"error": null
}const res = await fetch("https://app.irmu.com/api/airbnb/listing", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.IRMU_API_KEY}`,
"Content-Type": "application/json",
}
});
const data = await res.json();import os, requests
res = requests.get(
"https://app.irmu.com/api/airbnb/listing",
headers={"Authorization": f"Bearer {os.environ['IRMU_API_KEY']}"}
)
print(res.json())| Status | Meaning |
|---|---|
| 200 | The listing. |
| 202 | Paid for and still going. Collect it from `/crawl/{job}`, free, as a slow crawl is collected. That endpoint answers the crawl envelope, so what is lifted out here arrives under `data` there. |
| 401 | No key, an unknown key, or a caller that is not an organization. |
| 402 | Not enough credits, or the daily limit is reached. Nothing is charged and no attempt is recorded. |
| 422 | A malformed request -- no url, a url that is not an Airbnb listing, one date without the other, dates in the past, or a flag that is not a yes or a no. |
| 500 | Nothing came back: the crawl failed outright, or the listing block found no listing -- a challenge page, a listing taken down, or a layout the block no longer matches. **The credits are refunded either way**, so `credits_charged` is `0`. The attempt is still recorded against the Airbnb site. |
| 503 | The crawl could not be routed through a proxy pool. Nothing is charged. |
Start building with Irmu today
200 free credits every month, no card required. Every API, every integration, one key.