Soccer API Tech Docs

Soccer API Leaderboard: Assists

Leaderboard: Assists endpoint provides the top assist makers of the tournaments.

Soccer Leaderboard: Assists 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": "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": 1, "matchesPlayed": 29, "totalAssists": 13, "assistsPerMatch": 0.45 }, { "player": { "country": { "name": "Portugal", "shortName": "PRT", "id": 15 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Ricardo Quaresma", "knownNameMedium": "R.Quaresma", "knownNameShort": "Quaresma", "id": 861 }, "team": { "name": "Besiktas", "shortName": "BJK", "mediumName": "Beşiktaş", "id": 3 }, "matchesStarted": 18, "minutesPlayed": 1579, "position": 2, "matchesPlayed": 21, "totalAssists": 11, "assistsPerMatch": 0.52 }, { "player": { "country": { "name": "Turkey", "shortName": "TR", "id": 1 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Emrah Başsan", "knownNameMedium": "Emrah", "knownNameShort": "Emrah", "id": 38358 }, "team": { "name": "B.S.B Erzurum ", "shortName": "BSBE", "mediumName": "B.S.B Erzurum", "id": 15659 }, "matchesStarted": 21, "minutesPlayed": 1957, "position": 3, "matchesPlayed": 27, "totalAssists": 10, "assistsPerMatch": 0.37 }, { "player": { "country": { "name": "Egypt", "shortName": "EGY", "id": 31 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Trezeguet", "knownNameMedium": "Trezeguet", "knownNameShort": "Trezeguet", "id": 104772 }, "team": { "name": "Kasimpasa", "shortName": "KSM", "mediumName": "Kasımpaşa", "id": 90 }, "matchesStarted": 29, "minutesPlayed": 2606, "position": 4, "matchesPlayed": 29, "totalAssists": 8, "assistsPerMatch": 0.28 }, { "player": { "country": { "name": "Morocco", "shortName": "MAR", "id": 46 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Younes Belhanda", "knownNameMedium": "Y.Belhanda", "knownNameShort": "Belhanda", "id": 36629 }, "team": { "name": "Galatasaray", "shortName": "GS", "mediumName": "Galatasaray", "id": 1 }, "matchesStarted": 20, "minutesPlayed": 1661, "position": 5, "matchesPlayed": 21, "totalAssists": 7, "assistsPerMatch": 0.33 }, { "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": 6, "matchesPlayed": 22, "totalAssists": 7, "assistsPerMatch": 0.32 }, { "player": { "country": { "name": "Serbia", "shortName": "SRB", "id": 21 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Adem Ljajic", "knownNameMedium": "A.Ljajic", "knownNameShort": "Ljajic", "id": 40310 }, "team": { "name": "Besiktas", "shortName": "BJK", "mediumName": "Beşiktaş", "id": 3 }, "matchesStarted": 20, "minutesPlayed": 1781, "position": 7, "matchesPlayed": 22, "totalAssists": 7, "assistsPerMatch": 0.32 }, { "player": { "country": { "name": "Brazil", "shortName": "BRE", "id": 45 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Guilherme Marques", "knownNameMedium": "G.Marques", "knownNameShort": "Marques", "id": 47148 }, "team": { "name": "Yeni Malatyaspor", "shortName": "YMS", "mediumName": "Y.Malatyaspor", "id": 105 }, "matchesStarted": 24, "minutesPlayed": 2025, "position": 8, "matchesPlayed": 26, "totalAssists": 7, "assistsPerMatch": 0.27 }, { "player": { "country": { "name": "Brazil", "shortName": "BRE", "id": 45 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Douglas", "knownNameMedium": "Douglas", "knownNameShort": "Douglas", "id": 37424 }, "team": { "name": "Sivasspor", "shortName": "SVS", "mediumName": "Sivasspor ", "id": 129 }, "matchesStarted": 27, "minutesPlayed": 2418, "position": 9, "matchesPlayed": 27, "totalAssists": 7, "assistsPerMatch": 0.26 }, { "player": { "country": { "name": "Turkey", "shortName": "TR", "id": 1 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Efecan Karaca", "knownNameMedium": "Efecan", "knownNameShort": "Efecan", "id": 24329 }, "team": { "name": "Alanyaspor", "shortName": "ALNY", "mediumName": "Alanyaspor", "id": 13 }, "matchesStarted": 28, "minutesPlayed": 2362, "position": 10, "matchesPlayed": 29, "totalAssists": 7, "assistsPerMatch": 0.24 } ]

sample - 1: Turkish Super League

[ { "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": 1, "matchesPlayed": 34, "totalAssists": 13, "assistsPerMatch": 0.38 }, { "player": { "country": { "name": "Denmark", "shortName": "DEN", "id": 10 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Christian Eriksen", "knownNameMedium": "C.Eriksen", "knownNameShort": "Eriksen", "id": 44225 }, "team": { "name": "Tottenham Hotspur", "shortName": "TOT", "mediumName": "Tottenham", "id": 373 }, "matchesStarted": 27, "minutesPlayed": 2501, "position": 2, "matchesPlayed": 32, "totalAssists": 12, "assistsPerMatch": 0.38 }, { "player": { "country": { "name": "Scotland", "shortName": "SCO", "id": 17 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Ryan Fraser", "knownNameMedium": "R.Fraser", "knownNameShort": "Fraser", "id": 74954 }, "team": { "name": "AFC Bournemouth", "shortName": "BOUR", "mediumName": "AFC Bournemouth", "id": 176 }, "matchesStarted": 33, "minutesPlayed": 2926, "position": 3, "matchesPlayed": 35, "totalAssists": 11, "assistsPerMatch": 0.31 }, { "player": { "country": { "name": "Germany", "shortName": "GER", "id": 8 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Leroy Sane", "knownNameMedium": "L.Sane", "knownNameShort": "Sane", "id": 115202 }, "team": { "name": "Manchester City", "shortName": "MCFC", "mediumName": "Man. City", "id": 269 }, "matchesStarted": 20, "minutesPlayed": 1731, "position": 4, "matchesPlayed": 28, "totalAssists": 10, "assistsPerMatch": 0.36 }, { "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": 5, "matchesPlayed": 31, "totalAssists": 9, "assistsPerMatch": 0.29 }, { "player": { "country": { "name": "Scotland", "shortName": "SCO", "id": 17 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Andrew Robertson", "knownNameMedium": "A.Robertson", "knownNameShort": "Robertson", "id": 98402 }, "team": { "name": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "matchesStarted": 33, "minutesPlayed": 2955, "position": 6, "matchesPlayed": 33, "totalAssists": 9, "assistsPerMatch": 0.27 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Trent Alexander-Arnold", "knownNameMedium": "T.Arnold", "knownNameShort": "Arnold", "id": 184110 }, "team": { "name": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "matchesStarted": 24, "minutesPlayed": 2199, "position": 7, "matchesPlayed": 26, "totalAssists": 8, "assistsPerMatch": 0.31 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Callum Wilson", "knownNameMedium": "C.Wilson", "knownNameShort": "Wilson", "id": 36150 }, "team": { "name": "AFC Bournemouth", "shortName": "BOUR", "mediumName": "AFC Bournemouth", "id": 176 }, "matchesStarted": 26, "minutesPlayed": 2265, "position": 8, "matchesPlayed": 27, "totalAssists": 8, "assistsPerMatch": 0.3 }, { "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": 9, "matchesPlayed": 29, "totalAssists": 8, "assistsPerMatch": 0.28 }, { "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": 10, "matchesPlayed": 30, "totalAssists": 8, "assistsPerMatch": 0.27 } ]

sample - 2: English Premier League

Response Output Definitions

leaderboard

Data

Type

Example

Description

matchesStarted

INT

The starting eleven count of the player

minutesPlayed

INT

1026

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 assists count of the player

assistsPerMatch

INT

0.5

The assists per match ratio of the player

player

Data

Type

Example

Description

knownName

STR

Ryan Fraser

The known name of the player

knownNameMedium

STR

R. Fraser

The medium known name of the player

knownNameShort

STR

Fraser

The short known name of the player

INT

74954

The id of the player

country

Data	Type	Example	Description
name	STR	Scotland	The name of the country
shortName	STR	SCO	The short name of the country
id	INT	17	The id of the country

position

Data	Type	Example	Description
name	STR	Midfielder	The name of the position
shortName	STR	MF	The short name of the position
id	INT	3	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

Soccer API Leaderboard: Assists

Soccer Leaderboard: Assists Request URL

References / Dependencies

Call Rate / Interval

Request Headers

Request Parameters

Response Output

Response Output Definitions

leaderboard

player

country

position

team