Soccer API Tech Docs

Search in tech docs

Soccer API Leaderboard: Goals

Leaderboard: Goals endpoint provides the top scorers of the tournaments.

Soccer Leaderboard: Goals Request URL

GET

References / Dependencies

Tournament ID The id of the tournament. You can find list of tournament from Tournament List endpoint

Teams Informations The informations of teams in the tournament. You can find list of the teams from Tournament Teams endpoint

Call Rate / Interval

Recommended API Call Interval: 1 Request / Hour Daily Max API Call: 96 Request

Request Headers

Data	Type	O / R	Example	Description
languageId	INT	R	{languageId}	The id of the language that you select.
Ocp-Apim-Subscription-Key	STR	R	{yourOcp-Apim-Subscription-Key}	Your account key.
Accept	STR	O	application/xml	Selection of data presentation type as XML/JSON.

^*O= Optional, R= Required

Request Parameters

Data	Type	O / R	Example	Description
tournamentId	INT	R	{tournamentId}	The id of the tournament.

Response Output

[ { "player": { "country": { "name": "Ivory Coast", "shortName": "CIV", "id": 103 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Mbaye Diagne", "knownNameMedium": "M.Diagne", "knownNameShort": "Diagne", "id": 121885 }, "team": { "name": "Galatasaray", "shortName": "GS", "mediumName": "Galatasaray", "id": 1 }, "matchesStarted": 24, "minutesPlayed": 2169, "position": 1, "matchesPlayed": 25, "totalGoals": 28, "goalsPerMatch": 1.12, "penaltyGoals": 11, "penaltyGoalsPerMatch": 0.44 }, { "player": { "country": { "name": "Turkey", "shortName": "TR", "id": 1 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Burak Yılmaz", "knownNameMedium": "Burak", "knownNameShort": "Burak", "id": 23237 }, "team": { "name": "Besiktas", "shortName": "BJK", "mediumName": "Beşiktaş", "id": 3 }, "matchesStarted": 17, "minutesPlayed": 1459, "position": 2, "matchesPlayed": 18, "totalGoals": 14, "goalsPerMatch": 0.78, "penaltyGoals": 3, "penaltyGoalsPerMatch": 0.18 }, { "player": { "country": { "name": "Senegal", "shortName": "SEN", "id": 98 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Papiss Cisse", "knownNameMedium": "P.Cisse", "knownNameShort": "Cisse", "id": 5390 }, "team": { "name": "Alanyaspor", "shortName": "ALNY", "mediumName": "Alanyaspor", "id": 13 }, "matchesStarted": 20, "minutesPlayed": 1811, "position": 3, "matchesPlayed": 21, "totalGoals": 13, "goalsPerMatch": 0.62 }, { "player": { "country": { "name": "Colombia", "shortName": "COL", "id": 71 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Hugo Rodallega", "knownNameMedium": "H.Rodallega", "knownNameShort": "Rodallega", "id": 417 }, "team": { "name": "Trabzonspor", "shortName": "TS", "mediumName": "Trabzonspor", "id": 139 }, "matchesStarted": 25, "minutesPlayed": 2258, "position": 4, "matchesPlayed": 28, "totalGoals": 13, "goalsPerMatch": 0.46, "penaltyGoals": 2, "penaltyGoalsPerMatch": 0.07 }, { "player": { "country": { "name": "Kosovo", "shortName": "KSV", "id": 242 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Vedat Muriqi", "knownNameMedium": "V.Muriqi", "knownNameShort": "Muriqi", "id": 107971 }, "team": { "name": "Caykur Rizespor", "shortName": "CRZ", "mediumName": "C.Rizespor", "id": 46 }, "matchesStarted": 29, "minutesPlayed": 2576, "position": 5, "matchesPlayed": 29, "totalGoals": 13, "goalsPerMatch": 0.45, "penaltyGoals": 1, "penaltyGoalsPerMatch": 0.03 }, { "player": { "country": { "name": "Nigeria", "shortName": "NGA", "id": 30 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Henry Onyekuru", "knownNameMedium": "H.Onyekuru", "knownNameShort": "Onyekuru", "id": 183984 }, "team": { "name": "Galatasaray", "shortName": "GS", "mediumName": "Galatasaray", "id": 1 }, "matchesStarted": 24, "minutesPlayed": 2132, "position": 6, "matchesPlayed": 26, "totalGoals": 12, "goalsPerMatch": 0.46 }, { "player": { "country": { "name": "Bosnia and Herzegovina", "shortName": "B&H", "id": 64 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Edin Visca", "knownNameMedium": "E.Visca", "knownNameShort": "Visca", "id": 54543 }, "team": { "name": "Medipol Basaksehir", "shortName": "IBFK", "mediumName": "Basaksehir", "id": 82 }, "matchesStarted": 29, "minutesPlayed": 2599, "position": 7, "matchesPlayed": 29, "totalGoals": 12, "goalsPerMatch": 0.41, "penaltyGoals": 2, "penaltyGoalsPerMatch": 0.07 }, { "player": { "country": { "name": "Brazil", "shortName": "BRE", "id": 45 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Robinho", "knownNameMedium": "Robinho", "knownNameShort": "Robinho", "id": 497 }, "team": { "name": "Medipol Basaksehir", "shortName": "IBFK", "mediumName": "Basaksehir", "id": 82 }, "matchesStarted": 28, "minutesPlayed": 2475, "position": 8, "matchesPlayed": 28, "totalGoals": 11, "goalsPerMatch": 0.39, "penaltyGoals": 1, "penaltyGoalsPerMatch": 0.04 }, { "player": { "country": { "name": "Nigeria", "shortName": "NGA", "id": 30 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Anthony Nwakaeme", "knownNameMedium": "A.Nwakaeme", "knownNameShort": "Nwakaeme", "id": 78611 }, "team": { "name": "Trabzonspor", "shortName": "TS", "mediumName": "Trabzonspor", "id": 139 }, "matchesStarted": 20, "minutesPlayed": 1771, "position": 9, "matchesPlayed": 22, "totalGoals": 10, "goalsPerMatch": 0.45 }, { "player": { "country": { "name": "France", "shortName": "FRA", "id": 9 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Souleymane Doukara", "knownNameMedium": "S.Doukara", "knownNameShort": "Doukara", "id": 97368 }, "team": { "name": "Antalyaspor", "shortName": "ANT", "mediumName": "Antalyaspor", "id": 21 }, "matchesStarted": 20, "minutesPlayed": 1836, "position": 10, "matchesPlayed": 22, "totalGoals": 10, "goalsPerMatch": 0.45, "penaltyGoals": 3, "penaltyGoalsPerMatch": 0.14 } ]

sample - 1: Turkish Super League

[ { "player": { "country": { "name": "Argentina", "shortName": "ARG", "id": 43 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Sergio Agüero", "knownNameMedium": "S.Agüero", "knownNameShort": "Agüero", "id": 970 }, "team": { "name": "Manchester City", "shortName": "MCFC", "mediumName": "Man. City", "id": 269 }, "matchesStarted": 27, "minutesPlayed": 2129, "position": 1, "matchesPlayed": 29, "totalGoals": 19, "goalsPerMatch": 0.66, "penaltyGoals": 2, "penaltyGoalsPerMatch": 0.07 }, { "player": { "country": { "name": "Gabon", "shortName": "GAB", "id": 142 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Pierre Aubameyang", "knownNameMedium": "Aubameyang", "knownNameShort": "Aubameyang", "id": 1430 }, "team": { "name": "Arsenal", "shortName": "ARS", "mediumName": "Arsenal", "id": 157 }, "matchesStarted": 27, "minutesPlayed": 2461, "position": 2, "matchesPlayed": 33, "totalGoals": 19, "goalsPerMatch": 0.58, "penaltyGoals": 3, "penaltyGoalsPerMatch": 0.09 }, { "player": { "country": { "name": "Egypt", "shortName": "EGY", "id": 31 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Mohamed Salah", "knownNameMedium": "M.Salah", "knownNameShort": "Salah", "id": 85159 }, "team": { "name": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "matchesStarted": 34, "minutesPlayed": 3007, "position": 3, "matchesPlayed": 35, "totalGoals": 19, "goalsPerMatch": 0.54, "penaltyGoals": 3, "penaltyGoalsPerMatch": 0.09 }, { "player": { "country": { "name": "Senegal", "shortName": "SEN", "id": 98 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Sadio Mane", "knownNameMedium": "S.Mane", "knownNameShort": "Mane", "id": 90877 }, "team": { "name": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "matchesStarted": 32, "minutesPlayed": 2817, "position": 4, "matchesPlayed": 33, "totalGoals": 18, "goalsPerMatch": 0.55 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Harry Kane", "knownNameMedium": "H.Kane", "knownNameShort": "Kane", "id": 45353 }, "team": { "name": "Tottenham Hotspur", "shortName": "TOT", "mediumName": "Tottenham", "id": 373 }, "matchesStarted": 27, "minutesPlayed": 2427, "position": 5, "matchesPlayed": 28, "totalGoals": 17, "goalsPerMatch": 0.61, "penaltyGoals": 4, "penaltyGoalsPerMatch": 0.14 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Raheem Sterling", "knownNameMedium": "R.Sterling", "knownNameShort": "Sterling", "id": 82579 }, "team": { "name": "Manchester City", "shortName": "MCFC", "mediumName": "Man. City", "id": 269 }, "matchesStarted": 27, "minutesPlayed": 2418, "position": 6, "matchesPlayed": 30, "totalGoals": 17, "goalsPerMatch": 0.57 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Jamie Vardy", "knownNameMedium": "J.Vardy", "knownNameShort": "Vardy", "id": 86745 }, "team": { "name": "Leicester City", "shortName": "LEIC", "mediumName": "Leicester", "id": 260 }, "matchesStarted": 27, "minutesPlayed": 2490, "position": 7, "matchesPlayed": 31, "totalGoals": 16, "goalsPerMatch": 0.52, "penaltyGoals": 4, "penaltyGoalsPerMatch": 0.13 }, { "player": { "country": { "name": "Belgium", "shortName": "BEL", "id": 16 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Eden Hazard", "knownNameMedium": "E.Hazard", "knownNameShort": "Hazard", "id": 1421 }, "team": { "name": "Chelsea", "shortName": "CHE", "mediumName": "Chelsea", "id": 200 }, "matchesStarted": 30, "minutesPlayed": 2725, "position": 8, "matchesPlayed": 34, "totalGoals": 16, "goalsPerMatch": 0.47, "penaltyGoals": 4, "penaltyGoalsPerMatch": 0.12 }, { "player": { "country": { "name": "France", "shortName": "FRA", "id": 9 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Paul Pogba", "knownNameMedium": "P.Pogba", "knownNameShort": "Pogba", "id": 55151 }, "team": { "name": "Manchester United", "shortName": "MANU", "mediumName": "Man United", "id": 4 }, "matchesStarted": 30, "minutesPlayed": 2650, "position": 9, "matchesPlayed": 31, "totalGoals": 13, "goalsPerMatch": 0.42, "penaltyGoals": 7, "penaltyGoalsPerMatch": 0.23 }, { "player": { "country": { "name": "France", "shortName": "FRA", "id": 9 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Alexandre Lacazette", "knownNameMedium": "A.Lacazette", "knownNameShort": "Lacazette", "id": 51613 }, "team": { "name": "Arsenal", "shortName": "ARS", "mediumName": "Arsenal", "id": 157 }, "matchesStarted": 24, "minutesPlayed": 2244, "position": 10, "matchesPlayed": 32, "totalGoals": 13, "goalsPerMatch": 0.41 } ]

sample - 2: English Premier League

Response Output Definitions

leaderboard

Data

Type

Example

Description

matchesStarted

INT

The starting eleven count of the player

minutesPlayed

INT

882

The total minutes of the player

position

INT

The position of the player in the table

matchesPlayed

INT

The total match count of the player

totalGoals

INT

The total goals count of the player

penaltyGoals

INT

The penalty goals count of the player

goalsPerMatch

INT

0.67

The goals per match ratio of the player

penaltyGoalsPerMatch

INT

0.5

The penalty goals per match ratio of the player

player

Data

Type

Example

Description

knownName

STR

Sergio Agüero

The known name of the player

knownNameMedium

STR

S. Agüero

The medium known name of the player

knownNameShort

STR

Agüero

The short known name of the player

INT

970

The id of the player

country

Data	Type	Example	Description
name	STR	Argentina	The name of the country
shortName	STR	ARG	The short name of the country
id	INT	43	The id of the country

position

Data	Type	Example	Description
name	STR	Attacker	The name of the position
shortName	STR	FW	The short name of the position
id	INT	4	The id of the position

team

Data	Type	Example	Description
name	STR	AFC Bournemouth	The name of the team
shortName	STR	BOUR	The short name of the team
mediumName	STR	Bournemouth	The short name of the team
id	INT	176	The id of the team

Soccer API Tech Docs

Tech Docs Index

Documentation+

Widgets+

Lookups+

Global API+

Soccer API+

Basketball API+

Football API+

Baseball API+

Ice Hockey API+

Volleyball API+

Handball API+

Table Tennis API+

Tennis API+

Soccer API Leaderboard: Goals

Soccer Leaderboard: Goals Request URL

References / Dependencies

Call Rate / Interval

Request Headers

Request Parameters

Response Output

Response Output Definitions

leaderboard

player

country

position

team