scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTListing
  • POSTReviews
  • POSTSearch

Airbnb Search

1 credit

Search listings on Airbnb.

POST/api/v1/tools/airbnb/search

Parameters

locationstringrequired

Location to search (city, address, region).

checkInstring

Check-in date in YYYY-MM-DD format.

checkOutstring

Check-out date in YYYY-MM-DD format.

adultsnumber

Number of adults (min 1). Defaults to 1.

childrennumber

Number of children. Defaults to 0.

infantsnumber

Number of infants. Defaults to 0.

petsnumber

Number of pets. Defaults to 0.

minPricenumber

Minimum price per night.

maxPricenumber

Maximum price per night.

propertyTypestring[]

Property type filter. Array of: "entire_home", "private_room", "shared_room", "hotel_room".

minBedroomsnumber

Minimum number of bedrooms.

minBathroomsnumber

Minimum number of bathrooms.

minBedsnumber

Minimum number of beds.

superhostOnlyboolean

Only show Superhost listings. Defaults to false.

instantBookboolean

Only show Instant Book listings. Defaults to false.

maxResultsnumber

Maximum results. Defaults to 20.

maxPagesnumber

Maximum pages to fetch. Defaults to 5.

fieldsstring[]

Fields to include in response. Omit or pass ["*"] for all fields.

Response Schema

dataobject

Airbnb search result

resultsobject[]

Array of listing search results

countnumber

Number of results returned

truncatedboolean

True if results were cut short due to a timeout or server limit. Only present when truncation occurred.

metaobject

Request metadata

toolstring

Tool name (airbnb-search)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/airbnb/search \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "location": "Florence, Italy",
    "checkIn": "2026-05-01",
    "checkOut": "2026-05-05",
    "adults": 2,
    "superhostOnly": true
  }'

Response Example

{
  "data": {
    "results": [
      {
        "listingId": "12345678",
        "title": "Charming Loft in the Heart of Florence",
        "name": "Charming Loft in the Heart of Florence",
        "avgRatingLocalized": "4.92 (318)",
        "price": {
          "total": "$142",
          "qualifier": "per night",
          "accessibilityLabel": "$142 per night"
        },
        "badges": [
          {
            "text": "Guest favorite",
            "badgeType": "GUEST_FAVORITE"
          }
        ],
        "photos": [
          {
            "id": "photo_1",
            "url": "https://a0.muscache.com/im/pictures/...",
            "caption": "Living room"
          }
        ],
        "primaryLine": [
          "Entire rental unit",
          "2 beds"
        ],
        "secondaryLine": [
          "May 1-5"
        ],
        "coordinate": {
          "latitude": 43.7696,
          "longitude": 11.2558
        },
        "host": {
          "name": "Marco",
          "isSuperhost": true,
          "yearsHosting": 8,
          "ratingAverage": 4.95
        }
      }
    ],
    "count": 1,
    "truncated": false
  },
  "meta": {
    "tool": "airbnb-search",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}