AirNav APIairnav.com ↗
Get aviation fuel prices (100LL, Jet A, UL94, SAF, Mogas) for any US airport FBO via the AirNav API. Includes service type, contact info, and price update timestamps.
What is the AirNav API?
The AirNav API exposes a single endpoint, get_fuel_prices, that returns all Fixed Base Operators at a given US airport along with their current fuel prices across up to five fuel types (100LL, Jet A, UL94, SAF, Mogas). Each response includes the FBO name, fuel provider, per-gallon price, service type (Full Service or Self Service), contact details, and when pricing was last updated — everything needed to compare fueling costs before a flight.
curl -X GET 'https://api.parse.bot/scraper/3d9b99b8-6d96-4ac7-8f7a-5a3ee52e32f2/get_fuel_prices?airport_id=KJFK' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace airnav-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""AirNav FBO Fuel Prices — bounded walkthrough demonstrating typed access."""
from parse_apis.airnav_airport_fbo_fuel_prices_api import AirNav, AirportNotFound
client = AirNav()
# Fetch FBO fuel prices for a busy GA airport by ICAO code.
airport = client.airports.get(airport_id="KVNY")
print(f"{airport.airport_name}: {airport.fbo_count} FBOs")
# Drill into the first FBO's fuel prices using typed attribute access.
for fbo in airport.fbos[:3]:
print(f" {fbo.business_name} (provider: {fbo.fuel_provider})")
for fp in fbo.fuel_prices:
print(f" {fp.fuel_type}: ${fp.price} ({fp.service_type})")
# Typed error handling: attempt to look up a non-existent airport.
try:
client.airports.get(airport_id="ZZZZ")
except AirportNotFound as exc:
print(f"Error: airport {exc.airport_id} not found")
print("exercised: airports.get / Airport.fbos / FBO.fuel_prices / AirportNotFound")
Get FBO fuel prices for a specific airport. Returns all Fixed Base Operators at the airport with their fuel prices, fuel provider, contact information, and pricing details. Each FBO includes business name, fuel provider brand, individual fuel prices by type and service level, price update date, guarantee status, and contact information.
| Param | Type | Description |
|---|---|---|
| airport_idrequired | string | Airport identifier - ICAO code (e.g., KJFK, KVNY, KSFO) or FAA LID (e.g., 0B5). Case-insensitive. |
{
"type": "object",
"fields": {
"fbos": "array of FBO objects with business_name, fuel_provider, fuel_prices (array of {fuel_type, price, service_type}), price_updated, price_guaranteed, and optional contact fields (phone, toll_free, website, email, asri_frequency, detail_url, located_at)",
"fbo_count": "integer - Number of FBOs found",
"airport_id": "string - Airport identifier as provided (uppercased)",
"airport_name": "string - Full airport name"
},
"sample": {
"data": {
"fbos": [
{
"email": "[email protected]",
"phone": "+1 (555) 012-3456",
"website": "https://modern-aviation.com/new-york-city-jfk/",
"detail_url": "https://www.airnav.com/airport/KJFK/MODERN",
"fuel_prices": [
{
"price": 10.54,
"fuel_type": "100LL",
"service_type": "Full Service"
},
{
"price": 11.95,
"fuel_type": "Jet A",
"service_type": "Full Service"
}
],
"business_name": "Modern Aviation",
"fuel_provider": "Titan",
"price_updated": "08-Jun-2026",
"price_guaranteed": false
}
],
"fbo_count": 1,
"airport_id": "KJFK",
"airport_name": "John F Kennedy International Airport"
},
"status": "success"
}
}About the AirNav API
What the API Returns
The get_fuel_prices endpoint accepts an airport_id parameter — either an ICAO code (e.g., KJFK, KSFO) or an FAA LID (e.g., 0B5) — and returns a structured response covering every FBO listed at that airport. The top-level fields include airport_name, airport_id (uppercased), and fbo_count. The core data lives in the fbos array.
FBO Object Fields
Each object in the fbos array contains business_name, fuel_provider, and fuel_prices — an array of objects each carrying fuel_type, price (per gallon), and service_type. The service_type field distinguishes Full Service from Self Service fueling, which directly affects operational cost comparisons. price_updated indicates the freshness of the listed price. Contact information is also included per FBO, useful for calling ahead to confirm availability or negotiate volume pricing.
Coverage and Input Behavior
The airport_id input is case-insensitive and accepts both ICAO and FAA LID formats, so kjfk, KJFK, and JFK all resolve correctly. Coverage is limited to US airports indexed by AirNav. Not every FBO at every airport will have current price data — price_updated timestamps reflect when the FBO last submitted pricing, and some entries may be absent if no fuel prices have been reported.
The AirNav API is a managed, monitored endpoint for airnav.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when airnav.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official airnav.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Flight planning apps that surface cheapest Jet A or 100LL per gallon at a destination airport
- Charter and fractional operators comparing Full Service vs Self Service pricing across multiple FBOs
- Avgas price tracking dashboards that log
price_updatedtimestamps to detect price changes over time - Flight school cost calculators that pull 100LL or UL94 prices by airport to estimate fuel spend per lesson
- Corporate flight department tools that identify SAF availability and pricing at planned stops
- Airport directory apps that display FBO contact information alongside current fuel pricing
- Route optimization tools that factor in fuel costs across intermediate stops using per-gallon price data
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does AirNav have an official developer API?+
What fuel types does get_fuel_prices return, and does it distinguish service levels?+
service_type field that indicates whether the FBO offers Full Service or Self Service fueling, which can meaningfully affect cost.Does the API cover airports outside the United States?+
get_fuel_prices. You can fork this API on Parse and revise it to add an endpoint targeting international aviation fuel data sources.Can I get historical fuel price trends or only current prices?+
price_updated timestamp per FBO, but does not expose historical price series. You can fork this API on Parse and revise it to add a storage layer that logs prices over time to build your own historical dataset.How current are the fuel prices returned by the API?+
price_updated field showing when that FBO last submitted pricing to AirNav. Some FBOs update frequently; others may have stale entries. The price_updated field is the best indicator of data freshness for any specific FBO.