Search Airbnb
GET /airbnb/search — bearer auth, JSON responses, billed per successful request.
Search Airbnb
Searches Airbnb listings by scraping Airbnb's own URL structure and rendered page data, returning structured results with resolved numeric prices, ratings, beds, bathrooms, badges, and photos. Results are paginated automatically in batches of 18 until the requested limit is reached.
When to use it: Use this endpoint when you need Airbnb search data without maintaining your own scraping infrastructure, particularly for price monitoring, market research, or travel product integrations where real-time listing data matters. For large-scale ongoing collection, prefer /crawl with callback delivery; use this synchronous endpoint for ad-hoc queries or when you need immediate results.
- Credits are charged per page of 18 results (30 credits each) upfront when the crawl starts, not upon completion; empty searches and searches with fewer results than
limitstill consume the full estimated credits checkinandcheckoutare interdependent—either both must be provided or both omitted; single-date requests return 422countryis required when usingcity, andpremiumdefaults to enabled unless explicitly set tofalsewith accepted boolean spellings
| Parameter | In | Type | Description |
|---|---|---|---|
| destination * | query | string | Where to stay, as you would type it into Airbnb's search box. |
| domain | query | string | The Airbnb site to search on, which sets the market -- `www.airbnb.co.in`, `www.airbnb.es`. Only Airbnb's own sites are accepted. |
| 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. |
| price_type | query | trip | night | Which price leads each listing's `price.amount`: the stay's total (`trip`, Airbnb's own default) or a night's (`night`). Both are in `price` either way. |
| free_cancellation | query | string | Only listings with free cancellation. Accepts the same spellings as `premium`. |
| instant_book | query | string | Only listings that can be booked without the host approving. |
| guest_favorite | query | string | Only listings Airbnb marks as a guest favourite. |
| self_check_in | query | string | Only listings with self check-in. |
| page | query | integer | The results page to start from, counting from 0. Airbnb pages a search up to page 14. |
| limit | query | integer | How many listings to return, read on through as many pages as that takes. **Each page of 18 is 30 credits.** |
| 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/search?destination=&domain=&checkin=&checkout=&locale=¤cy=&price_type=&free_cancellation=&instant_book=&guest_favorite=&self_check_in=&page=&limit=&premium=&country=&city=&key=" \
-H "Authorization: Bearer $IRMU_API_KEY"{
"destination": "Jaipur",
"domain": "www.airbnb.co.in",
"locale": "en-IN",
"currency": "INR",
"checkin": "2026-11-20",
"checkout": "2026-11-25",
"price_type": null,
"free_cancellation": null,
"instant_book": null,
"guest_favorite": null,
"self_check_in": null,
"page": 0,
"limit": 18,
"listings": [
{
"id": "16208150",
"url": "https://www.airbnb.co.in/rooms/16208150?check_in=2026-11-20&check_out=2026-11-25",
"name": "Bright Park-View Room Unique Rooftop Stay",
"title": "Room in Jaipur",
"propertyType": "Room",
"coordinates": {
"latitude": 26.8916,
"longitude": 75.8234
},
"rating": 4.93,
"reviewCount": 107,
"price": {
"amount": 14800,
"currency": "INR",
"type": "trip",
"total": 14800,
"perNight": 2960,
"nights": 5,
"nightlyRate": 3700,
"originalTotal": 18500
},
"beds": [
"1 single bed"
],
"bathrooms": "1 bathroom",
"guestFavorite": true,
"freeCancellation": true,
"image": "https://a0.muscache.com/im/pictures/1.jpg",
"position": 1,
"page": 0
}
],
"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/search", {
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/search",
headers={"Authorization": f"Bearer {os.environ['IRMU_API_KEY']}"}
)
print(res.json())| Status | Meaning |
|---|---|
| 200 | The listings. |
| 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 destination, a domain that is not an Airbnb site, one date without the other, dates in the past, a limit over 90, or a flag that is not a yes or a no. |
| 500 | The crawl failed outright. **The credits are refunded**, 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.