GET
# Airbnb Listing Reviews API

Extract comprehensive guest reviews from Airbnb listings using the listing ID.

## Overview

#### Real-time Review Data

Get complete review content, ratings, and host responses with real-time data updates.

The Airbnb Listing Reviews endpoint provides access to detailed review data including guest profiles, ratings, review text, and host responses. Perfect for analyzing guest feedback and sentiment.

### Endpoint URL

GET https://api.stayapi.com/v1/airbnb/listing/reviews/{listing\_id} 

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| listing\_id | string | Required | Airbnb listing ID (path parameter). Use decimal digits as a string in client code to preserve long IDs. |
| limit | integer | Optional | Number of reviews per page (1-50, default: 10) |
| offset | string | Optional | Pagination offset (default: "0") |
| sort\_by | string | Optional | Sort order: BEST\_QUALITY or MOST\_RECENT (default: BEST\_QUALITY) |
| check\_in | string | Optional | Check-in date for contextual reviews (YYYY-MM-DD) |
| check\_out | string | Optional | Check-out date for contextual reviews (YYYY-MM-DD) |

## Response Structure

### Review Information

- `id` - Unique review identifier
- `rating` - Overall rating (1-5 stars)
- `text` - Full review text
- `language` - Review language code
- `created_at` - Review submission date

### Reviewer Details

- Reviewer ID and display name
- Profile picture URL
- Verification status

### Additional Data

- Host response text and date (if available)
- Total review count for pagination
- Pagination metadata

## Finding the Listing ID

#### Need the Listing ID?

Use the /listing/extract-id endpoint to extract the listing ID from any Airbnb URL.

The listing ID can be found in Airbnb URLs. For example:

`
            https://www.airbnb.com/rooms/22120898
          `

The listing ID is `22120898` (the number after "rooms/").

Request

```curl
curl -X GET "https://api.stayapi.com/v1/airbnb/listing/reviews/22120898?limit=10&offset=0" \
  -H "x-api-key: YOUR_API_KEY"
```

Response

```json
{
  "success": true,
  "listing_id": "22120898",
  "total_count": 321,
  "review_count": 10,
  "has_more": true,
  "reviews": [
    {
      "id": "1092837465",
      "rating": 5,
      "text": "What an amazing place! The views were absolutely stunning and the host was incredibly helpful throughout our stay. The apartment was spotlessly clean and exactly as described in the photos.",
      "language": "en",
      "created_at": "2024-03-15",
      "reviewer": {
        "id": "user_456789",
        "name": "Sarah Johnson",
        "picture_url": "https://a0.muscache.com/im/pictures/user/456789.jpg"
      },
      "host_response": {
        "text": "Thank you so much for your wonderful review, Sarah! We're thrilled you enjoyed your stay.",
        "created_at": "2024-03-16",
        "author": "Host"
      }
    },
    {
      "id": "1092736284",
      "rating": 4,
      "text": "Great location and comfortable apartment. Check-in was smooth and the host provided lots of local recommendations. Only minor issue was street noise at night.",
      "language": "en",
      "created_at": "2024-03-10",
      "reviewer": {
        "id": "user_123456",
        "name": "Michael Chen",
        "picture_url": null
      },
      "host_response": null
    }
  ]
}
```

```json
{
  "error": "Listing not found",
  "detail": "No listing found with ID: 999999999",
  "status_code": 404
}
```