← Back to API docs

GET/api/v1/scorers/leagues

Competitions that have a top scorers list
Statistics packageactivebetacoreAvailable (scoped)

Access

Request
GET https://api.sports.csap.ai/api/v1/scorers/leagues
Auth
Header X-API-Key: <your key> (Authorization: Bearer <key> also works; ?key= is still accepted but discouraged, because the key ends up in URLs and logs)
External keys
Available (scoped)External keys can call it, but only data inside the open scope is returned.
Rate limits
3000 per minute · 200000 per day · Set per key (rate_per_min and quota_daily returned by /api/v1/account are authoritative; the numbers above are a trial key's). Beyond them the answer is 429. In addition, heavy requests such as whole-table snapshots and statistics lists without a match id are processed 2 at a time for the whole platform; a request that cannot get a slot receives 429 with Retry-After. Responses do not carry X-RateLimit-* headers for now. See the general guide

Request parameters 1

ParameterTyperequiredExampleDescription
limitintegeroptional2Number of rows

Example request

curl "https://api.sports.csap.ai/api/v1/scorers/leagues?limit=2" \
  -H "X-API-Key: YOUR_API_KEY"

Try it

Example response

Real response with an external key at 09/11/2026, 14:29 UTC: HTTP 200, 53 rows, 129 ms (data cut to 2 rows)

{
  "code": 0,
  "data": [
    {
      "comp_id": "679",
      "gcid": 201,
      "n": 639,
      "name_zh": "欧联",
      "name": "UEFA Europa League"
    },
    {
      "comp_id": "7",
      "gcid": 138,
      "n": 601,
      "name_zh": "欧冠",
      "name": "UEFA Champions League"
    }
  ],
  "message": "success",
  "success": true
}

Response fields 5

comp_idstringCompetition idExample: "679"
gcidintegerPlatform competition idExample: 201
nintegerExample: 639
name_enstringEnglish nameExample: "UEFA Europa League"
name_zhstringChinese nameExample: "欧联"

Errors

HTTPmessageWhen
401missing API key / unauthorizedNo X-API-Key, or the key is invalid or disabled
429rate limit exceeded / daily quota exceededThe key's per-minute rate or daily quota is exceeded
429server busy, retry laterThe server's concurrency slots are full (only 2 heavy requests at a time); retry after Retry-After seconds
500query errorThe query failed on the server; you may retry