GET
# Airbnb Listing Pricing API

Get real-time pricing with nightly rates, service fees, and total costs for any Airbnb listing.

## Overview

#### Dynamic Pricing

Prices are calculated in real-time based on your check-in/check-out dates and guest count.

The Airbnb Pricing endpoint returns a detailed breakdown of all costs including nightly rate, accommodation total, service fees, and the final total. Perfect for price comparison and booking cost estimation.

### Endpoint URL

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

## 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) |
| currency | string | Optional | Currency code (default: USD). E.g., EUR, GBP, JPY |

## Response Structure

### Pricing Information

- `nights` - Number of nights
- `currency` - Currency code
- `nightly_rate` - Average price per night
- `accommodation_total` - Total accommodation cost
- `service_fee` - Airbnb service fee
- `total` - Total amount to pay
- `total_formatted` - Formatted total with currency symbol

### Price Breakdown

- `breakdown` - Array of line items with descriptions and amounts
- Each item includes type, description, and amount

Request

```curl
curl -X GET "https://api.stayapi.com/v1/airbnb/listing/22135033/pricing?check_in=2026-01-30&check_out=2026-02-01&currency=EUR" \
  -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,
  "pricing": {
    "nights": 2,
    "currency": "EUR",
    "nightly_rate": 44.49,
    "accommodation_total": 76.00,
    "service_fee": 12.98,
    "total": 88.98,
    "total_formatted": "EUR88.98",
    "breakdown": [
      {
        "type": "ACCOMMODATION",
        "description": "EUR44.49 x 2 nights",
        "amount": 76.00
      },
      {
        "type": "SERVICE_FEE",
        "description": "Service fee",
        "amount": 12.98
      }
    ]
  }
}
```

```json
{
  "error": "Listing unavailable",
  "detail": "This listing is not available for the selected dates",
  "status_code": 400
}
```
