Spotterra data for developers
Statistics we compute from our own observations — emergencies, delays, punctuality, GPS jamming, flights and routes. No key, JSON over HTTPS, rate-limited per IP.
We do not offer live aircraft positions through the API: they come from community networks whose terms do not allow it. You can embed the live map on your site instead. Live map widget →
| Path | Returns | Limit | Cache |
|---|---|---|---|
| /api/public/emergencies | Ongoing and finished 7600/7700 squawk episodes, plus diversions and returns, over the last 30 days. | 60/min | 60 s |
| /api/public/delays | Airports building up delays over the last 3 hours: median against each flight's usual time, share delayed, trend. | 60/min | 120 s |
| /api/public/punctuality | Airline punctuality over 30 days: on-time share (D15), median delay, 7-day trend. | 60/min | 600 s |
| /api/public/gps-jamming?day=YYYYMMDD | Cells with the share of aircraft reporting low position integrity (NIC) for a UTC day, last 7 days. | 60/min | 600 s |
| /api/public/coverage-gaps | Where aircraft most often drop out of community coverage in flight (7 days). | 60/min | 1800 s |
| /api/public/flight/{CALLSIGN} | Flight by callsign: route, usual takeoff and landing, weekdays, aircraft types. | 120/min | 1800 s |
| /api/public/route/{ICAO_A}/{ICAO_B} | Route between two airports: airlines, types, traffic. | 120/min | 1800 s |
| /api/public/airline/{ICAO} | Airline over 30 days from our own observations. | 120/min | 1800 s |
| /api/public/airport-traffic/{ICAO} | Airport traffic over 30 days from observed takeoffs and landings. | 120/min | 3600 s |
| /api/public/type/{ICAO_TYPE} | Aircraft type: where and when we see it. | 120/min | 1800 s |
Example
curl -s https://spotterra.com/api/public/delays | jq '.letiste[0]'
Field names are currently in Czech (for example letiste = airports, odlety = departures, vcas_pct = on-time share). Times are Unix seconds or minutes of the UTC day.
Terms of use
Credit “Spotterra” with a link to spotterra.com. The data is derived from community ADS-B networks (adsb.lol — ODbL; adsb.fi); credit them as well. Commercial use by arrangement, within the source networks’ terms (adsb.fi allows personal, non-commercial use only): [email protected].
Stability
We add fields, we do not remove them. Any breaking change will be announced on this page at least 30 days ahead.