Leaderboard

Query AI search visibility rankings by industry. Each industry contains per-engine rankings updated on a scheduled basis.

Required scope: leaderboard:read

List Industries

GET /v1/leaderboard/industries

Returns all active industries available in the leaderboard.

Example Request

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

Response

{
  "code": 200,
  "message": "Success",
  "data": [
    {
      "id": 1,
      "nameCn": "AI 工具",
      "nameEn": "AI Tools",
      "description": "AI productivity and search tools",
      "brandCount": 24
    }
  ],
  "success": true,
  "timestamp": 1710154200000
}

Response Fields

Field Type Description
id long Industry ID
nameCn string Chinese name
nameEn string English name
description string Industry description
brandCount long Number of tracked brands

Get Industry Detail

GET /v1/leaderboard/industries/{id}

Returns the latest rankings for each active AI engine within an industry.

Path Parameters

Parameter Type Description
id long Industry ID

Example Request

curl https://api.aivsrank.com/v1/leaderboard/industries/1 \
  -H "Authorization: Bearer gly_your_key_here"

Response

{
  "code": 200,
  "message": "Success",
  "data": {
    "id": 1,
    "nameCn": "AI 工具",
    "nameEn": "AI Tools",
    "description": "AI productivity and search tools",
    "brandCount": 24,
    "engines": [
      { "id": 1, "code": "chatgpt", "displayName": "ChatGPT" },
      { "id": 2, "code": "claude", "displayName": "Claude" }
    ],
    "latestRuns": [
      {
        "engineConfigId": 1,
        "engineDisplayName": "ChatGPT",
        "runDate": "2026-03-12T00:00:00",
        "brandCount": 20,
        "rankings": [
          {
            "rank": 1,
            "brandName": "AIvsRank",
            "compositeIndex": 87.50,
            "mentionRate": 92.00
          }
        ]
      }
    ]
  },
  "success": true,
  "timestamp": 1710154200000
}

Response Fields — latestRuns[].rankings[]

Field Type Description
rank integer Position in this engine's ranking
brandName string Brand name
compositeIndex decimal Composite visibility score
mentionRate decimal Mention rate (%)

Get Trend Data

GET /v1/leaderboard/industries/{id}/trend?engineConfigId={engineId}&limit={n}

Returns historical run data for a specific industry and engine, ordered from oldest to newest.

Path & Query Parameters

Parameter In Type Required Description
id path long Yes Industry ID
engineConfigId query long Yes Engine config ID (from industry detail)
limit query integer No Number of historical data points, default 10, max 50

Example Request

curl "https://api.aivsrank.com/v1/leaderboard/industries/1/trend?engineConfigId=1&limit=5" \
  -H "Authorization: Bearer gly_your_key_here"

Response

{
  "code": 200,
  "message": "Success",
  "data": {
    "engineDisplayName": "ChatGPT",
    "dataPoints": [
      {
        "runDate": "2026-03-08T00:00:00",
        "brands": [
          { "brandName": "AIvsRank", "compositeIndex": 84.20, "mentionRate": 88.00 }
        ]
      },
      {
        "runDate": "2026-03-12T00:00:00",
        "brands": [
          { "brandName": "AIvsRank", "compositeIndex": 87.50, "mentionRate": 92.00 }
        ]
      }
    ]
  },
  "success": true,
  "timestamp": 1710154200000
}

Error Responses

Code Description
403 Missing leaderboard:read scope
404 Industry not found
Previous Authentication Next Legacy Credits API