# Hotels.com Listing

## Overview

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

## Description

Extract hotel data from Hotels.com for market analysis, travel apps, and improved booking accuracy with Piloterr.

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

## Example Response

### Example

```json
{
  "hotels": [
    {
      "name": "The Resident Covent Garden",
      "rating": "4.9",
      "address": "51 Bedford St, London, England, WC2R 0 PZ",
      "imageURL": "https://example.com/image1.jpg",
      "amenities": [
        "Free WiFi",
        "Air conditioning",
        "24-hour front desk"
      ],
      "reviewsCount": 1234,
      "pricePerNight": "$250"
    },
    {
      "name": "Park Plaza Westminster Bridge London",
      "rating": "4.5",
      "address": "200 Westminster Bridge Road, London, England, SE1 7UT",
      "imageURL": "https://example.com/image2.jpg",
      "amenities": [
        "Pool",
        "Spa",
        "24-hour front desk",
        "Bar"
      ],
      "reviewsCount": 8590,
      "pricePerNight": "$300"
    },
    {
      "name": "Hilton London Bankside",
      "rating": "4.8",
      "address": "2-8 Great Suffolk St, London, England, SE1 0UG",
      "imageURL": "https://example.com/image3.jpg",
      "amenities": [
        "Free WiFi",
        "Indoor pool",
        "Fitness center",
        "Restaurant"
      ],
      "reviewsCount": 2500,
      "pricePerNight": "$275"
    },
    {
      "name": "The Savoy",
      "rating": "4.9",
      "address": "Strand, London, England, WC2R 0EZ",
      "imageURL": "https://example.com/image4.jpg",
      "amenities": [
        "Free WiFi",
        "Spa",
        "Fitness center",
        "Bar"
      ],
      "reviewsCount": 1940,
      "pricePerNight": "$450"
    },
    {
      "name": "Hampton by Hilton London Waterloo",
      "rating": "4.6",
      "address": "157 Waterloo Rd, London, England, SE1 8XA",
      "imageURL": "https://example.com/image5.jpg",
      "amenities": [
        "Free breakfast",
        "Fitness center",
        "Bar"
      ],
      "reviewsCount": 3800,
      "pricePerNight": "$200"
    }
  ]
}
```

## Documentation

## Overview
Extract hotel data from Hotels.com for market analysis, travel apps, and improved booking accuracy with Piloterr.

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

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

## Main use cases
- Integrate Hotels.com Listing 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