fa_search_flights_advanced
Read-only
Search flights using a structured query language with operators and keys like ident, orig, dest, alt, and status. Build expressive queries with predicates for precise flight filtering.
Instructions
Search flights using AeroAPI's full structured query language (more expressive than fa_search_flights). The query is a space-separated list of {operator key value} predicates, e.g. "{match ident UAL*} {> alt 300} {= dest KLAX}". Operators: true/false/null/notnull/=/!=/</>/<=/>=, match/notmatch (case-insensitive wildcards), range (two values), in/orig_or_dest/aircraftType/ident/ident_or_reg ({a b c} value lists), airline (1=airline, 0=GA). Common keys: ident, orig, dest (ICAO codes), aircraftType, alt (hundreds of ft), prefix, lifeguard, cancelled, arrived.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Structured "{operator key value}" query, e.g. {match ident UAL*} {> alt 300} | |
| cursor | No | Opaque paging cursor from a previous response's links.next | |
| max_pages | No | Max pages to fetch, 1-20 (AeroAPI default: 1). Capped at 20 since AeroAPI bills per page. |