Basketball API Tech Docs

Search in tech docs

Basketball API Match Play by Play

Provides all match events during the match like free throw shots, 2 points shots, 3 points shots, assists, rebounds and other events.

Basketball Match Play by Play 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: 12 Request / Minute Recommended API Call Interval at 1 hour after game end: 1 Request / Minute Recommended API Call Interval at more than 1 hour after game end: 4 Request / Hour

Period by Period

quarter1, quarter2, quarter3, quarter4 and overtime containers occur when they starts. For example; if the match is in the 2nd Quarter, only quarter1 and quarter2 parts will have events in themselves.

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": { "name": "Detroit Pistons", "shortName": "DET", "mediumName": "Pistons", "id": 108 }, "awayTeam": { "name": "Houston Rockets", "shortName": "HOU ", "mediumName": "Rockets", "id": 110 }, "playByPlay": { "quarter1": [ { "type": { "name": "Begin Game", "shortName": "BgnGm", "id": 20 }, "minute": 12, "orderNo": 80, "period": 1, "isStatus": true, "second": "00", "id": 2078003 }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Andre Drummond", "shirtNumber": "1", "id": 1587 }, "type": { "name": "Jumpball Win", "shortName": "JbWin", "id": 29 }, "teamId": 108, "minute": 11, "orderNo": 122, "period": 1, "second": "56", "id": 2078004 }, { "player": { "country": { "name": "Switzerland", "shortName": "SWI", "id": 36 }, "knownName": "Clint Capela", "shirtNumber": "15", "id": 822 }, "type": { "name": "Jumpball Lose", "shortName": "JbLose", "id": 30 }, "teamId": 110, "minute": 11, "orderNo": 123, "period": 1, "second": "56", "id": 2078005 } ] }, "tournament": { "name": "NBA", "shortName": "NBA", "id": 9 }, "stage": { "name": "Regular Season", "shortName": "NS", "id": 16803 }, "round": { "name": "Round 6", "shortName": "W6", "id": 6 }, "date": "24/11/2018 00:00:00", "id": 287131 }

Response Output Definitions

match

Data

Type

Example

Description

INT

287131

The id of the match

date

DATE/STR

24/11/2018 00: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	16804	The id of the stage

round

Data	Type	Example	Description
name	STR	Round 6	The name of the round
shortName	STR	W6	The short name of the round
id	INT	6	The id of the round

homeTeam/awayTeam

Data	Type	Example	Description
name	STR	Detroit Pistons	The name of the home/away team for the match
mediumName	STR	Pistons	The short name of the home/away team for the match
shortName	STR	DET	The short name of the home/away for the match
id	INT	108	The id of the home/away for the match

playByPlay

quarter1/quarter2/quarter3/quarter4/overTime

event

teamId

INT

101

Id of the event’s team

minute

INT

Minute of the game clock(remaining time at period) at event

orderNo

INT

Order number of the all events in the match

homeTeamScore

STR

Event score of the home team

awayTeamScore

STR

Event score of the away team

period

INT

Period of the event

isScoring

BLN

true

Shows the scoring events

isStatus

BLN

true

Shows the status related events

second

STR

02.0

Second of the game clock(remaining time at period) at event

INT

3434449

the id of the comment

player

Data

Type

Example

Description

knownName

STR

Goal

The full 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

type

Data	Type	Example	Description
name	STR	3PT Made	Name of the event type
shortName	STR	3PM	Short name of the event type
id	INT	5	Id of the event type

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+