Celebrity jet tracker API.

Most flight data tells you a plane moved. Ours tells you whose jet it was and how much CO₂ it burned on the way. That covers hundreds of tracked aircraft, and every account gets $1 of free credits a month to try it.

Get an API key →Browse endpoints

01 · Quickstart

How do I make my first API call?

Create an account and generate a key from your dashboard.
Send the key on every request in the Authorization header. Never put it in the URL.
Check the X-Quota-Remaining response header to see how much quota you have left.

curl "https://api.celebplanes.com/api/v1/celebrities?slug=taylor-swift" \
  -H "Authorization: Bearer cp_live_YOUR_KEY"

# → { "celebrity": { "slug": "taylor-swift", "name": "Taylor Swift",
#     "aircraft": [{ "tail_number": "N…", "type": "Dassault Falcon 7X", … }] } }

You can also send your key as x-api-key: cp_live_…. Every response includes the X-Credits-Cost, X-Quota-Remaining, and X-RateLimit-Remaining headers.

02 · Reference

API endpoints

GET/api/v1/healthfree

Checks that the API is up and lists every endpoint. No key needed.

curl https://api.celebplanes.com/api/v1/health

GET/api/v1/celebrities1 credit

The owner list: who owns which tail number. Add ?slug= for one person’s full record, including their fleet. Filter by type with ?kind=coach|corporation|official. Page through results with ?limit and ?offset.

curl "https://api.celebplanes.com/api/v1/celebrities?limit=20" \
  -H "Authorization: Bearer cp_live_…"

GET/api/v1/live2 credits

Where tracked jets are right now. Positions are real-time and full precision, with heading and speed. Filter by person with ?slug=.

curl "https://api.celebplanes.com/api/v1/live?slug=taylor-swift" \
  -H "Authorization: Bearer cp_live_…"

GET/api/v1/flights3 credits

One person’s flight log. Each flight lists departure and arrival airports and times, duration, and top altitude and speed. Covers the full archive. ?slug= is required.

curl "https://api.celebplanes.com/api/v1/flights?slug=taylor-swift&limit=10" \
  -H "Authorization: Bearer cp_live_…"

GET/api/v1/emissions5 credits

Total CO₂ for one person across their completed flights. It uses our published fuel-burn model. ?slug= is required.

curl "https://api.celebplanes.com/api/v1/emissions?slug=taylor-swift" \
  -H "Authorization: Bearer cp_live_…"

GET/api/v1/leaderboard5 credits

The top CO₂ emitters, ranked. Optional: ?year=YYYY and ?limit=.

curl "https://api.celebplanes.com/api/v1/leaderboard?limit=25" \
  -H "Authorization: Bearer cp_live_…"

03 · Plans

How much does the API cost?

You pay only for what you use. There is no subscription. Every account gets $1 of free credits every month. Each call costs a set number of credits (see below). Need more? Buy a credit pack. Those credits never expire. You don't need a credit card to start.

Plan	Price	Credits/mo	Rate limit	Live data	History
Free	Free	1,200	10/s	Real-time	Full archive
Enterprise	Contact	Custom	5000/60s	Real-time	Full archive

Pay-as-you-go credit packs

Buy a pack once and use it whenever you like. Pack credits don't expire. We use them only after your free monthly credits run out.

Starter

$10

12,000 credits

$0.83 / 1k

Plus

$50

75,000 credits

$0.67 / 1k

Bulk

$200

400,000 credits

$0.50 / 1k

How many credits does each call cost?

celebrities = 1aircraft = 1live = 2flights = 3historical = 5emissions = 5leaderboard = 5trail = 10bulk = 50

04 · Fair use

Data rules: attribution and acceptable use

Attribution. Position data comes from adsb.lol under the Open Database License (ODbL). If you redistribute the underlying database, you must license it under ODbL. Each per-query response is a "Produced Work," which only requires crediting the source. Attribution and emissions data are © celebplanes.com.
No harassment or physical interception. These are public broadcasts the FAA requires. Even so, using the API to locate, follow, contact, or confront a person is strictly prohibited. It will get your key revoked. Build analysis, journalism, and research — not stalking.
Accuracy. Attribution and positions are best-effort. Some are estimated (and flagged) or dead-reckoned. There is no warranty, so verify facts yourself before you publish.
Suppression. We honor FAA LADD and good-faith removal requests. Contact us.

Full Terms · Privacy · Emissions methodology

Public flights, public planes — now programmable.

Get an API key →