Football API Tech Docs

Football API Game Leaders

Provides the top player statistics in passing, rushing and receiving during the match.

Football Game Leaders Request URL

GET

References / Dependencies

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

Stage / Round Structure Stage / Round structures change tournament by tournament. You can find the structures with Tournament Id from Tournament Info endpoint

Matches from Fixture Match Ids can be retrieved from The fixture of the tournament. You can find all matches of the tournament from Tournament Fixture endpoint

Matches from Match List Match Ids can be retrieved from The Daily Match List. You can find all matches in 7-days period from Match List endpoint

Call Rate / Interval

Recommended API Call Interval at live: 6 Request / Minute Recommended API Call Interval at 1 hour after game end: 2 Request / Minute Recommended API Call Interval at more than 1 hour after game end: 6 Request / Hour

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
matchId	INT	R	{matchId}	The id of the match

Response Output

{ "homeTeam": { "passing": { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "position": { "positionTypeId": 1, "name": "QuarterBack", "shortName": "QB", "id": 4 }, "knownName": "Ryan Fitzpatrick", "name": "Ryan ", "middleName": "Joseph ", "shirtNumber": "14", "lastName": "Fitzpatrick", "id": 1240 }, "statistics": { "attemptedPass": 28, "completedPass": 21, "passingNetYards": 417, "passingTD": 4 } }, "rushing": { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "position": { "positionTypeId": 1, "name": "RunningBack", "shortName": "RB", "id": 5 }, "knownName": "Peyton Barber", "name": "Peyton ", "middleName": "", "shirtNumber": "25", "lastName": "Barber", "id": 473 }, "statistics": { "totalRushingPlays": 19, "rushingNetYards": 69 } }, "receiving": { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "position": { "positionTypeId": 1, "name": "WideReceiver", "shortName": "WR", "id": 6 }, "knownName": "Mike Evans", "name": "Michael", "middleName": "Lynn", "shirtNumber": "13", "lastName": "Evans III", "id": 51 }, "statistics": { "reception": 7, "receptionTD": 1, "totalReceivingYards": 147 } }, "name": "New Orleans Saints", "shortName": "NO", "mediumName": "Saints", "id": 26 }, "awayTeam": { "passing": { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "position": { "positionTypeId": 1, "name": "QuarterBack", "shortName": "QB", "id": 4 }, "knownName": "Drew Brees", "name": "Drew", "middleName": "", "shirtNumber": "9", "lastName": "Brees", "id": 158 }, "statistics": { "attemptedPass": 45, "completedPass": 37, "passingNetYards": 439, "passingTD": 3 } }, "rushing": { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "position": { "positionTypeId": 1, "name": "RunningBack", "shortName": "RB", "id": 5 }, "knownName": "Alvin Kamara", "name": "Alvin", "middleName": "Mentian", "shirtNumber": "41", "lastName": "Kamara", "id": 2341 }, "statistics": { "totalRushingPlays": 8, "rushingNetYards": 29, "rushingTDs": 2.0 } }, "receiving": { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "position": { "positionTypeId": 1, "name": "WideReceiver", "shortName": "WR", "id": 6 }, "knownName": "Michael Thomas", "name": "Michael ", "middleName": "", "shirtNumber": "13", "lastName": "Thomas ", "id": 705 }, "statistics": { "reception": 16, "receptionTD": 1, "totalReceivingYards": 180 } }, "name": "Tampa Bay Buccaneers", "shortName": "TB", "mediumName": "Buccaneers", "id": 28 }, "tournament": { "name": "National Football League", "shortName": "NFL", "id": 1 }, "stage": { "name": "Regular Season", "shortName": "NS", "id": 717 }, "round": { "name": "Round 1", "shortName": "W1", "id": 1 }, "date": "09/09/2018 17:00:00", "id": 17404 }

Response Output Definitions

match

Data

Type

Example

Description

INT

17404

The id of the match

date

DATE/STR

09/09/2018 17:00:00

The date of the match

tournament

