# Decolar Flight Search

## Overview

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

## Description

Search Decolar flights by route and date and get fares, airlines, schedules, stops, and seat 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/flight' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Round-trip GRU to SCL

```json
{
  "search_info": {
    "origin": "GRU",
    "destination": "SCL",
    "return_date": "2026-08-22",
    "total_results": 14,
    "departure_date": "2026-08-15"
  },
  "return_flights": [
    {
      "id": "decolar-fl-scl-gru-20260822-001",
      "price": 1180,
      "stops": 0,
      "taxes": 295,
      "currency": "BRL",
      "segments": [
        {
          "airline": "LATAM Airlines",
          "aircraft": "Boeing 767-300ER",
          "airline_code": "LA",
          "arrival_time": "2026-08-22T18:15:00",
          "flight_number": "LA 8093",
          "departure_time": "2026-08-22T13:45:00",
          "arrival_airport": "GRU",
          "duration_minutes": 210,
          "departure_airport": "SCL"
        }
      ],
      "booking_url": "https://www.decolar.com/passagens-aereas/SCL/GRU/2026-08-22/null/1/0/0/economy?itinerary=decolar-fl-scl-gru-20260822-001",
      "cabin_class": "economy",
      "total_price": 1475,
      "seats_available": 9,
      "baggage_included": false,
      "duration_minutes": 210,
      "carry_on_included": true
    }
  ],
  "outbound_flights": [
    {
      "id": "decolar-fl-gru-scl-20260815-001",
      "price": 1240,
      "stops": 0,
      "taxes": 310.5,
      "currency": "BRL",
      "segments": [
        {
          "airline": "LATAM Airlines",
          "aircraft": "Boeing 767-300ER",
          "airline_code": "LA",
          "arrival_time": "2026-08-15T10:50:00",
          "flight_number": "LA 8092",
          "departure_time": "2026-08-15T07:30:00",
          "arrival_airport": "SCL",
          "duration_minutes": 200,
          "departure_airport": "GRU"
        }
      ],
      "booking_url": "https://www.decolar.com/passagens-aereas/GRU/SCL/2026-08-15/2026-08-22/1/0/0/economy?itinerary=decolar-fl-gru-scl-20260815-001",
      "cabin_class": "economy",
      "total_price": 1550.5,
      "seats_available": 6,
      "baggage_included": false,
      "duration_minutes": 200,
      "carry_on_included": true
    }
  ]
}
```

## Documentation

## Overview

Decolar aggregates Latin America's largest flight inventory from LATAM, Gol, Azul, Aerolíneas Argentinas, Avianca, and dozens of carriers. The platform uses JavaScript-based bot protection. Piloterr routes each request through infrastructure that handles the bypass, returning outbound and return flight options as structured JSON.

Each result covers airline, flight number, times, aircraft, duration, stops, fare, taxes, and baggage status at the segment level.

## Quickstart

```
GET https://api.piloterr.com/v2/decolar/flight?origin=GRU&destination=SCL&departure_date=2026-08-15
```

## Main use cases

- Pull real-time Decolar airfares for a given route to power a Latin America flight price comparison tool
- Track fare changes over time between specific city pairs to identify the cheapest booking windows
- Monitor seat counts on popular routes to build urgency signals for travel booking platforms
- Build a business travel cost engine by collecting economy and business fares on corporate route sets
- Aggregate multi-airline fare data to train route-level pricing prediction models