# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/despegar/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/despegar/autocomplete \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/despegar/get-home-offers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/despegar/search-flights \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","children":"<integer>","departure_date":"<string>","destination":"<string>","infants":"<integer>","origin":"<string>","return_date":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.