# Hotels.com Search

## Overview

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

## Description

Seamlessly extract hotel data from Hotels.com for travel, research, and marketing. Sign up for 50 free requests today!

## 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/hotels/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "hotels": [
    {
      "name": "Hotel de Paris",
      "price": "€150",
      "rating": 4.5,
      "reviews": 1200,
      "location": "Paris, France",
      "amenities": [
        "Free WiFi",
        "Breakfast included",
        "Pool",
        "Air conditioning"
      ]
    },
    {
      "name": "The French Riviera Resort",
      "price": "€200",
      "rating": 4,
      "reviews": 850,
      "location": "Nice, France",
      "amenities": [
        "Beach access",
        "Spa",
        "Gym",
        "Marine activities"
      ]
    },
    {
      "name": "Lyon City Centre Hotel",
      "price": "€130",
      "rating": 4.2,
      "reviews": 543,
      "location": "Lyon, France",
      "amenities": [
        "Restaurant",
        "Bar",
        "Free parking",
        "Pet-friendly"
      ]
    },
    {
      "name": "Marseille Boutique Hotel",
      "price": "€175",
      "rating": 4.8,
      "reviews": 930,
      "location": "Marseille, France",
      "amenities": [
        "Rooftop bar",
        "Free breakfast",
        "Concierge service",
        "Airport shuttle"
      ]
    }
  ]
}
```

## Documentation

## Overview
Seamlessly extract hotel data from Hotels.com for travel, research, and marketing. Sign up for 50 free requests today!

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

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

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