Skip to content
Get a key
API reference / Standings
GET/soccer/leagues/{id}/top-scorers

Get league top scorers

Returns a soccer league's top scorers (kind=goals, with penalty goals), most assists (assists) or most cards (cards, yellow and red), best first, up to 50 players. Read about 3 hours after each matchday, at most daily, and weekly. 404 for leagues without a list.

In the plans that cover this sportPay per call without a key: $0.002 in USDC

Parameters

  • idinteger · pathrequired

    League ID

  • kindstring · query

    goals (default), assists or cards

    One of: goals, assists, cards
  • limitinteger · query

    Players (1-50, default 50)

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

  • dataobject
  • kindstring
  • league_idinteger
  • playersarray of object
  • assistsinteger
  • goalsinteger
  • penalty_goalsinteger
  • player_idinteger
  • player_namestring
  • positioninteger
  • red_cardsinteger
  • team_idinteger
  • team_namestring
  • yellow_cardsinteger
  • seasonstring
  • updated_atstring

    when the list last changed

  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

    Attribution a data source's licence asks for (Cricsheet's history).

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
400INVALID_PARAMA parameter is missing or wrong, and the message names it. Fix the request; do not retry it.
401UNAUTHORIZEDThe key is missing, mistyped or was rotated.
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
403FORBIDDENThe sport or feature is not in your plan (FEATURE_NOT_IN_PLAN for Insights and other plan features).
404NOT_FOUNDNo record with that id.

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?