Decolar+API.SH

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
Decolar flight search
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}
1 credit · $1 per 1,000 calls

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 place autocomplete/decolar/v1/autocomplete
qriotypeflightscount9
results[]id · type · group · code · name · place_id · gid · latitude · longitude · parents
Decolar fare calendar/decolar/v1/calendar-prices
fromSAOtoRIOdate2027-01-03adults1infants0tripone_waycount7searched_price573min_price348price_spread225currencyBRLnoteAs previsões se baseiam em um hi…
cheapest[]date · return_date · price · currency · searched · status
prices[]date · return_date · price · currency · searched · status
Decolar flight search/decolar/v1/flights
fromGRUtoRECdate2027-01-03adults1infants0tripone_waysortrecommendedpage1total43pages5count10next_page2direct_flights40flights_with_stops15search_id743e7fbd-58b3-4fc4-a0fe-3d8cf58c…urlhttps://www.decolar.com/shop/fli…
origin[]id · gid · name · code · picture · airportCode · airportDescription · countryCode · countryId
destination[]id · gid · name · code · picture · airportCode · airportDescription · countryCode · countryId
highlights[]cheapestItinerary · fastestItinerary · bestItinerary · earliestItinerary · latestItinerary · applySortingTab · applyFastFilters · lowestFare
flights[]id · price · price_per_adult · currency · fare_type · price_items · discount · validating_airline · validating_airline_name · airlines · nonstop · promoted

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

Search and discovery2
Decolar place autocomplete
/decolar/v1/autocomplete
params q +1 optionaldocstry
$1 · $2 PAYG
1 credit
Decolar flight search
/decolar/v1/flights
params from, to +18 optionaldocstry
$1 · $2 PAYG
1 credit
Products, listings and places1
Decolar fare calendar
/decolar/v1/calendar-prices
params from, to +7 optionaldocstry
$1 · $2 PAYG
1 credit

Call the Decolar API

Decolar flight search: GET https://api.api.sh/decolar/v1/flights

curl "https://api.api.sh/decolar/v1/flights?from=GRU&to=REC&days_ahead=60" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 918 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for 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.

More travel & events APIs all travel & events APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 918 platforms.
Get a free API key