---
title: "Scrape Airbnb stay listings"
method: POST
path: "/travel/airbnb"
tags: ["Plugins"]
---

# Scrape Airbnb stay listings

`POST /travel/airbnb`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/travel/airbnb`
- Auth: API key in header `x-scrapeunblocker-key`

Searches Airbnb for `location` and returns the stay listings as JSON: `name`, `roomType`, `price` (USD by default) with any original price, `rating` and `reviewCount`, coordinates, `badges` (e.g. Guest favourite), `image` and a clean room `url`. Filter with `checkin`/`checkout`, `adults`, `min_price`/`max_price` and `room_type`, and collect up to `max_results` across pages.

## Query parameters

- `location` string, required: City to search, e.g. 'Austin, TX' or 'Paris, France'.
- `checkin` string, nullable: Check-in date YYYY-MM-DD (with checkout).
- `checkout` string, nullable: Check-out date YYYY-MM-DD (with checkin).
- `adults` integer, nullable: Number of adult guests.
- `room_type` string, nullable: Room type filter: entire_home, private_room, hotel_room, shared_room. Omit for all.
- `min_price` integer, nullable: Minimum nightly price.
- `max_price` integer, nullable: Maximum nightly price.
- `max_results` integer: How many listings to collect across pages.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Defaults to US so prices are in USD.

## Response `200`

JSON with a `listings` array.

- unknown

## Other responses

- `400`: Invalid parameters.
- `422`: Validation Error
- `502`: Blocked by Airbnb, no results page returned, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)
