§Developer API

The Celebplanes API.

The only API that tells you whosejet it is and how much carbon it burned — celebrity & owner attribution, sessionized flight logs, and CO₂ emissions for hundreds of tracked aircraft.

Get an API key →Browse endpoints

01 · Quickstart

Make your first call

Create an account and generate a key from your dashboard.
Send it on every request in the Authorization header (never in the URL).
Watch X-Quota-Remaining in the response headers.

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", … }] } }

Auth also accepts x-api-key: cp_live_…. Every response carries X-Credits-Cost, X-Quota-Remaining, and X-RateLimit-Remaining.

02 · Reference

Endpoints

GET/api/v1/healthfree

Liveness + endpoint discovery. No key required.

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

GET/api/v1/celebrities1 credit

The attribution roster — who owns which tail. Add ?slug= for full detail incl. fleet, or ?kind=coach|corporation|official. Paginate with ?limit & ?offset.

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

GET/api/v1/live2 credits

Current tracked positions (coarsened + delayed by tier; real-time fidelity on Business+). Filter with ?slug=.

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

GET/api/v1/flights3 credits

Sessionized flight log for one person: departure/arrival airports + times, duration, max altitude/speed. Lookback capped by tier. ?slug= required.

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

GET/api/v1/emissions5 credits

Aggregate CO₂ for a person across their completed flights, using our published fuel-burn model. ?slug= required.

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

GET/api/v1/leaderboard5 credits

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

Pricing

One credit balance per month; each call costs credits by weight (below). No credit-card required for the free tier. Annual billing saves ~17%.

Plan	Price	Credits/mo	Rate limit	Live data	History
Free	Free	1,000	1/s	24h delay · ~1dp	7 days
Pro	$99/mo	100,000	300/60s	5min delay · ~3dp	Full archive
Enterprise	Contact	Custom	5000/60s	Real-time	Full archive

Pay as you go

No subscription needed — buy a credit pack once and spend it whenever. Top-up credits don't expire and are used only after your monthly allowance runs 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

Credit weights

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

04 · Fair use

Data, attribution & acceptable use

Attribution. Position data derives from adsb.lol under the Open Database License (ODbL). If you redistribute the underlying database you must license it under ODbL; per-query responses are "Produced Works" and only require crediting the source. Attribution & emissions are © celebplanes.com.
No harassment or real-time interception. These are public FAA-mandated broadcasts, but using the API to locate, follow, or contact a person in real time is prohibited. Live positions are delayed & coarsened except on verified higher tiers.
Accuracy. Attribution and positions are best-effort; some are estimated (flagged) or dead-reckoned. No warranty — verify independently before publishing.
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 →