# Despegar — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and book flights on Despegar.com.ar by exploring real-time flight offers, autocompleting destinations, and comparing travel options across multiple routes. Get instant access to current promotions and home page deals to find the best prices for your next trip.

**Category:** Travel | **Website:** [despegar.com.ar/](https://despegar.com.ar/) | **Docs:** [parse.bot/marketplace/e11a52e5-0bd4-43de-8f15-e25cc38a25c2/despegar-com-ar-api](https://parse.bot/marketplace/e11a52e5-0bd4-43de-8f15-e25cc38a25c2/despegar-com-ar-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-despegar-com-ar-api-e11a52e5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### autocomplete

Returns autocomplete suggestions for airports and cities based on a search query. Each suggestion includes the IATA code, geographic coordinates, parent geography (continent, country, city), and a display name in Spanish with HTML highlights on the matched portion. Use to resolve free-text city/airport input into an IATA code suitable for search_flights.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search text for airports or cities (e.g. 'miami', 'buenos'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-despegar-com-ar-api-e11a52e5/autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_home_offers

Retrieves current travel offers (flights, packages, hotels) from the Despegar offers page. Returns a list of offers with pricing in ARS and USD, destination info, offer type, and relative booking links. No input parameters; the result reflects whatever the site is currently promoting.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-despegar-com-ar-api-e11a52e5/get_home_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_flights

Search for flight offers between two cities on Despegar.com.ar. Returns available flight options with pricing in USD, airline information, full itineraries with segments (departure/arrival times, carrier codes, cabin type, stops), and relative booking links. Results are flight suggestions around the departure date — the site returns nearby-date alternatives, not only exact-date matches. One-way search is performed when return_date is omitted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adults` | integer | No | Number of adult passengers. |
| `children` | integer | No | Number of child passengers. |
| `departure_date` | string | Yes | Departure date in YYYY-MM-DD format. |
| `destination` | string | Yes | Destination city or airport IATA code (e.g. 'MIA', 'MAD', 'SCL'). |
| `infants` | integer | No | Number of infant passengers. |
| `origin` | string | Yes | Origin city or airport IATA code (e.g. 'BUE', 'AEP', 'EZE'). |
| `return_date` | string | No | Return date in YYYY-MM-DD format. Omitting searches one-way flights. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-despegar-com-ar-api-e11a52e5/search_flights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","children":"<integer>","departure_date":"<string>","destination":"<string>","infants":"<integer>","origin":"<string>","return_date":"<string>"}'
```