Find airports near a specific airport via FlightAware AeroAPI — $0.008 per request, pay with USDC on Tempo.
What it does
This endpoint returns a list of airports geographically near a given reference airport, identified by its ICAO or IATA code in the URL path parameter `:id`. It is part of StableTravel's FlightAware integration, which proxies FlightAware AeroAPI data through a pay-per-request micropayment model. No API keys or subscriptions are required; payment is handled via the MPP protocol (Tempo method, settling in pathUSD on chain ID 4217).
The endpoint accepts optional query parameters: `radius` (search radius), `only_iap` (filter to airports with instrument approach procedures), `max_pages`, and `cursor` for pagination. The response includes an array of nearby airport objects with fields such as `airport_code`, `name`, `code_icao`, `code_iata`, `city`, `state`, `latitude`, `longitude`, `elevation`, `timezone`, `country_code`, `distance`, and `heading` from the reference airport. Pagination links and page count are also returned.
Pricing is $0.008 per request (8000 base units of pathUSD with 6 decimals). The endpoint is live, confirmed by a 402 MPP challenge response. It is part of a larger StableTravel API suite covering flights, hotels, activities, transfers, and comprehensive FlightAware data including real-time tracking, weather, delays, and flight history.
Capabilities
Use cases
- —Finding alternative airports near a traveler's destination for cheaper flights or diversions
- —Building airport selection UIs that show nearby options when a primary airport is congested
- —Automated diversion planning for flight operations when weather closes an airport
- —Travel agents suggesting nearby airports for flexible itineraries
- —Aviation apps displaying surrounding airfields for general aviation pilots
Fit
Best for
- —Agents that need to suggest alternative airports near a known airport
- —Flight disruption handling where nearby diversion airports must be identified
- —Travel planning workflows that compare options across multiple nearby airports
Not for
- —Finding airports near arbitrary lat/lng coordinates (use /api/flightaware/airports/nearby instead)
- —Booking flights or hotels (separate endpoints exist for those)
- —Real-time flight tracking (use /api/flightaware/flights/{id}/track)
Quick start
npx agentcash fetch "https://stabletravel.dev/api/flightaware/airports/KJFK/nearby?radius=50&only_iap=true"Example
Response
{
"links": {
"next": null
},
"airports": [
{
"city": "New York",
"name": "LaGuardia",
"type": "Airport",
"state": "NY",
"heading": 315,
"distance": 9.2,
"latitude": 40.7772,
"timezone": "America/New_York",
"code_iata": "LGA",
"code_icao": "KLGA",
"elevation": 21,
"longitude": -73.8726,
"airport_code": "KLGA",
"country_code": "US"
}
],
"num_pages": 1
}Endpoint
Quality
Full OpenAPI schema with detailed response structure, clear pricing ($0.008/request), live 402 MPP challenge confirmed, comprehensive documentation in the guidance field, and well-defined parameters. Only minor gap is lack of a real example response from the probe (response body was not captured).
Citations
- —Endpoint price is $0.008 per requesthttps://stabletravel.dev/openapi.json
- —Payment via MPP protocol using Tempo method on chain ID 4217https://stabletravel.dev/openapi.json
- —Endpoint is live (402 MPP challenge returned)https://stabletravel.dev/api/flightaware/airports/:id/nearby
- —No API keys needed; payment via USDC on Base, Solana, or Tempo serves as authenticationhttps://stabletravel.dev