Basketball API Tech Docs

Search in tech docs

Basketball API Match Statistics

Provides the statistics of the match by team based.

Basketball Match 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": { "successfulFreeThrows": 19, "freeThrowAttempts": 25, "freeThrowSuccessRate": 0.76, "successfulFieldGoals": 40, "fieldGoalAttempts": 63, "fieldGoalSuccessRate": 0.63, "successfulThreePointShots": 13, "threePointShotAttempts": 31, "threePointSuccessRate": 0.41, "defensiveRebounds": 45, "offensiveRebounds": 11, "totalRebounds": 56, "assists": 34, "turnovers": 15, "steals": 12, "blocks": 6, "fouls": 24, "lead": 46 }, "name": "Denver Nuggets", "shortName": "DEN", "mediumName": "Nuggets", "id": 107 }, "awayTeam": { "statistics": { "successfulFreeThrows": 20, "freeThrowAttempts": 27, "freeThrowSuccessRate": 0.74, "successfulFieldGoals": 23, "fieldGoalAttempts": 50, "fieldGoalSuccessRate": 0.46, "successfulThreePointShots": 9, "threePointShotAttempts": 42, "threePointSuccessRate": 0.21, "defensiveRebounds": 28, "offensiveRebounds": 15, "totalRebounds": 43, "assists": 20, "turnovers": 19, "steals": 7, "blocks": 5, "fouls": 22, "lead": 0 }, "name": "Atlanta Hawks", "shortName": "ATL", "mediumName": "Hawks", "id": 101 }, "tournament": { "name": "NBA", "shortName": "NBA", "id": 9 }, "stage": { "name": "Regular Season", "shortName": "NS", "id": 16803 }, "round": { "name": "Round 5", "shortName": "W5", "id": 5 }, "date": "16/11/2018 02:00:00", "id": 287078 }

Response Output Definitions

match

Data

Type

Example

Description

INT

287078

The id of the match

date

DATE/STR

16/11/2018 02:00:00

The date of the match

tournament

Data	Type	Example	Description
name	STR	NBA	The name of the tournament
shortName	STR	NBA	The short name of the tournament
id	INT	9	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	16803	The id of the stage

round

Data	Type	Example	Description
name	STR	Round 5	The name of the round
shortName	STR	W5	The short name of the round
id	INT	5	The id of the round

homeTeam/awayTeam

Data

Type

Example

Description

name

STR

Denver Nuggets

The name of the home/away team

mediumName

STR

Nuggets

The short name of the home/away team

shortName

STR

DEN

The short name of the home/away team

INT

107

The id of the home/away team

statistics

Data	Type	Example	Description
successfulFreeThrows	INT	19	The total successfull free throw count of the team
freeThrowAttempts	INT	25	The total free throw count of the team
freeThrowSuccessRate	FLT	0.76	The free throw success ratio of the team
successfulFieldGoals	INT	40	The total successfull field goal count of the team
fieldGoalAttempts	INT	63	The total field goal count of the team
fieldGoalSuccessRate	FLT	0.63	The field goal success ratio of the team
successfulThreePointShots	INT	13	The total successfull three points count of the team
threePointShotAttempts	INT	31	The total three points count of the team
threePointSuccessRate	FLT	0.41	Three points success ratio of the team
defensiveRebounds	INT	45	The total defensive rebounds count of the team
offensiveRebounds	INT	11	The total offensive rebounds count of the team
totalRebounds	INT	56	The total rebounds count of the team
assists	INT	34	The total assist count of the team
turnovers	INT	15	The total turnover count of the team
steals	INT	12	The total steal count of the team
blocks	INT	6	The total block count of the team
fouls	INT	24	The total foul count of the team
lead	INT	46	The total lead count of the team

Basketball 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+