Soccer API Tech Docs

Search in 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": "Haris Hajradinovic", "knownNameMedium": "H.Hajradinovic", "knownNameShort": "Hajradinovic", "id": 102787 }, "team": { "name": "Kasimpasa", "shortName": "KSM", "mediumName": "Kasımpaşa", "id": 90 }, "matchesStarted": 22, "minutesPlayed": 1884, "position": 1, "matchesPlayed": 22, "totalAssists": 9, "assistsPerMatch": 0.41 }, { "player": { "country": { "name": "Poland", "shortName": "POL", "id": 42 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Sebastian Szymanski", "knownNameMedium": "S.Szymanski", "knownNameShort": "Szymanski", "id": 181961 }, "team": { "name": "Fenerbahce", "shortName": "FB", "mediumName": "Fenerbahce", "id": 2 }, "matchesStarted": 21, "minutesPlayed": 1773, "position": 2, "matchesPlayed": 22, "totalAssists": 8, "assistsPerMatch": 0.36 }, { "player": { "country": { "name": "Serbia", "shortName": "SRB", "id": 21 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Dusan Tadic", "knownNameMedium": "D.Tadic", "knownNameShort": "Tadic", "id": 35982 }, "team": { "name": "Fenerbahce", "shortName": "FB", "mediumName": "Fenerbahce", "id": 2 }, "matchesStarted": 21, "minutesPlayed": 1801, "position": 3, "matchesPlayed": 22, "totalAssists": 7, "assistsPerMatch": 0.32 }, { "player": { "country": { "name": "Turkey", "shortName": "TR", "id": 1 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Yusuf Sarı", "knownNameMedium": "Yusuf", "knownNameShort": "Yusuf", "id": 207200 }, "team": { "name": "Adana Demirspor", "shortName": "ADS", "mediumName": "Adana Demir.", "id": 6 }, "matchesStarted": 15, "minutesPlayed": 1286, "position": 4, "matchesPlayed": 16, "totalAssists": 6, "assistsPerMatch": 0.38 }, { "player": { "country": { "name": "Norway", "shortName": "NOR", "id": 12 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Jonas Svensson", "knownNameMedium": "J.Svensson", "knownNameShort": "Svensson", "id": 52217 }, "team": { "name": "Besiktas", "shortName": "BJK", "mediumName": "Beşiktaş", "id": 3 }, "matchesStarted": 15, "minutesPlayed": 1279, "position": 5, "matchesPlayed": 15, "totalAssists": 5, "assistsPerMatch": 0.33 }, { "player": { "country": { "name": "Turkey", "shortName": "TR", "id": 1 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Abdülkadir Ömür", "knownNameMedium": "Abdülkadir", "knownNameShort": "Abdülkadir", "id": 167293 }, "team": { "name": "Trabzonspor", "shortName": "TS", "mediumName": "Trabzonspor", "id": 139 }, "matchesStarted": 14, "minutesPlayed": 1118, "position": 6, "matchesPlayed": 16, "totalAssists": 5, "assistsPerMatch": 0.31 }, { "player": { "country": { "name": "Argentina", "shortName": "ARG", "id": 43 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Mauro Icardi", "knownNameMedium": "M.Icardi", "knownNameShort": "Icardi", "id": 95017 }, "team": { "name": "Galatasaray", "shortName": "GS", "mediumName": "Galatasaray", "id": 1 }, "matchesStarted": 16, "minutesPlayed": 1516, "position": 7, "matchesPlayed": 19, "totalAssists": 5, "assistsPerMatch": 0.26 }, { "player": { "country": { "name": "Turkey", "shortName": "TR", "id": 1 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Oğuz Aydın", "knownNameMedium": "Oğuz", "knownNameShort": "Oğuz", "id": 214292 }, "team": { "name": "Alanyaspor", "shortName": "ALNY", "mediumName": "Alanyaspor", "id": 13 }, "matchesStarted": 15, "minutesPlayed": 1354, "position": 8, "matchesPlayed": 20, "totalAssists": 5, "assistsPerMatch": 0.25 }, { "player": { "country": { "name": "Turkey", "shortName": "TR", "id": 1 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Deniz Türüç", "knownNameMedium": "Deniz", "knownNameShort": "Deniz", "id": 96113 }, "team": { "name": "Basaksehir", "shortName": "IBFK", "mediumName": "Basaksehir", "id": 82 }, "matchesStarted": 17, "minutesPlayed": 1450, "position": 9, "matchesPlayed": 20, "totalAssists": 5, "assistsPerMatch": 0.25 }, { "player": { "country": { "name": "Turkey", "shortName": "TR", "id": 1 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "İrfan Can Kahveci", "knownNameMedium": "İrfan Can", "knownNameShort": "İrfan Can", "id": 93750 }, "team": { "name": "Fenerbahce", "shortName": "FB", "mediumName": "Fenerbahce", "id": 2 }, "matchesStarted": 16, "minutesPlayed": 1391, "position": 10, "matchesPlayed": 21, "totalAssists": 5, "assistsPerMatch": 0.24 } ]

sample - 1: Turkish Super League

[ { "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": 20, "minutesPlayed": 1744, "position": 1, "matchesPlayed": 20, "totalAssists": 8, "assistsPerMatch": 0.40 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Ollie Watkins", "knownNameMedium": "O.Watkins", "knownNameShort": "Watkins", "id": 137394 }, "team": { "name": "Aston Villa", "shortName": "AVL", "mediumName": "Aston Villa", "id": 158 }, "matchesStarted": 21, "minutesPlayed": 1852, "position": 2, "matchesPlayed": 21, "totalAssists": 8, "assistsPerMatch": 0.38 }, { "player": { "country": { "name": "Portugal", "shortName": "PRT", "id": 15 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Pedro Neto", "knownNameMedium": "P.Neto", "knownNameShort": "Neto", "id": 198607 }, "team": { "name": "Wolverhampton", "shortName": "WOL", "mediumName": "Wolves", "id": 388 }, "matchesStarted": 11, "minutesPlayed": 985, "position": 3, "matchesPlayed": 11, "totalAssists": 7, "assistsPerMatch": 0.64 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Kieran Trippier", "knownNameMedium": "K.Trippier", "knownNameShort": "Trippier", "id": 416 }, "team": { "name": "Newcastle United", "shortName": "NUFC", "mediumName": "Newcastle Utd.", "id": 277 }, "matchesStarted": 19, "minutesPlayed": 1665, "position": 4, "matchesPlayed": 19, "totalAssists": 7, "assistsPerMatch": 0.37 }, { "player": { "country": { "name": "Spain", "shortName": "ESP", "id": 3 }, "position": { "name": "Defender", "shortName": "DF", "id": 2 }, "knownName": "Pedro Porro", "knownNameMedium": "P.Porro", "knownNameShort": "Porro", "id": 212388 }, "team": { "name": "Tottenham Hotspur", "shortName": "TOT", "mediumName": "Tottenham", "id": 373 }, "matchesStarted": 20, "minutesPlayed": 1798, "position": 5, "matchesPlayed": 20, "totalAssists": 7, "assistsPerMatch": 0.35 }, { "player": { "country": { "name": "Germany", "shortName": "GER", "id": 8 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Pascal Gross", "knownNameMedium": "P.Gross", "knownNameShort": "Gross", "id": 2398 }, "team": { "name": "Brighton & Hove Albion", "shortName": "BHA", "mediumName": "Brighton", "id": 182 }, "matchesStarted": 18, "minutesPlayed": 1642, "position": 6, "matchesPlayed": 18, "totalAssists": 6, "assistsPerMatch": 0.33 }, { "player": { "country": { "name": "Uruguay", "shortName": "URU", "id": 72 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Darwin Nunez", "knownNameMedium": "D.Nunez", "knownNameShort": "Nunez", "id": 209768 }, "team": { "name": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "matchesStarted": 13, "minutesPlayed": 1208, "position": 7, "matchesPlayed": 20, "totalAssists": 6, "assistsPerMatch": 0.30 }, { "player": { "country": { "name": "Sweden", "shortName": "SWE", "id": 11 }, "position": { "name": "Attacker", "shortName": "FW", "id": 4 }, "knownName": "Anthony Elanga", "knownNameMedium": "A.Elanga", "knownNameShort": "Elanga", "id": 232057 }, "team": { "name": "Nottingham Forest", "shortName": "NOTF", "mediumName": "Nott. Forest", "id": 282 }, "matchesStarted": 14, "minutesPlayed": 1363, "position": 8, "matchesPlayed": 20, "totalAssists": 6, "assistsPerMatch": 0.30 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Phil Foden", "knownNameMedium": "P.Foden", "knownNameShort": "Foden", "id": 190883 }, "team": { "name": "Manchester City", "shortName": "MCFC", "mediumName": "Man. City", "id": 269 }, "matchesStarted": 18, "minutesPlayed": 1631, "position": 9, "matchesPlayed": 20, "totalAssists": 6, "assistsPerMatch": 0.30 }, { "player": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "position": { "name": "Midfielder", "shortName": "MF", "id": 3 }, "knownName": "Bukayo Saka", "knownNameMedium": "B.Saka", "knownNameShort": "Saka", "id": 225191 }, "team": { "name": "Arsenal", "shortName": "ARS", "mediumName": "Arsenal", "id": 157 }, "matchesStarted": 20, "minutesPlayed": 1758, "position": 10, "matchesPlayed": 20, "totalAssists": 6, "assistsPerMatch": 0.30 } ]

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+

Table Tennis API+

Tennis 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