The Creator ScoreCard Data API provides programmatic access to the channel intelligence database, report snapshots, and aggregate statistics. Use it to power dashboards, calculators, research tools, and any application that needs YouTube creator data.
Bearer token via Authorization header
Per-key limits (configurable per key)
channels:read, reports:read, stats:read
All API requests require a valid API key passed in the Authorization header:
Authorization: Bearer csk_your_api_key_hereAPI keys are created from the Admin Panel under the Data API tab. Each key has configurable scopes, rate limits, and optional expiration. The full key is shown only once at creation — store it securely.
Security: API keys are stored as SHA-256 hashes. If a key is compromised, revoke it immediately from the Admin Panel and create a new one.
Each API key has per-minute and per-day rate limits. When exceeded, the API returns 429 Too Many Requests with a Retry-After header.
| Header | Description |
|---|---|
| X-RateLimit-Limit | Requests allowed per minute |
| X-RateLimit-Remaining | Remaining requests this minute |
| Retry-After | Seconds to wait before retrying (on 429) |
| Status | Meaning | Resolution |
|---|---|---|
| 401 | Missing or invalid API key | Check your Authorization header |
| 403 | Insufficient scope or key revoked/expired | Check key scopes and status in Admin Panel |
| 404 | Resource not found | Verify the channel hash or report key |
| 429 | Rate limit exceeded | Wait for Retry-After seconds, then retry |
| 500 | Internal server error | Retry after a moment; report if persistent |