# Airbnb Listing

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/airbnb/listing` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/airbnb-listing |

## Description

Uncover unique insights on Airbnb listings with Piloterr's API. Enhance strategies, unlock automation, and ensure legal compliance. Free trial available!

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/airbnb/listing' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "price": "€150",
  "rating": 4.8,
  "reviews": [
    {
      "date": "May 2024",
      "user": "John Doe",
      "rating": 5,
      "content": "The place is great and located conveniently. Highly recommend!"
    },
    {
      "date": "April 2024",
      "user": "Jane Doe",
      "rating": 4.8,
      "content": "Loved this loft. Host was responsive and helpful."
    }
  ],
  "amenities": [
    "Wi-Fi",
    "Kitchen",
    "Washing machine",
    "Iron",
    "Heating"
  ],
  "host_name": "Julien",
  "description": "Experience Paris in the heart of the city. This loft is located centrally and ensures you have everything you need to enjoy your stay.",
  "listing_url": "https://www.airbnb.fr/rooms/50619122",
  "listing_name": "Cozy Loft in Central Paris",
  "booking_range": "May 25, 2024 - June 01, 2024",
  "number_of_beds": 1,
  "number_of_guests": 2,
  "host_response_rate": "100%",
  "host_response_time": "within an hour",
  "number_of_bedrooms": 1,
  "number_of_bathrooms": 1
}
```

## Documentation

## Overview
Uncover unique insights on Airbnb listings with Piloterr's API. Enhance strategies, unlock automation, and ensure legal compliance. Free trial available!

## Quickstart
```
GET https://api.piloterr.com/v2/airbnb/listing?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Airbnb Listing data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Airbnb without maintaining scrapers
- Power internal dashboards and workflow automations with live Airbnb data