Help › Data sources and limits
Data sources and limits
Tailwatch reads live positions from adsb.lol, a free, community-run network of ADS-B receivers. You can also add your own receiver.
How the daily limit works
adsb.lol limits how many requests each user can make per day. Tailwatch spreads its requests across the day and slows down automatically, so it never runs out early. It never sends more than one request per second, and it only asks for what it needs: your watched aircraft, and the map area on screen while Traffic is on.
| Plan | Requests a day | What it feels like |
|---|---|---|
| No key | 500 | Fine for a few aircraft. Updates every few minutes; slower with Traffic on. |
| Free API key | 1,000 | About twice as often. |
| Feeder key | 7,200 | Frequent updates all day. For people who share data from their own receiver. |
Settings → Data shows whether the source is working and how much of today's limit is used. The count resets at midnight UTC.
Which plan to pick
- Watching one to three aircraft, Traffic mostly off: no key is enough.
- More aircraft, or Traffic on often: get the free key.
- You have, or want, a receiver: feed adsb.lol and use a feeder key. Better still, point Tailwatch at the receiver itself, which has no limit at all for aircraft near you. See Using your own receiver.
Getting an adsb.lol API key
- Go to adsb.lol and follow its instructions for requesting an API key. Keys are free. adsb.lol runs the process, so its site has the current steps.
- In Tailwatch, open Settings → Data.
- Paste the key, and choose the plan that matches it under Plan.
Your key is stored in the macOS Keychain and sent only to adsb.lol.
A custom source
If you have access to another service that speaks the same format (ADSBExchange v2), choose Custom in Settings → Data and enter its address and limits.
"Daily limit reached"
Online lookups pause until midnight UTC. Your own receiver, if you have one, keeps working. Adding a key resumes lookups right away.