sports

Domestic-league top scorers (season aggregates)

Per-league leaderboard sourced from our soccer_player_season_stats (season aggregates), summing a player across their team rows in the season. Flat data[] shape: rank, id, player_name, team, goals, assists, minutes, matches (matches = season appearances). id is the BigBalls player id (uuid), stable across seasons and joinable to /v1/players/{id}, so a consumer never has to match on player name. It is null for a leader we have not yet bridged to a player row (19 of the current La Liga top 20 resolve, measured 2026-09-14). headshot_url is a first-party asset URL on eligible plans and null otherwise. Supports a ?category sort and excludes players with a zero in the sorted category. Covers the big-five leagues. When season is omitted, this endpoint and /v1/leagues/{id}/xg-leaders select the newest season present in both datasets, so their defaults remain comparable. 5-minute Redis cache keyed by league+season+category+limit.

get/v1/leagues/{id}/top-scorers

Request

  • Base URL: https://api.bigballsdata.com
  • URL: https://api.bigballsdata.com/v1/leagues/{id}/top-scorers
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

id'epl' | 'laliga' | 'serie-a' | 'bundesliga' | 'ligue-1' required

League code (epl, laliga, serie-a, bundesliga, ligue-1) or its raw numeric league id (39, 140, 135, 78, 61).

Query parameters

category'goals' | 'assists' | 'minutes' | 'matches'

Sort metric. Defaults to goals.

seasoninteger

Season label: the year the campaign starts. If omitted, uses the newest season also present on the sibling xG leaderboard. Pass explicitly when reproducing a historical result.

limitinteger

Number of leaders to return.

Response

ok

object required

Changes

No recorded changes to this operation across all 3 revisions of this API.