Skip to main content
GET
/
leaderboard
Get leaderboard
curl --request GET \
  --url https://frozi.lol/api/leaderboard \
  --header 'Authorization: Bearer <token>'
{
  "topProfiles": [
    {
      "username": "<string>",
      "displayName": "<string>",
      "viewsCount": 123,
      "badges": [
        {
          "name": "<string>"
        }
      ],
      "assets": {
        "pfp": "<string>"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.frozi.lol/llms.txt

Use this file to discover all available pages before exploring further.

Returns top profiles by view count. Requires permission api.leaderboard. Data may be cached (e.g. Redis). Non-cache errors return 500 with { "error": "Failed to fetch leaderboard" }. Only badges with name === "verified" or name === "team" are included. assets.pfp is null for the default avatar.

Authorizations

​
Authorization
string
header
required

API key from Dashboard → Developer Platform → API Keys. Send as: Authorization: Bearer <API_KEY>

Query Parameters

​
limit
integer
default:100

Max number of profiles to return (1–100). Default 100.

Required range: 1 <= x <= 100

Response

Leaderboard response

​
topProfiles
object[]