Authentication

All /v1/ endpoints require an API key. JWT session tokens (used by the web app) are not accepted on the v1 API.

Getting Your API Key

  1. Sign in to your AIvsRank account
  2. Navigate to Profile → API Keys
  3. Click Generate New Key
  4. Copy the key immediately — it is only shown once

Keys use the prefix gly_ to distinguish them from other credentials.

Using Your API Key

Pass the key in the Authorization header using the Bearer scheme:

curl https://api.aivsrank.com/v1/credits/balance \
  -H "Authorization: Bearer gly_your_key_here"

Scopes

Each API key is issued with one or more scopes. A request missing the required scope returns 403.

Scope Access
brand:read Read legacy brand visibility records
leaderboard:read Read leaderboard data
credit:read Read credit balance

Error Responses

Code Reason
401 Missing or invalid API key
403 Key is valid but lacks the required scope 
{
  "code": 401,
  "message": "Unauthorized",
  "data": null,
  "success": false,
  "timestamp": 1710154200000
}

Revoking a Key

Go to Profile → API Keys and click Revoke. The key stops working immediately.

Previous Overview Next Leaderboard