+Decolar API
Search Decolar flights from Brazil and get fares in BRL, legs, baggage and a fare calendar as clean JSON.
The API.SH Decolar API returns Decolar's (decolar.com) public flight search as structured JSON. Search one-way or round-trip flights by airport or city code with adults, children and infants, and get each itinerary's total price in BRL, price per adult, taxes and charges, installment terms, validating airline and every leg's options with flight numbers, operating airline, aircraft, stops, duration, cabin, seats remaining and baggage allowance. Filter by stops, airlines, baggage, cabin, price range, departure and return times and maximum duration, sort the way the site does, and page through the results. A fare calendar shows the cheapest fares on the days around your dates, and an autocomplete route turns a few letters into the city and airport codes Decolar uses.
- 3 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/decolar/v1/ flights
{"from": "GRU","to": "REC","date": "2027-01-03","return_date": null,"adults": 1,"children": [],"infants": 0,"trip": "one_way","sort": "recommended","filters_applied": {},"page": 1,"total": 43,"pages": 5,"count": 10,"next_page": 2,"origin": {"id": "6574","gid": "AIR_197727","name": "São Paulo","code": "SAO","picture": "//media.staticontent.com/media/pictures?key=c48db549-4770-40db-a244-6071f6a137ef","airportCode": "GRU","airportDescription": "Aeroporto Internacional Guarulhos","countryCode": "BR","countryId": "20028"},"destination": {"id": "6322","gid": "AIR_197497","name": "Recife","code": "REC","picture": "//media.staticontent.com/media/pictures?key=d9dd2f19-d676-4971-a39e-a5fef9b9de10","airportCode": "REC","airportDescription": "Aeroporto Guararapes Intl","countryCode": "BR","countryId": "20028"},"direct_flights": 40,"flights_with_stops": 15,"highlights": {"cheapestItinerary": {"id": "antares_BR-0-site_A-1_C-0_I-0_OW-grurec20270103_flexible-penalty_xselling-cbt_user-067517ef-6c76-41a5-ad17-860ac7c5200f!3_4","price": {"currencyCode": "BRL","amount": 878},"priceTotal": {"currencyCode": "BRL","amount": 943},"duration": "03:05"},"fastestItinerary": {"id": "antares_BR-0-site_A-1_C-0_I-0_OW-grurec20270103_flexible-penalty_xselling-cbt_user-067517ef-6c76-41a5-ad17-860ac7c5200f!7_5_8_6","price": {"currencyCode": "BRL","amount": 1024},"priceTotal": {"currencyCode": "BRL","amount": 1024},"duration": "03:00"},"bestItinerary": {"id": "antares_BR-0-site_A-1_C-0_I-0_OW-grurec20270103_flexible-penalty_xselling-cbt_user-067517ef-6c76-41a5-ad17-860ac7c5200f!2_1","price": {"currencyCode": "BRL","amount": 941},"priceTotal": {"currencyCode": "BRL","amount": 941},"duration": "03:05"},"earliestItinerary": {"id": "antares_BR-0-site_A-1_C-0_I-0_OW-grurec20270103_flexible-penalty_xselling-cbt_user-067517ef-6c76-41a5-ad17-860ac7c5200f!20_21","price": {"currencyCode": "BRL","amount": 1167},"duration": "03:00"},"latestItinerary": {"id": "antares_BR-0-site_A-1_C-0_I-0_OW-grurec20270103_flexible-penalty_xselling-cbt_user-067517ef-6c76-41a5-ad17-860ac7c5200f!53","price": {"currencyCode": "BRL","amount": 4218},"duration": "12:10"},"applySortingTab": true,"applyFastFilters": true,"lowestFare": {"adultPrice": {"currencyCode": "BRL","amount": 941}}},"flights": [{"id": "antares_BR-0-site_A-1_C-0_I-0_OW-grurec20270103_flexible-penalty_xselling-cbt_user-067517ef-6c76-41a5-ad17-860ac7c5200f!2_1","price": 941,"price_per_adult": 819,"currency": "BRL","fare_type": "NEGOTIATED","price_items": [{"type": "ADULTS","label": "1 Adulto","amount": 819},{"type": "TAXES_AND_CHARGES","label": "Impostos, taxas e encargos","amount": 122}],"discount": null,"validating_airline": "JJ","validating_airline_name": "LATAM Airlines Group","airlines": ["L0"],"nonstop": false,"promoted": false,"highlights": {"levelTwo": [],"levelFour": [],"highlightsData": "ondemand","positionHighlightsLevelTwo": {}},"installments": 10,"installments_max": 12,"installments_type": "BEST_INTEREST_FREE","payments": {"max": 12,"best": 10,"paymentsTripsData": {"type": "BEST_INTEREST_FREE","cards": ["MasterCard","Visa"],"banks": ["Itaú Latam"],"installments": 10}},"miles": false,"legs": [{"type": "OUTBOUND","selected_choice": 1,"options": [{"…": "14 fields"},{"…": "14 fields"}]}],"booking_url": "https://www.decolar.com/shop/flights/results/oneway/GRU/REC/2027-01-03/1/0/0"},{"id": "antares_BR-0-site_A-1_C-0_I-0_OW-grurec20270103_flexible-penalty_xselling-cbt_user-067517ef-6c76-41a5-ad17-860ac7c5200f!10_9","price": 1058,"price_per_adult": 926,"currency": "BRL","fare_type": "NEGOTIATED","price_items": [{"type": "ADULTS","label": "1 Adulto","amount": 926},{"type": "TAXES_AND_CHARGES","label": "Impostos, taxas e encargos","amount": 132}],"discount": null,"validating_airline": "JJ","validating_airline_name": "LATAM Airlines Group","airlines": ["L0"],"nonstop": false,"promoted": false,"highlights": {"levelTwo": [],"levelFour": [],"highlightsData": "ondemand","positionHighlightsLevelTwo": {}},"installments": 10,"installments_max": 12,"installments_type": "BEST_INTEREST_FREE","payments": {"max": 12,"best": 10,"paymentsTripsData": {"type": "BEST_INTEREST_FREE","cards": ["MasterCard","Visa"],"banks": ["Itaú Latam"],"installments": 10}},"miles": false,"legs": [{"type": "OUTBOUND","selected_choice": 1,"options": [{"…": "14 fields"},{"…": "14 fields"}]}],"booking_url": "https://www.decolar.com/shop/flights/results/oneway/GRU/REC/2027-01-03/1/0/0"},"… 8 more"],"filters_available": [{"group": "stops","name": "Paradas","param": "stops","type": "DISCRETE","options": [{"value": "NONE","label": "Direto","count": 40,"selected": false},{"value": "ONE","label": "1 Parada","count": 15,"selected": false},"… 1 more"]},{"group": "baggage","name": "Bagagem","param": "baggage","type": "DISCRETE","options": [{"value": "carry_on","label": "Bagagem de mão","count": 58,"selected": false},{"value": "checked","label": "Bagagem para despachar","count": 33,"selected": false}]},"… 5 more"],"sorts": ["recommended","price","… 4 more"],"reference": {"airports": {"REC": "Aeroporto Guararapes Intl","GRU": "Aeroporto Internacional Guarulhos"},"cities": {"SAO": "São Paulo","REC": "Recife"},"airlines": {"JJ": "LATAM Airlines Group","AD": "Azul","L0": "LATAM","LA": "LATAM Airlines Group","G3": "Gol"}},"search_id": "743e7fbd-58b3-4fc4-a0fe-3d8cf58cc1cb","url": "https://www.decolar.com/shop/flights/results/oneway/GRU/REC/2027-01-03/1/0/0","cached": false,"credits_used": 1} What you can build with the Decolar API
Brazil airfare monitoring
Run the same routes every day and store the cheapest fare, the airline and the installment terms to track how Decolar's prices move before a trip or a holiday season.
Flexible-date deal finding
Ask the fare calendar for the days around a date, or a grid of departure and return dates for a round trip, and point travelers to the cheapest combination.
Airline and route comparison
Filter one route by airline (Azul, Gol, LATAM and others), stops and baggage to compare schedules, journey times and what each fare includes.
Travel search and booking tools
Turn what a user types into Decolar's city and airport codes with the autocomplete route, then show live flight options with prices in BRL and a link to the same search on decolar.com.
AI travel assistants
Give an agent flight search, the fare calendar and place lookup so it can answer questions like the cheapest direct flight from São Paulo to Recife next month.
Decolar data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
Decolar API endpoints and prices
Every Decolar endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| Decolar place autocomplete /decolar/ | $1 · $2 PAYG 1 credit |
| Decolar flight search /decolar/ | $1 · $2 PAYG 1 credit |
| Decolar fare calendar /decolar/ | $1 · $2 PAYG 1 credit |
Call the Decolar API
Decolar flight search: GET https://api.api.sh/decolar/
curl "https://api.api.sh/decolar/v1/flights?from=GRU&to=REC&days_ahead=60" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/decolar/v1/flights",
params={"from": "GRU", "to": "REC", "days_ahead": "60"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/decolar/v1/flights");
url.searchParams.set("from", "GRU");
url.searchParams.set("to", "REC");
url.searchParams.set("days_ahead", "60");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/decolar/v1/flights", "from", "GRU", "to", "REC", "days_ahead", "60")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Decolar" and "Decolar flight search".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for Decolar data
- Public data only: no Decolar login, cookies or account needed
- One key and one response shape for Decolar and 917 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official Decolar API
Decolar and its parent group Despegar run partner APIs for affiliates, agencies, hotels and corporate integrations; access goes through a partner agreement and onboarding rather than a public self-service key. API.SH needs no partner approval or login and returns the public flight search, fare calendar and place suggestions in one JSON format.
Skip building your own Decolar scraper or browser extension and maintaining it when the site changes: API.SH gives you one key, documented parameters and a fixed price per call.
Decolar API questions
What Decolar data can I get?+
Flight search results with fares in BRL, taxes, installments, legs, segments and baggage (/decolar/v1/flights), the cheapest fares on the days around your dates (/decolar/v1/calendar-prices) and search box suggestions for cities and airports (/decolar/v1/autocomplete).
How much does the Decolar API cost?+
Every Decolar endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Is there a free trial?+
Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /decolar/v1/autocomplete at 1 credit each.
Is there an official Decolar API?+
Decolar and Despegar offer partner APIs to approved affiliates, agencies and corporate partners. There is no public self-service API key for developers; API.SH returns the public search data with one key and no approval process.
Do I need a Decolar account or login?+
No. API.SH reads Decolar's public search results only. No endpoint uses a login, cookies or anyone's account, and nothing is booked or paid.
Which filters and sorts are supported?+
Stops, airlines, checked or cabin baggage, cabin class, a price range in BRL, departure and return time windows and maximum journey time, sorted by recommended, price, duration, stops, airline or arrival. The response lists the filters the site offers for that search with result counts.
Can I search round trips and families?+
Yes. Add return_date (or trip_days) for a round trip, and set adults, children's ages and infants. Dates can also be given as days_ahead so a saved query never expires.
How do I get started?+
Sign up at api.sh, copy your API key and call /decolar/v1/flights with from, to and a date. The docs at https://api.sh/docs have examples in curl, Python and JavaScript, and you can also use the SDKs, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.
Does the Decolar API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many Decolar calls in parallel as you need and pay only for the calls that run. If Decolar itself slows down, the call returns 503 with a retry-after header and is not charged.