Irmu
API Reference

Search Airbnb

GET /airbnb/search — bearer auth, JSON responses, billed per successful request.

GET/airbnb/search

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 limit still consume the full estimated credits
  • checkin and checkout are interdependent—either both must be provided or both omitted; single-date requests return 422
  • country is required when using city, and premium defaults to enabled unless explicitly set to false with accepted boolean spellings
ParameterInTypeDescription
destination *querystringWhere to stay, as you would type it into Airbnb's search box.
domainquerystringThe Airbnb site to search on, which sets the market -- `www.airbnb.co.in`, `www.airbnb.es`. Only Airbnb's own sites are accepted.
checkinquerystring<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.
checkoutquerystring<date>The day you leave, as `YYYY-MM-DD`, after `checkin`. **Requires `checkin`.**
localequerystringThe language the page is shown in, the way Airbnb writes it: a language, or a language and region. Left to Airbnb when absent.
currencyquerystringThe currency to price in, as a three-letter ISO 4217 code. Left to Airbnb when absent, which usually means the site's currency.
price_typequerytrip | nightWhich 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_cancellationquerystringOnly listings with free cancellation. Accepts the same spellings as `premium`.
instant_bookquerystringOnly listings that can be booked without the host approving.
guest_favoritequerystringOnly listings Airbnb marks as a guest favourite.
self_check_inquerystringOnly listings with self check-in.
pagequeryintegerThe results page to start from, counting from 0. Airbnb pages a search up to page 14.
limitqueryintegerHow many listings to return, read on through as many pages as that takes. **Each page of 18 is 30 credits.**
premiumquerystringGo 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`.
countryquerystringThe 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`.
cityquerystringThe city inside that country, as the pool spells it. **Requires `country`.** Free here, where on `/crawl` it doubles the price.
keyquerystringThe API key, as an alternative to the `Authorization` header. Ignored when a header is present.
request.sh
curl -X GET "https://app.irmu.com/api/airbnb/search?destination=&domain=&checkin=&checkout=&locale=&currency=&price_type=&free_cancellation=&instant_book=&guest_favorite=&self_check_in=&page=&limit=&premium=&country=&city=&key=" \
  -H "Authorization: Bearer $IRMU_API_KEY"
200.json
{
  "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
}

Guides using this endpoint

    Airbnb API overview →
    request.js
    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();
    request.py
    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())
    StatusMeaning
    200The listings.
    202Paid 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.
    401No key, an unknown key, or a caller that is not an organization.
    402Not enough credits, or the daily limit is reached. Nothing is charged and no attempt is recorded.
    422A 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.
    500The crawl failed outright. **The credits are refunded**, so `credits_charged` is `0`. The attempt is still recorded against the Airbnb site.
    503The 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.