despegar.com.ar APIdespegar.com.ar ↗
Access Despegar.com.ar flight search, destination autocomplete, and home travel offers via API. Returns pricing in ARS/USD, IATA codes, airline data, and itineraries.
curl -X GET 'https://api.parse.bot/scraper/d3bd51e8-9d60-468e-ba59-fa852e640ab4/autocomplete?q=buenos&query=miami' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns autocomplete suggestions for airports and cities based on a search query. Results include IATA codes, geographic coordinates, and display names in Spanish.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search text for airports or cities (e.g. 'miami', 'buenos'). |
{
"type": "object",
"fields": {
"items": "array of airport/city suggestion objects with id, target (iata, type, parents), display name, highlight, and location coordinates"
},
"sample": {
"data": {
"items": [
{
"id": "AIR_195982",
"target": {
"id": "195982",
"gid": "AIR_195982",
"iata": "MIA",
"type": "AIRPORT",
"parents": {
"city": "CIT_4544",
"country": "COU_20208",
"continent": "CON_30004",
"administrative_division": "ADM_10664"
}
},
"display": "Aeropuerto Internacional Miami, Miami, Estados Unidos",
"location": {
"latitude": 25.79538913037947,
"longitude": -80.2874298779297
},
"highlight": "Aeropuerto Internacional <em>Miami</em>, <em>Miami</em>, Estados Unidos"
}
]
},
"status": "success"
}
}About the despegar.com.ar API
The Despegar.com.ar API exposes 3 endpoints covering destination autocomplete, homepage travel offers, and flight search for the Argentine market. The search_flights endpoint returns full itineraries with airline details, per-segment routing, and prices denominated in both ARS and USD. Results include IATA codes, booking links, and passenger breakdowns for adults, children, and infants.
Endpoints Overview
The API covers three distinct functions. autocomplete accepts a free-text query parameter (e.g. 'miami' or 'buenos') and returns an array of airport and city suggestion objects, each carrying an IATA code, geographic coordinates, a Spanish-language display name, and structured parent location data. This is the correct entry point for resolving user input to an IATA code before calling search_flights.
Flight Search
search_flights requires origin, destination, and departure_date (YYYY-MM-DD). Optionally supply return_date for round trips, and adults, children, or infants for passenger counts. The response includes a flights array where each object carries price, airlines, itineraries (with individual segments), origin, destination, link, and drivers. Note that results represent flight suggestions around the departure date rather than an exact-date fare list — dates close to the requested date are included.
Home Offers
get_home_offers takes no parameters and returns the current promotional listings from the Despegar.com.ar offers surface. Each offer object includes offer_type (flight, package, hotel), main_text, auxiliary_text, a dual-currency price field in ARS and USD, a link for booking, a picture URL, and a section label. The total field tells you how many offers are in the current response.
Coverage Notes
All content is oriented toward the Argentine market: display names are in Spanish, prices default to ARS, and IATA suggestions reflect Despegar's regional catalogue. The search_flights endpoint surfaces round-trip results when return_date is supplied and one-way results when it is omitted.
- Build a flight price tracker for routes departing from Buenos Aires (AEP, EZE) to major South American hubs
- Populate a destination search input with Spanish-language airport and city suggestions using the autocomplete endpoint
- Aggregate current ARS/USD promotional fares from Despegar's home offers for a travel deals newsletter
- Compare round-trip vs one-way pricing by calling search_flights with and without return_date
- Resolve city or airport names to IATA codes before submitting structured flight search queries
- Display airline names and layover segments for a given origin-destination pair in a travel planning tool
- Monitor offer_type distribution (flights vs packages vs hotels) across Despegar's active promotions
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.