# Airbnb Listing Detail API Documentation

Retrieve a public Airbnb listing by its numeric id: title, name, property type, room type, guest capacity, overview, rating, review count, category ratings, Superhost and Guest favorite flags (the host name and id are never returned), approximate location with coordinates, amenities, images with captions and the plain-text description. The page carries no dated price breakdown: read prices from the search endpoint. An unknown listing id returns a not-billable 404.

- **Documentation:** [https://scrappa.co/docs/airbnb-api/airbnb_listing](https://scrappa.co/docs/airbnb-api/airbnb_listing)
- **API group:** Airbnb API
- **Endpoint:** `GET https://scrappa.co/api/airbnb/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `listing_id` | string | Yes | Numeric Airbnb listing id from the room URL. Example: 18648717. |
| `checkin` | string | No | Check-in date, YYYY-MM-DD. Send together with checkout. |
| `checkout` | string | No | Check-out date, YYYY-MM-DD, after check-in. |
| `adults` | integer | No | Number of adults, 1 to 16. Defaults to 1. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/airbnb/listing?listing_id=18648717&checkin=2026-11-10&checkout=2026-11-14&adults=2"
```

## Example response

```json
{
    "success": true,
    "data": {
        "id": "18648717",
        "url": "https://www.airbnb.com/rooms/18648717",
        "title": "Entire rental unit in Paris, France",
        "name": "Your home away from home in the Marais!",
        "property_type": "apartment",
        "room_type": "entire_home",
        "person_capacity": 2,
        "overview": [
            "2 guests",
            "1 bedroom",
            "1 bed",
            "1 bath"
        ],
        "rating": 4.78,
        "review_count": 236,
        "category_ratings": [
            {
                "category": "accuracy",
                "rating": 4.81
            },
            {
                "category": "cleanliness",
                "rating": 4.81
            },
            {
                "category": "checkin",
                "rating": 4.84
            },
            {
                "category": "location",
                "rating": 4.97
            },
            {
                "category": "communication",
                "rating": 4.91
            },
            {
                "category": "value",
                "rating": 4.78
            }
        ],
        "is_superhost": true,
        "is_guest_favorite": true,
        "location": {
            "subtitle": "Paris, \u00cele-de-France, France",
            "latitude": 48.8588,
            "longitude": 2.3591
        },
        "amenities": [
            {
                "name": "Bathtub",
                "category": "Bathroom"
            },
            {
                "name": "Hair dryer",
                "category": "Bathroom"
            },
            {
                "name": "Cleaning products",
                "category": "Bathroom"
            },
            {
                "name": "Shampoo",
                "category": "Bathroom"
            }
        ],
        "images": [
            {
                "url": "https://a0.muscache.com/im/pictures/8b051a56-4df3-4388-9a2b-a357637c0c29.jpg",
                "caption": "Equipped kitchen"
            },
            {
                "url": "https://a0.muscache.com/im/pictures/9027c023-15fb-42a8-a5cc-5ca5df6407b7.jpg",
                "caption": "Room and kitchen view from the entrance / view of the bedroom and the kitchen from the entrance"
            }
        ],
        "description": "Experience the Parisian lifestyle! Bright and calm, this lovely and comfy studio apartment is located in the heart of the historic neighborhood of Le Marais. Yo\u2026"
    },
    "meta": {
        "endpoint_family": "listing_detail",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The requested Airbnb listing was not found. This response is not billable. |
| 503 | Service Unavailable | Airbnb could not be reached, blocked the request or returned an unexpected response. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)