# Tophotels Search

## Overview

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

## Description

Access detailed Dublin hotel data including names, addresses, ratings, reviews, prices, and amenities with Tophotels Search API.

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

## Example Response

### Example

```json
{
  "id": "12345",
  "hotels": [
    {
      "name": "The Merrion Hotel",
      "rating": "4.8",
      "address": "Upper Merrion Street, Dublin",
      "reviews": 1200,
      "amenities": [
        "Free WiFi",
        "Pool",
        "Spa",
        "Gym"
      ],
      "price_per_night": "€320"
    },
    {
      "name": "The Westbury",
      "rating": "4.7",
      "address": "Balfe Street, Dublin",
      "reviews": 950,
      "amenities": [
        "Free WiFi",
        "Restaurant",
        "Bar"
      ],
      "price_per_night": "€280"
    },
    {
      "name": "The Marker Hotel",
      "rating": "4.6",
      "address": "Grand Canal Square, Docklands, Dublin",
      "reviews": 1100,
      "amenities": [
        "Free WiFi",
        "Pool",
        "Gym",
        "Rooftop Bar"
      ],
      "price_per_night": "€290"
    },
    {
      "name": "Radisson Blu Royal Hotel",
      "rating": "4.5",
      "address": "Golden Lane, Dublin",
      "reviews": 800,
      "amenities": [
        "Free WiFi",
        "Restaurant",
        "Bar",
        "Gym"
      ],
      "price_per_night": "€240"
    },
    {
      "name": "The Shelbourne Dublin",
      "rating": "4.9",
      "address": "St. Stephen's Green, Dublin",
      "reviews": 1300,
      "amenities": [
        "Free WiFi",
        "Spa",
        "Pool",
        "Gym"
      ],
      "price_per_night": "€350"
    }
  ],
  "location": "Dublin, Ireland"
}
```

## Documentation

## Overview
Access detailed Dublin hotel data including names, addresses, ratings, reviews, prices, and amenities with Tophotels Search API.

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

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

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