Avianca APIavianca.com ↗
Access all current Avianca promotional flight offers via a single API call. Returns origin/destination codes, prices, trip types, discounts, and miles eligibility.
What is the Avianca API?
The Avianca API exposes all active flight promotions from avianca.com through a single endpoint, get_all_actions, returning up to the complete current set of promotional offers in one response. Each offer object includes IATA origin and destination codes, pricing in available currencies, trip type, category, discount details, and miles eligibility — giving you the full picture of Avianca's current deals without multiple requests.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/08ccfd38-1889-4569-a1a3-421df82b4dcc/get_all_actions' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace avianca-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Avianca promotional actions — browse current flight deals."""
from parse_apis.avianca_com_api import Avianca, ParseError
client = Avianca()
# List promotional flight offers, capping total items fetched.
for action in client.actions.list(limit=10):
price = action.prices.get("ars", "N/A")
print(f"{action.origin} -> {action.destination}: ARS {price} ({action.trip_type_text})")
# Grab one action to inspect its full details.
try:
featured = client.actions.list(limit=50).first()
except ParseError as e:
print(f"Could not fetch actions: {e}")
featured = None
if featured is not None:
print(f"\nFeatured route: {featured.origin} -> {featured.destination}")
print(f" POS: {featured.pos_code}, Category: {featured.category_code}")
print(f" Earns miles: {'yes' if featured.earn_miles else 'no'}")
print("\nexercised: actions.list")
Returns all current promotional flight offers (actions) from Avianca across all points of sale. Each action includes origin/destination IATA codes, prices in available currencies, trip type, category, discount info, and miles eligibility. Returns the complete set in a single call (typically 200-300 offers). No pagination needed.
No input parameters required.
{
"type": "object",
"fields": {
"total": "total count of offers returned",
"actions": "array of promotional flight offer objects"
},
"sample": {
"data": {
"total": 245,
"actions": [
{
"origin": "AEP",
"prices": {
"ars": "658017"
},
"discount": "",
"pos_code": "AR",
"earn_miles": "1",
"promo_text": "",
"destination": "JFK",
"publish_date": "",
"category_code": "COD01",
"featured_offer": "",
"trip_type_text": "One way from",
"unpublish_date": "",
"secondary_currency": ""
}
]
},
"status": "success"
}
}About the Avianca API
What the API Returns
The get_all_actions endpoint returns every active promotional flight offer (called "actions") across all Avianca points of sale. The response includes a total field with the count of offers and an actions array containing the full detail of each offer. Response fields per action include IATA origin and destination codes, prices expressed in the currencies available for that market, trip type (e.g. round-trip or one-way), a category label, discount information, and a flag indicating miles eligibility.
Endpoint Details
get_all_actions takes no input parameters — it returns the complete set of current promotions in a single call. This means there is no pagination to manage and no filter arguments to construct. The total field in the response lets you quickly verify how many offers were returned before iterating over the actions array.
Coverage and Data Freshness
The data reflects promotions currently active on avianca.com across all points of sale, so the offers you receive are the same ones Avianca surfaces to travelers. Because promotions change frequently — especially around fare sales — the content of actions can shift between calls. Building a caching or polling layer in your application is advisable if you need to track changes over time.
The Avianca API is a managed, monitored endpoint for avianca.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when avianca.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official avianca.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor Avianca fare sales and alert users when discounted routes matching their origin/destination IATA codes appear
- Aggregate Avianca promotional prices by currency to display regional deal comparisons
- Filter active promotions by trip type (round-trip vs. one-way) to surface relevant offers in a travel booking interface
- Identify routes with miles-eligible promotions for loyalty program tracking tools
- Track discount depth across active Avianca promotions to analyze pricing patterns over time
- Populate a deals feed or newsletter with current Avianca promotional fares using category and route data
- Cross-reference Avianca promotional destinations with hotel or car rental inventory using IATA codes from the response
| 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 | 100 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.
Does Avianca have an official public developer API?+
What does the `actions` array actually contain per offer?+
actions array includes IATA codes for the origin and destination airports, the price in one or more available currencies, the trip type (such as round-trip or one-way), a category label, discount details, and a boolean or flag indicating whether the fare is eligible for miles accrual.Can I filter promotions by route, currency, or date range?+
get_all_actions accepts no input parameters, so filtering is not done server-side. You receive the full set of active promotions and apply any route, currency, or date filtering on the client side using the fields present in each action object.Does the API return flight schedules, seat availability, or booking details?+
How current are the promotions returned by `get_all_actions`?+
last_updated timestamp in the response, so polling on a schedule is the recommended approach for detecting changes.