Airline Mileage Chart Redemption Rate Scraper

Most frequent-flyer programs publish a fixed mileage chart showing how many miles (plus taxes) a redemption costs between two regions — separate from the live seat-availability search. This actor reads those published charts directly from each program's own page and returns one row per chart rate, so you can compare redemption cost across programs without opening a dozen airline websites.

What this actor does

• Looks up published award-chart rates between an origin and destination region for the loyalty programs you select.
• Filters results by cabin class, one-way vs. roundtrip, and partner-only redemptions.
• Returns the miles cost, tax estimate, and any chart notes (e.g. distance band) exactly as published by the program.
• Cleanly skips any selected program whose chart isn't implemented yet, without emitting placeholder rows for it.
• Fields a given program's chart doesn't publish (e.g. a one-way rate, or a partner name) are left out of that row.

Output per rate

Field	Description
recordType	Always "mileage_chart".
issuer	Program key (e.g. aeroplan, united).
issuerName	Full program name (e.g. "Air Canada Aeroplan").
originRegion / destinationRegion	The two regions this rate applies between.
cabin	Cabin class the rate applies to.
miles	Miles cost for the rate (roundtrip unless oneWay was requested).
milesOneWay	One-way miles cost, when the chart publishes one separately.
isPartner	Whether this is a partner-airline redemption rather than the issuer's own flights.
partnerName	Name of the partner airline, when isPartner is true and the chart names one.
milesNote	Any additional note published alongside the rate, such as the distance band it falls under.
taxes_min_usd / taxes_max_usd	Published tax/fee range for the redemption, in USD, when the chart publishes one.
sourceUrl	The program's own page this rate was read from.
scrapedAt	ISO 8601 timestamp of when this actor fetched the record.

Input

Field	Type	Default	Description
originRegion	String (select)	"north_america"	Region the trip departs from: North America, South America/Caribbean, Europe, Africa, Middle East, Asia, or Oceania.
destinationRegion	String (select)	"europe"	Region the trip ends in, from the same list.
cabin	String (select)	"business"	Cabin class to filter rates by: Economy, Premium Economy, Business, or First.
issuers	Array (select)	["aeroplan", "alaska", "american", "anaMileage", "britishAirways", "emirates", "flyingBlue", "lifemiles", "lufthansa", "qatar", "singaporeKrisflyer", "united", "virginAtlantic"]	Which frequent-flyer programs to query (see supported list below). Order affects which runs first.
oneWay	Boolean	false	Return one-way rates instead of roundtrip, for charts that publish both.
partnerOnly	Boolean	false	Only return partner-airline redemption rates.
maxResults	Integer	100	Maximum number of chart rows to return.

Example: roundtrip business-class comparison

{
    "originRegion": "north_america",
    "destinationRegion": "europe",
    "cabin": "business",
    "issuers": ["aeroplan", "united", "virginAtlantic", "flyingBlue"]
}

Example: one-way, partner-only rates

{
    "originRegion": "north_america",
    "destinationRegion": "asia",
    "cabin": "business",
    "oneWay": true,
    "partnerOnly": true,
    "issuers": ["aeroplan", "united", "lifemiles"]
}

Example: economy rates across all implemented programs

{
    "originRegion": "europe",
    "destinationRegion": "middle_east",
    "cabin": "economy",
    "maxResults": 200
}

Supported loyalty programs

Chart data is currently implemented for: Air Canada Aeroplan (aeroplan), Alaska Mileage Plan (alaska), American AAdvantage (american), ANA Mileage Club (anaMileage), British Airways Avios (britishAirways), Emirates Skywards (emirates), Air France/KLM Flying Blue (flyingBlue), Avianca LifeMiles (lifemiles), Lufthansa Miles & More (lufthansa), Qatar Privilege Club (qatar), Singapore KrisFlyer (singaporeKrisflyer), United MileagePlus (united), and Virgin Atlantic Flying Club (virginAtlantic).

The input also lists Aeromexico Club Premier, Azul TudoAzul, Copa ConnectMiles, Delta SkyMiles, Etihad Guest, Finnair Plus, JAL Mileage Bank, Qantas Frequent Flyer, SAS EuroBonus, and Turkish Miles&Smiles for forward compatibility — selecting one of these today simply returns no rows for that program, with no effect on the others you selected.

Use cases

• Redemption comparison — see which program charges the fewest miles for the same route and cabin before booking.
• Travel-hacking content — source up-to-date published chart values for blog posts, spreadsheets, or redemption calculators.
• Points valuation — combine miles and taxes_min_usd/taxes_max_usd with a program's point value to estimate true redemption cost.
• Partner-award research — set partnerOnly: true to focus on the partner-airline rates that are often cheaper or open up routes the issuer doesn't fly itself.

FAQ

Is this live seat availability? No. It's the published mileage chart — the fixed miles-and-taxes rate a program advertises for a region pair and cabin, not a live search for bookable award seats on a specific date.

Why did some of my selected programs return no rows? A few programs listed in the issuers input aren't implemented yet (see the list above); they're skipped cleanly rather than returning empty or fake rows.

Why is sourceUrl included? So you can open the exact page a rate was read from and confirm it against the program's own published chart.

What does partnerOnly: true change? It keeps only rows for redemptions on a partner airline rather than the issuer's own flights, for programs that publish a distinct partner rate.

Why do some rows have milesOneWay and others don't? Only programs that publish a separate one-way chart value populate milesOneWay; others publish roundtrip-only pricing.

Does maxResults limit results per program or overall? It's a hard cap on the total number of rows returned across every selected program.

Will re-running this actor pick up a chart change the same day a program updates it? Not necessarily. Each program's rates are a snapshot of its published chart rather than a page fetched fresh on every run, so a same-day change on the program's own site may not be reflected until the snapshot is refreshed. Use sourceUrl to confirm the current published rate.

Is this affiliated with any airline or loyalty program? No. This actor reads publicly published mileage charts and is not affiliated with or endorsed by any airline, alliance, or frequent-flyer program named above.