Data	Type	Example	Description
name	STR	National Football League	The name of the tournament for the match
shortName	STR	NFL	The short name of the tournament for the match
id	INT	1	The id of the tournament for the match

stage

Data	Type	Example	Description
name	STR	Regular Season	The name of the stage for the match
shortName	STR	NS	The short name of the stage for the match
id	INT	717	The id of the stage for the match

round

Data	Type	Example	Description
name	STR	Round 1	The name of the round for the match
shortName	STR	W1	The short name of the round for the match
id	INT	1	The id of the round for the match

homeTeam/awayTeam

Data

Type

Example

Description

name

STR

New Orleans Saints

The name of the home/away team

mediumName

STR

Saints

The short name of the home/away team

shortName

STR

The short name of the home/away

INT

The id of the home/away

passing

player

Data

Type

Example

Description

knownName

STR

Ryan Fitzpatrick

The full name of the player

name

STR

Ryan

The first name of the player

middleName

STR

Joseph

The middle name of the player

lastName

STR

Fitzpatrick

The last name of the player

shirtNumber

INT

The shirt number of the player

INT

1240

the id of the player

country

Data	Type	Example	Description
name	STR	U.S.A	The name of the country
shortName	STR	USA	The short name of the country
id	INT	18	The id of the country

position

Data	Type	Example	Description
name	STR	QuarterBack	The name of the position
shortName	STR	QB	The short name of the position
id	INT	4	The id of the position
positionTypeId	INT	1	The id of the position type

statistics

Data	Type	Example	Description
attemptedPass	INT	28	Player’s total attempted pass count in the match
completedPass	INT	21	Player’s total completed pass count in the match
interceptedPass	INT	0	Player’s total intercepted pass count in the match
passingNetYards	INT	417	Player’s total net yards of passing in the match
passingTD	INT	4	Player’s total passing touchdown count in the match

rushing

player

Data

Type

Example

Description

knownName

STR

Peyton Barber

The full name of the player

name

STR

Peyton

The first name of the player

middleName

STR

The middle name of the player

lastName

STR

Barber

The last name of the player

shirtNumber

INT

The shirt number of the player

INT

473

the id of the player

country

Data	Type	Example	Description
name	STR	U.S.A	The name of the country
shortName	STR	USA	The short name of the country
id	INT	18	The id of the country

position

Data	Type	Example	Description
name	STR	RunningBack	The name of the position
shortName	STR	RB	The short name of the position
id	INT	5	The id of the position
positionTypeId	INT	1	The id of the position type

statistics

Data	Type	Example	Description
totalRushingPlays	INT	19	Player’s total rushing plays count in the match
rushingNetYards	INT	69	Player’s total net yards of rushing in the match
rushingTDs	INT		Player’s total rushing touchdown count in the match

receiving

player

Data

Type

Example

Description

knownName

STR

Mike Evans

The full name of the player

name

STR

Michael

The first name of the player

middleName

STR

Lynn

The middle name of the player

lastName

STR

Evans III

The last name of the player

shirtNumber

INT

The shirt number of the player

INT

the id of the player

country

Data	Type	Example	Description
name	STR	U.S.A	The name of the country
shortName	STR	USA	The short name of the country
id	INT	18	The id of the country

position

Data	Type	Example	Description
name	STR	WideReceiver	The name of the position
shortName	STR	WR	The short name of the position
id	INT	6	The id of the position
id	INT	1	The type id of the position

statistics

Data	Type	Example	Description
reception	INT	7	Player’s total reception count in the match
totalReceivingYards	INT	147	Player’s total net yards of reception in the match
receptionTD	INT	1	Player’s total reception touchdown count in the match

Football 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

Football API Game Leaders

Football Game Leaders Request URL

References / Dependencies

Call Rate / Interval

Request Headers

Request Parameters

Response Output

Response Output Definitions

match

tournament

stage

round

homeTeam/awayTeam

passing

player

country

position

statistics

rushing

player

country

position

statistics

receiving

player

country

position

statistics