> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Airbnb Listings API

> Get Airbnb listing records (price, availability, ratings, host info, amenities, photos) by listing URL or by location search

`POST /v1/data/airbnb/listings/run`

**Pricing:** $0.002 per listing ($2.00 per 1,000).

## Ways to call it

* **URL**: set `urls`
* **Location**: set `location` (optional: `maxResults`, `checkIn`, `checkOut`, `adults`, `children`, `infants`, `pets`, `priceMin`, ...)

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**urls** `string[]`

Airbnb listing URLs ([https://www.airbnb.com/rooms/](https://www.airbnb.com/rooms/)...) to fetch details for.

**location** `string`

Place to search (e.g. "Paris, France" or "Lisbon"). Returns listings in that area.

**maxResults** `integer` (default: 100)

How many listings to return from a location search. Defaults to 100; at most 5,000. Not used with listing URLs, which return one listing per URL.

Min `1`; max `5000`.

**priceMin** `integer`

Minimum nightly price filter (location search only).

**priceMax** `integer`

Maximum nightly price filter (location search only).

**minBedrooms** `integer`

Minimum number of bedrooms (location search only).

**minBeds** `integer`

Minimum number of beds (location search only).

**minBathrooms** `integer`

Minimum number of bathrooms (location search only).

**checkIn** `date`

Check-in date for availability and price.

Use together with `checkout`.

**checkOut** `date`

Check-out date for availability and price.

Use together with `checkin`.

**adults** `integer`

Number of adults in the party.

**children** `integer`

Number of children (ages 2-12).

**infants** `integer`

Number of infants (under 2).

**pets** `integer`

Number of pets.

**locale** `string` (default: en-US)

Language and region for the listing data.

93 allowed values, for example `en-US`, `az-AZ`, `id-ID`, `bs-BA`, `ca-ES`, `cs-CZ`, `sr-ME`, `da-DK`, `de-DE`, `de-AT`. Fetch the full list with `GET /v1/data/airbnb/listings?expand=options`.

**currency** `string` (default: USD)

Currency for prices.

48 allowed values, for example `USD`, `CZK`, `AUD`, `BRL`, `BGN`, `CAD`, `CLP`, `CNY`, `COP`, `CRC`. Fetch the full list with `GET /v1/data/airbnb/listings?expand=options`.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/airbnb/listings/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": [
      "https://www.airbnb.com/rooms/37879131",
      "https://www.airbnb.com/rooms/1010503905929192028",
      "https://www.airbnb.com/rooms/1404403902815216178"
    ],
    "locale": "en-US",
    "currency": "USD"
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/airbnb/listings/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "urls": [
        "https://www.airbnb.com/rooms/37879131",
        "https://www.airbnb.com/rooms/1010503905929192028",
        "https://www.airbnb.com/rooms/1404403902815216178"
    ],
    "locale": "en-US",
    "currency": "USD"
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/airbnb/listings/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "urls": [
    "https://www.airbnb.com/rooms/37879131",
    "https://www.airbnb.com/rooms/1010503905929192028",
    "https://www.airbnb.com/rooms/1404403902815216178"
  ],
  "locale": "en-US",
  "currency": "USD"
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one listing, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `listingUrl` | Listing URL | url |
| `title` | Title | text |
| `propertyType` | Property Type | text |
| `roomType` | Room Type | text |
| `capacity` | Capacity | number |
| `summaryDetails` | Summary Details | array |
| `description` | Description | text |
| `location` | Location | text |
| `locationSubtitle` | Location Subtitle | text |
| `locationPath` | Location Path | text |
| `latitude` | Latitude | number |
| `longitude` | Longitude | number |
| `neighborhoodNotes` | Neighborhood Notes | object\_array |
| `ratings` | Ratings | object |
| `highlights` | Highlights | object\_array |
| `amenities` | Amenities | array |
| `houseRules` | House Rules | array |
| `cancellationPolicy` | Cancellation Policy | text |
| `available` | Available | boolean |
| `totalPrice` | Total Price | text |
| `pricePerNight` | Price Per Night | text |
| `baseSubtotal` | Base Subtotal | text |
| `priceQualifier` | Price Qualifier | text |
| `host` | Host | object |
| `coHosts` | Co-Hosts | object\_array |
| `images` | Images | object\_array |
| `thumbnail` | Thumbnail | url |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "airbnb/listings",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "amenities": [
        {
          "group": "Bathroom",
          "available": [
            "Hair dryer",
            "Cleaning products",
            "Body soap"
          ],
          "notIncluded": []
        },
        {
          "group": "Bedroom and laundry",
          "available": [
            "Washer",
            "Free dryer – In unit",
            "Essentials"
          ],
          "notIncluded": []
        }
      ],
      "cancellationPolicy": "Moderate",
      "locationPath": "France > Seine",
      "available": true,
      "capacity": 2,
      "priceQualifier": "total",
      "roomType": "Entire home/apt",
      "images": [
        {
          "caption": "Living room image 1",
          "url": "https://a0.muscache.com/im/pictures/hosting/Hosting-1415233876995002398/original/e242f023-8130-48b8-b3e2-f3e78c23820b.png"
        },
        {
          "caption": "Full kitchen image 1",
          "url": "https://a0.muscache.com/im/pictures/hosting/Hosting-1415233876995002398/original/fb4516dc-7e47-4701-9a92-556bcc6cf348.png"
        }
      ],
      "ratings": {
        "overall": 4.98,
        "accuracy": 4.98,
        "cleanliness": 4.93,
        "checkIn": 4.99,
        "communication": 4.99,
        "location": 4.93,
        "value": 4.89,
        "reviewsCount": 162
      },
      "neighborhoodNotes": [
        {
          "title": "Livry-Gargan, Île-de-France, France",
          "content": null
        }
      ],
      "totalPrice": "$1,497",
      "pricePerNight": "$305.32",
      "houseRules": [
        {
          "section": "Checking in and out",
          "rule": "Check-in after 3:00 PM",
          "detail": null
        },
        {
          "section": "Checking in and out",
          "rule": "Checkout before 11:00 AM",
          "detail": null
        }
      ],
      "summaryDetails": [
        "2 guests",
        "1 bedroom"
      ],
      "description": "Welcome to CASALOVA, a luxurious cocoon with a unique design, a home theater with a giant screen, a round king-size bed, a high-end marble kitchen, and a spa...",
      "longitude": 2.535341518738394,
      "baseSubtotal": "$1,526.62",
      "propertyType": "Entire home",
      "coHosts": [],
      "location": "Livry-Gargan",
      "highlights": [
        {
          "title": "Top 5% of homes",
          "subtitle": "This home is highly ranked based on ratings, reviews, and reliability.",
          "type": "LISTING_GUEST_FAVORITE"
        },
        {
          "title": "Self check-in",
          "subtitle": "Check yourself in with the lockbox.",
          "type": "LISTING_SELF_CHECKIN"
        }
      ],
      "latitude": 48.91105100361872,
      "host": {
        "name": "Lenny",
        "photo": "https://a0.muscache.com/im/pictures/user/User/original/26a4bce4-da48-4628-9a0a-74ed2f2d700d.jpeg",
        "profileUrl": "https://www.airbnb.com/users/profile/694065291",
        "isSuperhost": true,
        "isVerified": true,
        "rating": 4.98,
        "ratingCount": 162,
        "about": null,
        "timeAsHostMonths": 14
      },
      "listingUrl": "https://www.airbnb.com/rooms/1415233876995002398",
      "title": "La Casalova\nHot Tub Haven with Big Screen"
    }
  ]
}
```

## Related APIs

For review text use [`airbnb/reviews`](https://docs.mindcase.co/apis/airbnb/reviews).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.