Seats.aero Pet Plugin

Search for award flight availability across major airline alliances and mileage programs using the Seats.aero Partner API.

Features

• Cached Search - Search for award flights between specific airports with date ranges
• Bulk Availability - Get availability data from specific mileage programs across regions
• Trip Details - Get detailed flight-level information from availability results
• Routes - List all routes available on a mileage program
• Live Search - Real-time search (requires commercial agreement)

Supported Mileage Programs

• United MileagePlus
• Air Canada Aeroplan
• Alaska Mileage Plan
• American AAdvantage
• Delta SkyMiles
• Emirates Skywards
• Etihad Guest
• SAS EuroBonus
• Virgin Atlantic Flying Club
• Velocity Frequent Flyer
• Qantas Frequent Flyer
• Aeromexico Club Premier
• Smiles
• Avianca LifeMiles
• Turkish Miles&Smiles
• Flying Blue

Setup

1. Get Your API Key

Pro Users:

• Go to your Seats.aero settings page
• Generate a personal API key
• Keys have format: seats:ota:xxxxx

Commercial Users:

• Contact the Seats.aero team for API access

2. Configure Environment

Add to your .env file:

# Pro users (format: pro_xxxxx)
SEATS_AERO_API_KEY=pro_your_key_here

# Commercial users (format: seats:ota:xxxxx)
SEATS_AERO_API_KEY=seats:ota:your_key_here

3. Test Connection

opencode run "test seats-aero connection"

Example Queries

# Search for business class awards
opencode run "search for business class award flights from JFK to LHR"

# Find first class availability
opencode run "find first class availability from LAX to NRT in June"

# Get bulk availability for a program
opencode run "get bulk availability for United MileagePlus"

# Show routes
opencode run "show me routes available on Aeroplan"

# Get trip details
opencode run "get trip details for availability ID abc123"

Tools

| Tool | Description | |------|-------------| | seats-aero-test-connection | Test API connection and configuration | | seats-aero-cached-search | Search cached award availability | | seats-aero-bulk-availability | Get bulk availability from a program | | seats-aero-get-trip | Get detailed trip/flight information | | seats-aero-get-routes | List routes for a mileage program | | seats-aero-live-search | Real-time search (commercial only) |

Cabin Classes

| Code | Class | |------|-------| | Y | Economy | | W | Premium Economy | | J | Business | | F | First |

The API accepts both full names (economy, business, first) and codes.

API Limits

• Pro Users: Up to 1,000 API calls per day at no cost
• Commercial Users: Custom limits based on agreement

FAQ

How do I get my API key? Pro users can generate a personal API key via their Seats.aero settings page. Commercial users receive keys directly from the Seats.aero team.

What's the difference between cached search and live search? Cached search queries pre-indexed availability data (instant results). Live search queries airlines directly (5-15 seconds, requires commercial agreement).

What API key format should I use? Pro users have keys starting with pro_. Commercial users have keys in the format seats:ota:xxxxx. Just use your key directly without any prefix.

Generated with OpenAPI

This pet's tools are auto-generated from an OpenAPI specification. To regenerate:

cd pets/seats-aero
pets generate-openapi

Links

• Seats.aero
• API Documentation
• Knowledge Base