English 
Tiếng Việt 
ภาษาไทย Top Scorer
Update Time: 2026-06-29 15:44
Introduction
• This API endpoint returns top scorer statistics for a specified league or cup, including goals broken down by home, away, and penalty.
• Coverage is limited to selected major leagues and cups.
• By using endpoint League & Cup Profile (Basic)
, you can get basic information of leagues and cups.
Related Plans
You can use this api by subscribing plans: Stats.
Request
- Path: /sport/football/topscorer
- Method: GET
- Calls: This interface is limited to 10 seconds/call;
- Recommend Calls: 1 day/call
- Parameters:
| Parameter | Value | Required | Description |
|---|---|---|---|
| leagueId | string | true | League or cup ID to retrieve top scorer data for. |
| season | string | false | Season to retrieve data for (e.g., 2025, 2025-2026). Must be used together with leagueId. If omitted, returns current season data. |
Response
| Parameter | Value | Description |
|---|---|---|
| playerId | string | |
| playerName | string | Player's full name |
| teamId | string | |
| teamName | string | Team name |
| country | string | Player's nationality (e.g., Paraguay, Argentina) |
| goalsCount | int | Total goals scored, including penalties |
| homeGoals | int | Goals scored in home matches, including penalties |
| awayGoals | int | Goals scored in away matches, including penalties |
| homePenalty | int | Penalty goals scored in home matches |
| awayPenalty | int | Penalty goals scored in away matches |
| matchNum | int | Total appearances. Null if not available for cup competitions. |
| subNum | int | Substitute appearances. Null if not available for cup competitions. |
Example Request
