# Tophotels Hotel

## Overview

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

## Description

Harness the power of Tophotels data for detailed insights, competitive analysis, and personalized marketing with our 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/hotel' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "rating": 8.4,
  "address": "10-14 Findlater Place, off O'Connell Street, Dublin, Ireland",
  "reviews": 1254,
  "policies": {
    "checkIn": "from 3:00 PM",
    "checkOut": "until 12:00 PM",
    "cancellation": "Cancellation and prepayment policies vary according to accommodation type."
  },
  "amenities": [
    "Free WiFi",
    "Fitness Center",
    "Bar",
    "24-hour front desk",
    "Non-smoking rooms",
    "Facilities for disabled guests"
  ],
  "hotelName": "Academy Plaza Hotel Dublin",
  "roomTypes": [
    {
      "type": "Single Room",
      "capacity": "1 person",
      "pricePerNight": "$100"
    },
    {
      "type": "Double Room",
      "capacity": "2 persons",
      "pricePerNight": "$150"
    },
    {
      "type": "Family Room",
      "capacity": "4 persons",
      "pricePerNight": "$200"
    }
  ],
  "contactInfo": {
    "email": "info@academyplazahotel.ie",
    "phone": "+353 1 8714444"
  },
  "description": "Academy Plaza Hotel is located in the heart of Dublin, offering a variety of modern amenities and services.",
  "nearbyAttractions": [
    "Trinity College",
    "Temple Bar",
    "Dublin Castle"
  ]
}
```

## Documentation

## Overview
Harness the power of Tophotels data for detailed insights, competitive analysis, and personalized marketing with our API.

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

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

## Main use cases
- Integrate Tophotels Hotel 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