Football API Tech Docs

Football API Match Team Statistics

Provides the team statistics of the match.

Football Match Team Statistics 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": { "statistics": { "totalFirstDowns": 26, "rushingFirstDowns": 5, "passingFirstDowns": 17, "penaltyFirstDowns": 4, "thirdDownSucceed": 8, "thirdDownAttempt": 13, "thirdDownEfficiency": 0.615, "fourthDownSucceed": 0, "fourthDownAttempt": 0, "fourthDownEfficiency": 0.0, "totalNetYards": 529, "rushingNetYards": 112, "totalRushingPlays": 34, "averageGainPerRush": 3.3, "passingNetYards": 417, "penaltyNumbers": 7, "score": 47, "possessionMinute": 32, "possessionSecond": 9 }, "name": "New Orleans Saints", "shortName": "NO", "mediumName": "Saints", "id": 26 }, "awayTeam": { "statistics": { "totalFirstDowns": 26, "rushingFirstDowns": 5, "passingFirstDowns": 20, "penaltyFirstDowns": 1, "thirdDownSucceed": 4, "thirdDownAttempt": 8, "thirdDownEfficiency": 0.5, "fourthDownSucceed": 1, "fourthDownAttempt": 1, "fourthDownEfficiency": 1.0, "totalNetYards": 482, "rushingNetYards": 43, "totalRushingPlays": 13, "averageGainPerRush": 3.3, "passingNetYards": 439, "sackedCount": 1, "penaltyNumbers": 8, "turnovers": 2, "fumbleNumbers": 2, "score": 40, "possessionMinute": 27, "possessionSecond": 51 }, "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
shortName	STR	NFL	The short name of the tournament
id	INT	1	The id of the tournament

stage

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

round

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

homeTeam/awayTeam

Data

Type

Example

Description

name

STR

Tampa Bay Buccaneers

The name of the home/away team

mediumName

STR

Buccaneers

The short name of the home/away team

shortName

STR

The short name of the home/away team

INT

The id of the home/away team

statistics

Data	Type	Example	Description
totalFirstDowns	INT	26	The total first down count for the team
rushingFirstDowns	INT	5	The rushing first down count for the team
passingFirstDowns	INT	17	The passing first down count for the team
penaltyFirstDowns	INT	4	The penalty first down count for the team
thirdDownSucceed	INT	8	The succeed third down count for the team
thirdDownAttempt	INT	13	The attempted third down count for the team
thirdDownEfficiency	FLT	0.615	The third down efficiency for the team
fourthDownSucceed	INT	1	The succeed fourth down count for the team
fourthDownAttempt	INT	13	Te attempted fourth down count for the team
fourthDownEfficiency	FLT	1	The fourth down efficiency for the team
totalNetYards	INT	529	The total net yards for the team
totalOffensivePlays	INT	25	The total offensive play count for the team
averageGainPerPlay	FLT	3.3	The average gain per play for the team
rushingNetYards	INT	43	The total rushing net yards for the team
totalRushingPlays	INT	34	The total rushing play count for the team
averageGainPerRush	FLT	3.1	The average gain per rush for the team
passingNetYards	INT	439	The total passing net yards for the team
sackedCount	INT	3	The total sacked count for the team
sackedYards	INT	12	The total sacked yards for the team
completedPasses	INT	25	The total completed pass count for the tea
attemptedPasses	INT	34	The total attempted pass for the team
interceptedPasses	INT	1	The total intercepted pass for the team
averageGainPerPass	INT	4.3	The average gain per pass for the team
penaltyNumbers	INT	2	The total penalty count for the team
penaltyYards	INT	8	The total penalty yards for the team
turnovers	INT	2	The total turnover count for the team
fumbleNumbers	INT	2	The total fumble count for the team
fumbleYards	INT	2	The total fumble yards for the team
rushingTDs	INT	1	The total rushing touchdown count for the team
passingTDs	INT	3	The total passing touchdown count for the team
interceptionTDs	INT	0	The total interception touchdown count for the team
kickoffReturnTDs	INT	0	The total kick return touchdown count for the team
fumbleReturnTDs	INT	0	The total fumble return touchdown count for the team
puntReturnTDs	INT	0	The total punt return touchdown count for the team
score	INT	47	The total score for the team
extraPointsMade	INT	3	The total extra point made count for the team
extraPointsAttempted	INT	3	The total extra point attempt count for the team
twoPointExtraPointsMade	INT	0	The total 2 point conversion made count for the team
twoPointExtraPointsAttempted	INT	0	The total 2 point conversion attempt count for the team
fieldGoalsMade	INT	2	The total field goal made count for the team
fieldGoalsAttempted	INT	3	The total field goal attempt count for the team
safeties	INT	1	The total safety count for the team
possessionMinute	INT	27	The total minute of possession for the team
possessionSecond	INT	51	The total second of possession for the team

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