Dying Pale Blue Dot

Developers

Build on cited planetary data

Quickstart

The API is currently open and free to call. Keys and metered access are coming soon.

curl -H "Authorization: Bearer dpb_live_xxx" \
  https://www.dyingpaleblue.com/api/v1/series/co2_concentration

# or
curl -H "x-api-key: dpb_live_xxx" \
  https://www.dyingpaleblue.com/api/v1/series/co2_concentration?format=csv

Endpoints

34 cited series · 103 companies.

GET	/api/v1	Self-describing index (open, no key).
GET	/api/v1/series	Every cited series with provenance.
GET	/api/v1/series/{key}	One series + data points (?format=csv).
GET	/api/v1/sustainability	Company sustainability scores (filters, CSV).
GET	/api/v1/sustainability/{ticker}	One company + cited breakdown.

Auth & errors

401 — missing/invalid/revoked key
402 — free quota used up, or subscription lapsed
403 — key lacks the endpoint scope
429 — rate limited (see Retry-After)

Responses carry X-RateLimit-Limit / Remaining / Reset.

Limits & trust

Rate limit: 120/min per key (default)
Envelope: { data, meta }
Missing numbers are null, never 0
Only observed, cited series — no projections

See pricing →

Embed a chart (no key needed)

Every time-series has a chrome-less, live-updating widget at /embed/<key>— drop it in an iframe and the chart, its cited source tag and the “not a forecast” projection all travel with it. Any series key from the API works (except the country snapshot).

<iframe
  src="https://www.dyingpaleblue.com/embed/co2_concentration"
  width="100%" height="360" style="border:0" loading="lazy"
  title="Atmospheric CO2 — Dying Pale Blue Dot"></iframe>