# 123milhas Search

## Overview

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

## Description

Search 123milhas travel packages and hotel deals by destination and dates and get prices, availability, and inclusions 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/123milhas/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search packages to Cancún

```json
{
  "page": 1,
  "results": [
    {
      "id": "pkg-123m-gru-cun-20260701-001",
      "url": "https://www.123milhas.com/pacotes/cancun/gru-cun-2026-07-01?pkg=pkg-123m-gru-cun-20260701-001",
      "type": "package",
      "title": "Cancún 7 noites - Hotel Gran Caribe + Voo",
      "nights": 7,
      "origin": "São Paulo",
      "hotel_name": "Gran Caribe Real Resort & Spa",
      "destination": "Cancún",
      "hotel_stars": 5,
      "price_total": 9780,
      "return_date": "2026-07-08",
      "hotel_rating": 8.9,
      "installments": {
        "amount": 489,
        "quantity": 10
      },
      "departure_date": "2026-07-01",
      "flight_included": true,
      "hotel_thumbnail": "https://images.123milhas.com/hotels/gran-caribe-real-cancun-main.jpg",
      "price_per_person": 4890,
      "breakfast_included": true
    }
  ],
  "total_results": 347,
  "results_per_page": 20
}
```

## Documentation

## Overview

123milhas is one of Brazil's most popular discount travel platforms, known for flight and hotel packages at below-market prices, including miles-based bookings. The platform applies Cloudflare protection. Piloterr handles the bypass and returns paginated package results as structured JSON.

Each result includes hotel name and rating, destination, departure date, price per person in BRL, instalment options, and a direct booking URL.

## Quickstart

```
GET https://api.piloterr.com/v2/123milhas/search?destination=Cancún&check_in=2026-07-01&check_out=2026-07-08
```

## Main use cases

- Track real-time package prices on 123milhas to build a travel deal aggregator for Brazilian destinations
- Monitor price drops for flight+hotel combos to send automated alerts to deal newsletter subscribers
- Collect hotel pricing data across departure cities to map travel costs from Brazilian markets
- Feed a budget travel recommendation engine with live 123milhas data sorted by lowest price
- Compare 123milhas prices against other OTAs to quantify the discount advantage