GET
# Airbnb Listing Details API

Extract property details from Airbnb listings including title, rating, host info, and guest policies.

## Overview

#### Checkout Data

This endpoint uses Airbnb's checkout API to get accurate, real-time listing information including guest policies.

The Airbnb Listing Details endpoint provides comprehensive property information including listing title, rating, host name, badges, and guest capacity. Requires check-in/check-out dates to access the data.

### Endpoint URL

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

## 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. |
| check\_in | string | Required | Check-in date in YYYY-MM-DD format |
| check\_out | string | Required | Check-out date in YYYY-MM-DD format |
| adults | integer | Optional | Number of adults (1-16, default: 1) |
| children | integer | Optional | Number of children (0-10, default: 0) |
| infants | integer | Optional | Number of infants (0-5, default: 0) |
| pets | integer | Optional | Number of pets (0-5, default: 0) |
| currency | string | Optional | Currency code (default: USD) |

## Response Structure

### Listing Information

- `title` - Property title
- `image_url` - Main listing image
- `rating` - Average rating (e.g., "4.86 (886)")
- `rating_count` - Number of reviews
- `badge` - Award badge (e.g., "Guest favorite")
- `host_name` - Host display name

### Guest Policies

- `max_guests` - Maximum guest capacity
- `children_allowed` - Whether children are welcome
- `infants_allowed` - Whether infants are welcome
- `pets_allowed` - Whether pets are allowed

#### Looking for the property description?

The checkout API that powers this endpoint does not include the listing description. Use the [Listing Overview](/docs/endpoints/airbnb/overview) endpoint to get the full property description (plus bedroom, bed, and bath counts).

## 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/22135033
          `

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

Request

```curl
curl -X GET "https://api.stayapi.com/v1/airbnb/listing/22135033/details?check_in=2026-01-30&check_out=2026-02-01&adults=2" \
  -H "x-api-key: YOUR_API_KEY"
```

Response

```json
{
  "success": true,
  "listing_id": "22135033",
  "check_in": "2026-01-30",
  "check_out": "2026-02-01",
  "nights": 2,
  "details": {
    "title": "Central Warsaw Studio \"Zgoda BLUE\"",
    "image_url": "https://a0.muscache.com/im/pictures/804ec3dd-...",
    "rating": "4.86 (886)",
    "rating_count": 886,
    "badge": "Guest favorite",
    "host_name": "Zuzanna And Milosz",
    "max_guests": 2,
    "children_allowed": true,
    "infants_allowed": false,
    "pets_allowed": false
  }
}
```

```json
{
  "error": "Invalid dates",
  "detail": "check_out must be after check_in",
  "status_code": 400
}
```