Developers
The WhatSphere demographic dataset as a free public beta API.
WhatSphere scores every title on audience demographics, cast composition, adaptation faithfulness, and advocacy signals. The same data behind this site is available as a read-only JSON API. Sign up below for a free beta key — no billing, no card. We just ask what you're building so we can shape the paid tiers later.
Authentication
Send your key on every request as either an X-API-Key header or an Authorization: Bearer token.
curl -H "X-API-Key: wsk_beta_…" \ "https://whatsphere.com/api/v1/spheres/titles?limit=5" # or curl -H "Authorization: Bearer wsk_beta_…" \ "https://whatsphere.com/api/v1/spheres/search?q=dune"
Check your key's status and usage any time:
curl -H "X-API-Key: wsk_beta_…" "https://whatsphere.com/api/v1/spheres/dev/me"
Rate limits
Beta keys are limited to 60 requests per minute. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset; over-limit requests get a 429 with Retry-After. Responses are JSON in a { "data": … } envelope; lists add a pagination cursor.
Endpoints
All endpoints are read-only GET requests under https://whatsphere.com/api/v1/spheres. Submission endpoints (reviews, corrections) and moderation tools are first-party only and not part of the public API.
Beta terms
- Free public beta — no SLA, no uptime or availability guarantee.
- Attribute “WhatSphere (whatsphere.com)” wherever you display the data.
- The data is for informational use. Don't resell it wholesale or imply endorsement.
- Keys may be rate-limited, rotated, or revoked at any time. Paid tiers with higher limits will follow.