# Airbnb Search

## Overview

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

## Description

Effortlessly extract Airbnb data for enhanced travel, market analysis, and real estate insights. 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/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "type": "search_results",
  "results": [
    {
      "id": "12345678",
      "host": {
        "name": "John",
        "profile_picture": "john_profile.jpg"
      },
      "price": "$120/night",
      "title": "Charming Apartment in Paris",
      "images": [
        "image1.jpg",
        "image2.jpg"
      ],
      "rating": 4.8,
      "num_reviews": 54
    },
    {
      "id": "87654321",
      "host": {
        "name": "Emma",
        "profile_picture": "emma_profile.jpg"
      },
      "price": "$150/night",
      "title": "Cozy Studio Near Eiffel Tower",
      "images": [
        "image1.jpg",
        "image2.jpg"
      ],
      "rating": 4.9,
      "num_reviews": 34
    },
    {
      "id": "13579246",
      "host": {
        "name": "Paul",
        "profile_picture": "paul_profile.jpg"
      },
      "price": "$200/night",
      "title": "Modern Flat with Balcony",
      "images": [
        "image1.jpg",
        "image2.jpg"
      ],
      "rating": 4.7,
      "num_reviews": 76
    }
  ],
  "check_in": "2023-11-15",
  "location": "Paris, France",
  "check_out": "2023-11-20",
  "pagination": {
    "total_pages": 10,
    "current_page": 1
  },
  "guest_count": 2
}
```

## Documentation

## Overview
Effortlessly extract Airbnb data for enhanced travel, market analysis, and real estate insights. Free trial available!

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

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

## Main use cases
- Integrate Airbnb Search 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