Schedule & Results

Update Time: 2022-05-30 10:25

Introduction

• This API endpoint allows you to get the schedule and results of basketball matches with the corresponding date ( from the last two months to the future ) or leagueId.

• The request path needs at least one parameter (date, leagueId, and matchId ) to retrieve the correct response. These three parameters can not be used at the same time.

• You can use it with the Match Modify Record endpoint.

Related Plans

You can use this api by subscribing plans: Live Data.

Request

Path: /sport/basketball/schedule
Method: GET
Calls: This interface is limited to 60 second/call;
Recommend Calls: 12 hour/call
Parameters:

Parameter	Value	Required	Description
date	string	false	match data for the specified time: GMT +0 00:00-23:59. yyyy-MM-dd, e.g. 2019-08-01.
leagueId	string	false	Get the schedule data of the current season of the specified event.
season	string	false	Use with leagueID to get the specified season, e.g. 18-19. Return to the current season by default.
matchId	string	false	Get match data for the specified match.

Response

Parameter	Value	Description
matchId	string
leagueId	string
leagueName	string	Short name, e.g. NBA.
quarterCount	int	2: the match has 2 quarter 4: the match has 4 quarter
matchTime	int	Match scheduled time, unix timestamp
status	int	0: Not started 1: The first quarter 2: The second quarter 3: The third quarter 4: The fourth quarter 5: The first OT 6: The second OT 7: The third OT 50: Half-time -1: Finished -2: TBD -3: Interrupted -4: Cancelled -5: Postponed
quarterRemainTime	string	Rest time of the quarter, e.g. 01:23
homeId	string
homeName	string
homeRank	int	League ranking of home team
awayId	string
awayName	string
awayRank	int	League ranking of away team
homeScore	int	Total score of home team
awayScore	int	Total score of away team
homeFirstQuarterScore	int
awayFirstQuarterScore	int
homeSecondQuarterScore	int
awaySecondQuarterScore	int
homeThirdQuarterScore	int
awayThirdQuarterScore	int
homeFourthQuarterScore	int
awayFourthQuarterScore	int
overTimeCount	int	Number of overtime
homeFirstOverTimeScore	int
awayFirstOverTimeScore	int
homeSecondOverTimeScore	int
awaySecondOverTimeScore	int
homeThirdOverTimeScore	int
awayThirdOverTimeScore	int
leagueSeason	string	Season of league
matchType	int	1: Regular season 2: Post season 3: Pre-season - 1: Unclassified
playoffsId	string	Only the playoffs have data.
stageId	string	Only the cups have data.
hasStats	boolean	Is there stats data?
explain	string	Return to the live text of the match, e.g. [Spurs][SAS] Team Timeout: Regular.
roundType	string	For cups, e.g. Groups For league playoffs, e.g. Western 1 Round
group	string	Group name of the cup, e.g. A.
neutral	boolean	Is it a neutral venue?

Example Request

Example Response

{}

• This API endpoint allows you to get the schedule and results of basketball matches with the corresponding date ( from the last two months to the future ) or leagueId. \n\n • The request path needs at least one parameter (date, leagueId, and matchId ) to retrieve the correct response. These three parameters can not be used at the same time. \n\n • You can use it with the Match Modify Record endpoint.

Schedule & Results

Contact