Airport Database API
Airport database + flight distance in one call: IATA/ICAO lookup, airports near a point, great-circle distance, flight time and CO2 per passenger (official UK DEFRA 2025 factors), plus live METAR/TAF. Open data, no API key, no proxy.
Example request
curl -X POST https://radarbg.com/v1/airports-flight-distance \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"mode": "distance", "routes": ["JFK-LHR", "SOF-VAR", "LAX-NRT"], "codes": ["JFK", "LHR", "SOF"], "latitude": 43.2321}'
Answer: {"ok": true, "count": N, "items": [...], "usage": {...}}. Failed calls are not counted.
Inputs
| Field | Type | Description |
|---|---|---|
mode | string | distance = great-circle distance, bearing and estimated flight time for routes like JFK-LHR. lookup = full airport details by IATA/ICAO code. search = find airports by text, country or type. nearby = airports around a latitude/longitude. we |
routes | array | Airport pairs as IATA or ICAO codes, for example JFK-LHR, SOF-VAR, LAX-NRT. Accepted separators: dash, 'to', '>' or space. |
codes | array | IATA (3 letters, e.g. JFK) or ICAO (4 characters, e.g. EGLL) airport codes. For weather mode, ICAO codes of any station also work. For airline mode: airline IATA (BA, W6), ICAO (BAW) codes or names (Ryanair). |
query | string | Text to find in airport name, city, code or keywords, for example 'heathrow', 'varna' or 'international'. Can be combined with country and type filters. In airline mode: text in the airline name, alias or callsign, e.g. 'wizz' or 'speedbird |
country | string | Two-letter ISO country code, for example US, GB, BG, DE. Empty = all countries. In airline mode: ISO 2-letter code lists that country's airlines (e.g. BG). |
types | array | Filter by type: large_airport, medium_airport, small_airport, heliport, seaplane_base, balloonport, closed. Empty = all open airport types in search mode, and large/medium/small airports in nearby mode. |
latitude | number | Latitude of the center point in decimal degrees, for example 43.2321 (Varna). |
longitude | number | Longitude of the center point in decimal degrees, for example 27.8251 (Varna). |
radiusKm | integer | Search radius around the point in kilometers. |
scheduledServiceOnly | boolean | Keep only airports that have scheduled passenger flights. Turn off to also see small airfields. |
includeTaf | boolean | Also return the latest TAF (terminal aerodrome forecast) for each station, raw text. |
includeFaaDelays | boolean | weather and lookup modes: add faaDelays to every US airport row - official FAA NAS status right now (ground stop, ground delay program with avg/max minutes, arrival/departure delays, closures). Non-US airports are unchanged. One extra free |
activeAirlinesOnly | boolean | Airline mode: for name, query and country searches return only airlines marked active. Code lookups always return the best match (active first) and list other airlines that used the same code. |
onlyNew | boolean | For monitoring: weather mode returns only METARs that changed since the last run, other modes return only airports or routes not seen before for this Monitor ID. Each result is paid for once. |
Price
Included in every plan: 100 calls a month free, then from €9 a month for 3,000 calls across all APIs.