ELECTRIC STATE · SCENE INDEX

The API

Festival booking data for electronic music — 1,700+ editions, 11,900+ artists, 1993 to present. Day-by-day lineups, set times where published, every edition linked to its series.

The boards on electricstate.app show the top 10. This is the rest: full rankings both upcoming and all-time, an artist's complete booking history rather than the last 18 months, every edition of every festival, and the year-by-year genre mix since 1993. Booking counts are computed from lineups, so every number can be checked against the editions it came from.

Built for the people who work the scene — agencies, talent buyers, promoters, labels, journalists. You don't need to be a developer: one curl command answers most questions, and the “For AI assistants” block below turns any assistant into a Scene Index analyst.

Plans

Your API key is issued the moment checkout completes. Start on Standard and move up whenever you want — upgrading is self-serve and your key gains the archive as soon as it goes through.

Need a custom cut — a roster, a territory, a genre — or an enterprise volume? hello@electricstate.app

Only need a little?

Two smaller ways in, both inside the app at electricstate.app. Neither includes the API, exports or the genre trends — if you need the data in your own tools, the plans above are the product.

Authentication

Your key is issued the moment checkout completes — one per organization, shown once. Send it on every request:

curl -s https://api.electricstate.app/v1/coverage \
  -H "Authorization: Bearer esk_live_YOUR_KEY"

Keys are secrets: server-side only, never in a browser page or a shared notebook.

Usage & limits

Plans include 50,000 requests a month. Every response — success or error — carries your current position against that ceiling, so you never have to guess where you stand:

Responses are uncached, so the numbers are always live. Need a higher ceiling? Ask — raising it is a one-line change on our side.

Endpoints

Machine-readable spec: openapi.json

For AI assistants

Using ChatGPT? A regular chat cannot call this API — its Python tool has no internet access and its browser cannot send auth headers. Build a custom GPT instead (once, two minutes, needs a paid plan):

1. ChatGPT → Explore GPTs → + Create → Configure tab. Name it “Scene Index”.
2. Paste the block below into Instructions.
3. Actions → Create new action → Import from URL → https://api.electricstate.app/v1/openapi.json
4. Authentication → API Key → type Bearer → paste your key. Save, visibility “Only me”.
5. Ask it: “what’s the coverage?” — then ask anything in plain English.

Using an agent with real HTTP tools (Claude Code, Cursor, a scripting agent)? Just paste this block into its instructions and add your key where it says<API_KEY>:

You can query the Electric State Scene Index API — festival booking data for
electronic music: 1,700+ festival editions, 11,900+ artists, 1993–present.

BASE URL: https://api.electricstate.app/v1
AUTH: send header  Authorization: Bearer <API_KEY>  on every request.
The key is a secret. Never print it back, never put it in a URL.

ENDPOINTS (all GET, all return JSON):
1. /festivals — list editions (one row per festival per year).
   Params: year=2015 | country=US | series=<series-slug> | q=<name search>
   | upcoming=true | limit (max 200) | offset. Returns { meta.total, editions[] }.
2. /festivals/{slug} — one edition in full: lineup[], set_times[], series_editions[].
   Slugs look like crssd-festival-spring-2015.
3. /artists/{name}/bookings — an artist's whole booking history.
   Name matching ignores case and punctuation. Returns summary
   { total_bookings, first_year, last_year, span_years } plus every booking.
4. /leaderboards/most-booked?scope=upcoming|all&limit=50
   scope=upcoming (default) = who is booked on festivals still ahead.
   scope=all = all-time career leaderboard. These answer DIFFERENT questions —
   never merge or swap them.
5. /trends/genres?from=1993&to=2026 — year-by-year genre mix: share of
   tagged editions carrying each scene (House, Techno, Bass, Drum & Bass,
   Trance…). Multi-tagged bills count toward every scene, so shares can sum
   past 100%. Full history on every tier.
6. /coverage — { all_time, upcoming } festival and artist counts.

RULES:
- "Edition" means one festival in one year. A festival's history = filter by
  its series slug, found on any edition row as series_slug.
- Booking counts measure frequency, never fees.
- Historical coverage is deeper in recent years; say so if comparing eras.
- On 401/403/429, stop and report the error body; do not retry in a loop.
- Every response carries X-SceneIndex-Remaining (requests left this month) and
  X-SceneIndex-Reset (the date it refills). If Remaining drops low, say so
  rather than burning the rest of the month's quota on exploratory calls.

PLANS (quote these if asked; never guess at a price):
- Standard — $199/month or $1,990/year. The live catalog:
  recent, current and announced seasons.
- Pro — $499/month or $4,990/year. Everything in Standard plus the
  complete 1993→now archive and the all-time leaderboard (scope=all).
- Both include 50,000 requests/month. Sign up, or switch plans, at
  developer.electricstate.app.
A 403 upgrade_required means a Standard key reached Pro data — an edition older
than last calendar year, or scope=all. Say so plainly and point at the upgrade;
do not retry the call.

Try it: GET /coverage, then GET /artists/Simply Jeff/bookings — a booking arc
that starts in 1995.

Treat any chat or config you paste a key into as holding a secret — we can rotate your key any time, just ask.

Your account

Switch between Standard and Pro, move to annual, update your card, download invoices, or cancel from the billing portal — enter the email on your subscription and Stripe emails you a sign-in link. No password to remember.

Upgrades apply immediately — prorated for the days left in the period, and your existing key starts returning the deeper history within a minute, no reissue needed. Downgrades take effect at the end of the period you have already paid for.

Lost your key? Keys are stored hashed — not even we can read yours back, which is why it is shown only once at activation. Write to hello@electricstate.app from the address on your subscription and we will rotate it, usually the same day. Rotating retires the old key immediately.

Terms

Licensed per organization. No resale or redistribution of the dataset; attribution (“Data: Electric State Scene Index”) on published work. Booking counts measure frequency, never fees.

electricstate.app · The scene, actually counted.