# Decolar Hotel Search

## Overview

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

## Description

Search Decolar hotel listings by destination and dates and get prices, ratings, amenities, and availability 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/decolar/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search hotels in Buenos Aires

```json
[
  {
    "id": "hotel-buenos-aires-19482",
    "url": "https://www.decolar.com/hoteis/argentina/buenos-aires/alvear-palace-hotel/hotel/19482?adults=2&rooms=1&checkin=2026-07-10&checkout=2026-07-15",
    "name": "Alvear Palace Hotel",
    "stars": 5,
    "taxes": 534,
    "rating": 9.4,
    "address": {
      "city": "Buenos Aires",
      "full": "Av. Alvear 1891, Recoleta, Buenos Aires, Argentina",
      "country": "Argentina",
      "neighborhood": "Recoleta"
    },
    "currency": "BRL",
    "location": {
      "lat": -34.5874,
      "lng": -58.3932,
      "distance_to_center": "2.1 km do centro"
    },
    "amenities": [
      "Wi-Fi grátis",
      "Restaurante",
      "Spa",
      "Academia",
      "Piscina coberta",
      "Concierge 24h"
    ],
    "thumbnail": "https://photos.decolar.com/hotels/19482/main.jpg",
    "total_price": 4450,
    "rating_label": "Excelente",
    "reviews_count": 2187,
    "price_per_night": 890,
    "free_cancellation": false,
    "breakfast_included": true
  }
]
```

## Documentation

## Overview

Decolar is Latin America's leading online travel agency, part of the Despegar group. The platform applies JavaScript-based bot protection that blocks direct automated access. Piloterr bypasses those challenges and returns hotel search results as structured JSON from a single GET request.

Each result includes hotel name, star rating, guest score, price per night, total stay cost, amenities, address, and GPS coordinates.

## Quickstart

```
GET https://api.piloterr.com/v2/decolar/search?destination=Buenos+Aires&check_in=2026-07-10&check_out=2026-07-15
```

## Main use cases

- Track hotel price fluctuations across Latin American destinations to build dynamic rate comparison tools
- Monitor rate parity between Decolar and competitor OTAs for properties in a hotel portfolio
- Collect nightly rates over time to identify seasonal pricing patterns in specific destinations
- Build travel budget estimators that aggregate live Decolar hotel prices for itinerary planning apps
- Alert teams when hotel rates in key markets drop below configured thresholds