Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Search award flight availability across 24 mileage programs, including business and first class, with detailed route and booking info via seats.aero API.
Search award flight availability across 24 mileage programs, including business and first class, with detailed route and booking info via seats.aero API.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Search award flight availability across 24 mileage programs using the seats.aero partner API.
Before searching, you need a seats.aero API key: If the user hasn't provided an API key, prompt them: "Please provide your seats.aero API key. You can get one at https://seats.aero/partner" Store the key in conversation context for subsequent requests All requests require the header: Partner-Authorization: Bearer {api_key}
Search cached availability across all mileage programs for a specific origin-destination pair.
Explore all availability from a single mileage program, optionally filtered by region.
Get all routes monitored for a specific mileage program.
Get detailed flight segments and booking links for a specific availability.
ItemValueBase URLhttps://seats.aero/partnerapi/Auth HeaderPartner-Authorization: Bearer {key}Date FormatYYYY-MM-DD
Y = Economy W = Premium Economy J = Business F = First
North America, South America, Europe, Africa, Middle East, Asia, Oceania
aeroplan, alaska, american, aeromexico, azul, copa, delta, emirates, ethiopian, etihad, finnair, flyingblue, gol, jetblue, lufthansa, qantas, qatar, sas, saudia, singapore, turkish, united, virginatlantic, virginaustralia
User: "Find business class SFO to Tokyo next month" Use /search endpoint with: origin_airport=SFO destination_airport=NRT,HND (both Tokyo airports) cabin=J start_date and end_date for the date range
User: "What United awards are available from Europe?" Use /availability endpoint with: source=united origin_region=Europe
User: "Show me details for that flight" Use /trips/{id} with the availability ID from previous search Response includes flight segments, times, and booking links
User: "What routes does Aeroplan monitor?" Use /routes endpoint with source=aeroplan
ParameterRequiredDescriptionorigin_airportYes3-letter IATA codedestination_airportYes3-letter IATA code(s), comma-separatedcabinNoY, W, J, or F (comma-separated for multiple)start_dateNoYYYY-MM-DDend_dateNoYYYY-MM-DDsourcesNoProgram name(s), comma-separatedonly_directNotrue/falsetakeNoResults per page (default 100)cursorNoPagination cursor
ParameterRequiredDescriptionsourceYesSingle program namecabinNoSingle cabin codeorigin_regionNoFilter by origin regiondestination_regionNoFilter by destination regionstart_dateNoYYYY-MM-DDend_dateNoYYYY-MM-DDtakeNoResults per page
For complex or repeated searches, use the Python helper: from scripts.seats_api import search_availability, format_results results = search_availability( api_key="your_key", origin="SFO", destination="NRT", start_date="2024-03-01", end_date="2024-03-31", cabins="J,F" ) print(format_results(results["data"], cabin="J")) See scripts/seats_api.py for full API client implementation.
ID - Use for /trips/{id} lookup Route - Origin-Destination pair Date - Flight date YAvailable, WAvailable, JAvailable, FAvailable - Boolean availability YMileageCost, etc. - Points required per cabin YDirects, etc. - Number of direct flights available Source - Program name ComputedLastSeen - Data freshness timestamp
401: Invalid or missing API key 429: Rate limited, wait and retry 404: No results or invalid availability ID
Date ranges: Keep to 30-60 days for faster results Multiple cabins: Search J,F together for premium options Direct flights: Use only_direct=true to filter connections Pagination: Use cursor from response for more results Data freshness: Check ComputedLastSeen - older data may be stale
For complete API specification including all fields and response schemas, see references/api-spec.md.
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.