# Despegar Hotel Ad

## Overview

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

## Description

Fetch full hotel details from Despegar by URL and get room types, rates, amenities, reviews, cancellation policies, and photos as structured JSON in real time.

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

## Example Response

### Lookup Alvear Palace Hotel in Buenos Aires

```json
{
  "id": "hotel-bsas-22741",
  "url": "https://www.despegar.com/hoteles/argentina/buenos-aires/alvear-palace-hotel/hotel/22741",
  "name": "Alvear Palace Hotel",
  "rooms": [
    {
      "id": "rm-deluxe-classic",
      "name": "Habitación Deluxe Clásica",
      "capacity": 2,
      "price_per_night": 184200,
      "free_cancellation": false,
      "breakfast_included": true,
      "cancellation_deadline": null
    }
  ],
  "stars": 5,
  "photos": [
    "https://photos.despegar.com/hotels/22741/1.jpg",
    "https://photos.despegar.com/hotels/22741/2.jpg",
    "https://photos.despegar.com/hotels/22741/3.jpg"
  ],
  "rating": 9.3,
  "address": {
    "city": "Buenos Aires",
    "full": "Av. Alvear 1891, Recoleta, Buenos Aires, Argentina",
    "country": "Argentina",
    "neighborhood": "Recoleta"
  },
  "pricing": {
    "taxes": 110520,
    "currency": "ARS",
    "total_price": 921000,
    "price_per_night": 184200,
    "free_cancellation": false,
    "breakfast_included": true
  },
  "category": "Lujo",
  "location": {
    "lat": -34.5874,
    "lng": -58.3932
  },
  "policies": {
    "parking": "De pago",
    "pets_allowed": false,
    "smoking_allowed": false
  },
  "amenities": [
    "Wi-Fi gratis",
    "Restaurante",
    "Spa",
    "Gimnasio",
    "Piscina cubierta",
    "Concierge 24h",
    "Centro de negocios"
  ],
  "thumbnail": "https://photos.despegar.com/hotels/22741/main.jpg",
  "description": "El Alvear Palace Hotel es el hotel de lujo más emblemático de Buenos Aires, ubicado en el corazón del barrio de Recoleta. Desde 1932, ofrece una experiencia de hospedaje inigualable con habitaciones elegantes, gastronomía de excelencia y un spa de clase mundial.",
  "rating_label": "Excelente",
  "check_in_time": "15:00",
  "reviews_count": 1874,
  "check_out_time": "12:00"
}
```

## Documentation

## Overview

Despegar is Latin America's largest OTA, covering 20+ countries. Hotel detail pages are protected by Akamai Bot Manager. Piloterr handles the bypass and returns complete hotel profiles as structured JSON: room types, rates, cancellation policies, amenities, photos, and guest scores.

## Quickstart

```
GET https://api.piloterr.com/v2/despegar/ad?url=https://www.despegar.com/hoteles/argentina/buenos-aires/alvear-palace-hotel/hotel/22741
```

## Main use cases

- Enrich a hotel database with amenity lists, room categories, and cancellation policies after collecting URLs from search results
- Monitor real-time rate changes on specific hotels to power dynamic pricing alerts for travel agencies
- Build a room-type comparison dataset across LATAM destinations to analyze tier pricing strategies
- Extract GPS coordinates and neighborhood data to build proximity maps for business travel applications
- Feed a travel content platform with hotel descriptions, photos, and structured data