Home
Get your API key
Getting started

Authentication

Every request authenticates with two headers: a Client ID and a Token.

Your Client ID is permanently bound to your account and never changes. Your Token can be rotated at any time for security — find and regenerate both on your token page.

HeaderDescription
Client-IDAccount identifier. Fixed for the life of your account.
TokenSecret access key. Rotatable from the token page.
REQUESTCURL
curl -X GET https://streamscharts.com/api/v2/channels/shroud?platform=twitch \
  -H 'Client-ID: XXXXXXXXXXXX' \
  -H 'Token: YYYYYYYYYYYYYY'
Keep your Token secret

Treat the Token like a password. Never expose it in client-side code, public repositories, or browser requests. If a Token leaks, rotate it immediately from the token page — your Client ID stays the same.

An invalid or missing credential returns 401 invalid_credentials. See Errors for the full list.