GET
# Airbnb Details from URL API

Extract property details from any Airbnb URL. Simply paste the listing URL to get all details.

## Overview

#### Easy URL Input

Just copy and paste any Airbnb listing URL - we'll extract the ID and fetch the details for you.

This endpoint accepts any Airbnb listing URL and extracts the property details. Supports standard URLs, URLs with parameters, and international domains.

### Endpoint URL

GET https://api.stayapi.com/v1/airbnb/listing/details-from-url 

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| url | string | Required | Full Airbnb listing URL |
| 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) |
| currency | string | Optional | Currency code (default: USD) |

## Supported URL Formats

- `https://www.airbnb.com/rooms/22135033`
- `https://www.airbnb.com/rooms/22135033?check_in=2026-01-30`
- `https://airbnb.co.uk/rooms/22135033`
- `https://m.airbnb.com/rooms/22135033`

## Response Structure

### Listing Information

- `title` - Property title
- `image_url` - Main listing image
- `rating` - Average rating
- `host_name` - Host display name
- `badge` - Award badge

Request

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

Response

```json
{
  "success": true,
  "listing_id": "22135033",
  "source_url": "https://www.airbnb.com/rooms/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 URL",
  "detail": "Could not extract listing ID from URL",
  "status_code": 400
}
```