Flight Award Availability Scraper

Miles planners, transfer-bonus analysts, and AI travel agents use this Actor to extract award availability dataset rows — miles, taxes/surcharges, cabin seats, stops, and loyalty program metadata — for a caller-supplied origin, destination, and date window from public Flightpoints explore calendars and Roame GraphQL search. HTTP-only and cookieless; designed for structured redeemable-award research rather than airline login or booking.

Best fit for this Actor

• Compare economy, premium, business, or first awards on a known O&D.
• Filter by program slug or code (for example american / AA, or Flying Blue AF/KL).
• Expand major hubs when origin or destination is left empty for a bounded hub scan.
• Best fit when you need redeemable miles quotes; for paid cash fares and schedule shopping on the same O&D, start with or continue with the sibling cash-fare Actor linked under Connect the workflow.

Practical scenario

A miles planner sets origins JFK, destinations LHR, cabin business, and a single forward departure date, with maxItems at 20. The run returns dual-source award rows: Flightpoints cabin blocks with miles/taxes/seats and Roame fares with flight numbers when present. The planner sorts by miles then taxes, then re-checks the winning program on the airline site before transferring points.

Quick start input

{
  "origins": ["JFK"],
  "destinations": ["LHR"],
  "startDate": "YYYY-MM-DD",
  "endDate": "YYYY-MM-DD",
  "cabin": "business",
  "sources": ["flightpoints", "roame"],
  "maxItems": 20,
  "maxConcurrency": 3
}

Leave dates empty to search about a month ahead. The forward window caps at sixty days from today.

Input reference

Field	What it controls
origins[] / destinations[]	IATA codes. Empty side expands major hubs.
startDate / endDate / departureDate	Departure window (YYYY-MM-DD).
routes[]	Explicit {origin,destination,departureDate} jobs.
cabin	economy | premium | business | first
issuers[]	Program slug or code filter
sources[]	Default ["flightpoints","roame"]
directOnly	Keep nonstop awards only
maxItems	Cap billed rows (default 100; quality prefill 20)
maxConcurrency	Parallel searches (default 3)
proxyConfiguration	Optional Apify Proxy

What data you receive

One dataset item is one award itinerary. Flightpoints may fill multiple cabins on one row; Roame is typically one cabin per fare.

{
  "source": "flightpoints",
  "origin": "JFK",
  "destination": "LHR",
  "departureDate": "YYYY-MM-DD",
  "program": "AA",
  "programName": "AAdvantage",
  "issuer": "american",
  "cabins": {
    "business": { "miles": 57500, "taxes": 733.5, "seats": 2, "stops": 0, "airlines": ["BA", "AA"] }
  },
  "scrapedAt": "ISO-8601 timestamp"
}

Field	Meaning
source	flightpoints or roame
program / issuer	Loyalty program code and slug
cabins	Per-cabin miles, taxes, seats, stops, airlines
flightNumbers / durationMinutes	Present when Roame provides them
lastSeen / scrapedAt	Provider freshness and scrape time

Download JSON, CSV, or Excel from the run dataset. Key-value OUTPUT / RUN_SUMMARY use outcomes COMPLETE, PARTIAL, VALID_EMPTY, INVALID_INPUT, UPSTREAM_FAILED, or CONFIG_ERROR.

Use through the API

curl "https://api.apify.com/v2/acts/khadinakbar~flight-award-availability-scraper/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"origins":["JFK"],"destinations":["LHR"],"cabin":"business","maxItems":20,"sources":["flightpoints","roame"]}'

Read rows from the run defaultDatasetId after status is SUCCEEDED. Check key-value OUTPUT.outcome for the terminal contract above.

Use with AI agents through Apify MCP

Search award availability JFK to LHR in business cabin. Return miles, taxes, seats, and stops. Cap at twenty rows. Sources: flightpoints and roame. Prefer American and Flying Blue when both appear.

Inspect OUTPUT.outcome, keep origin/destination/departureDate/program as provenance, and keep maxItems small. Client setup: https://mcp.apify.com.

Connect the workflow

This Actor is designed as a focused standalone workflow for redeemable award space. When you also need paid cash fares on the same O&D, then pass that route into Kayak Flights Scraper for schedule and cash-price context beside miles.

Keep award rows here for miles planning only; hotel stays belong on a dedicated lodging Actor such as Airbnb Scraper when you need listing inventory after the flight award is chosen.

Pricing

This Actor uses Pay per event plus Apify platform usage. Open the live Pricing tab for current event details, and use Apify's run cost controls to keep the workflow aligned with your budget.

• apify-actor-start: $0.00005 per run
• award-itinerary: $0.003 per saved award row

A quality prefill that returns twenty itineraries bills one start event plus twenty award-itinerary events. Empty successful searches (VALID_EMPTY) and invalid input charge no itinerary events.

Best results

• Start with one O&D and one date; expand hubs after a successful single-route run.
• Keep maxConcurrency at two or three so Roame polling stays stable.
• Use issuer code AF/KL for Flying Blue (URL-encoded automatically).
• Treat provider lastSeen as a freshness hint and re-check before transferring points.

Design note

In my testing, anonymous Flightpoints explore calendars were the reliable bulk source, while authenticated Flightpoints search and MCP stayed gated — so this Actor stays on explore plus Roame initiate/poll. Roame needs a short poll loop until the search is mostly complete; that dual-path design is why rows carry an explicit source field instead of pretending one upstream owns every award.

Responsible use

Use public award-search data for personal research and planning. Follow airline program rules, Flightpoints and Roame terms, and applicable law. Award space changes constantly; verify on the airline site before transferring points or booking.

Flightpoints is a trademark of its respective owner. This independent Actor is not affiliated with, associated with, or endorsed by Flightpoints. Roame is a trademark of its respective owner. This independent Actor is not affiliated with, associated with, or endorsed by Roame. American Airlines and AAdvantage are trademarks of American Airlines, Inc. This independent Actor is not affiliated with, associated with, or endorsed by American Airlines, Inc.