> ## 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 Reviews API

> Extract Airbnb reviews (text, author, rating, date) from provided URLs, specifying a locale

`POST /v1/data/airbnb/reviews/run`

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

## Request

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

**urls** `string` *required*

Airbnb room URL to extract reviews from.

Format e.g. `https://www.airbnb.com/rooms/37879131`.

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

Localized reviews will be extracted in this locale (language and region).

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/reviews?expand=options`.

**maxResults** `integer`

Number of reviews to return. Use 0 for all.

## Example

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

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

r = requests.post(
    "https://api.mindcase.co/v1/data/airbnb/reviews/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "urls": "https://www.airbnb.com/rooms/12937",
    "locale": "en-US"
}},
)
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/reviews/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/12937",
  "locale": "en-US"
} }),
});
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 review, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `listingUrl` | Listing URL | url |
| `reviewId` | Review ID | text |
| `reviewText` | Review Text | text |
| `translatedText` | Translated Text | text |
| `originalLanguage` | Original Language | text |
| `rating` | Rating | rating |
| `postedDate` | Posted Date | text |
| `highlight` | Highlight | text |
| `highlightType` | Highlight Type | text |
| `hostResponse` | Host Response | text |
| `hostId` | Host ID | text |
| `hostName` | Host Name | text |
| `hostProfileUrl` | Host Profile URL | url |
| `reviewerUserId` | Reviewer User ID | text |
| `reviewerName` | Reviewer Name | text |
| `reviewerProfile` | Reviewer Profile | url |
| `reviewerAvatar` | Reviewer Avatar | url |
| `reviewerLocation` | Reviewer Location | text |
| `reviewerTenure` | Reviewer Tenure | text |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "airbnb/reviews",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "reviewerAvatar": "https://a0.muscache.com/im/pictures/user/8837fc4e-8ab2-43a1-9b71-bb127621ec2d.jpg",
      "reviewId": "1734926331335308010",
      "rating": 5,
      "hostProfileUrl": "https://www.airbnb.com/users/profile/1462507638639660367",
      "reviewerUserId": "516751905",
      "translatedText": "Orestes is an amazing host! The room was in excellent and clean condition when my mom and I first arrived. Orestes made us both feel at home and was very att...",
      "reviewerProfile": "https://www.airbnb.com/users/profile/1493258243503745267",
      "reviewerName": "Jared",
      "highlightType": "LENGTH_OF_STAY",
      "postedDate": "2026-07-21T17:48:55Z",
      "hostResponse": null,
      "hostName": "Orestes",
      "reviewerTenure": "3 years on Airbnb",
      "originalLanguage": "en",
      "hostId": "50124",
      "reviewerLocation": null,
      "highlight": "Stayed a few nights",
      "listingUrl": "https://www.airbnb.com/rooms/12937",
      "reviewText": "Orestes is an amazing host! The room was in excellent and clean condition when my mom and I first arrived. Orestes made us both feel at home and was very att..."
    }
  ]
}
```

## Related APIs

To find listings first use [`airbnb/listings`](https://docs.mindcase.co/apis/airbnb/listings).


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