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:
ParameterValueRequiredDescription
datestringfalsematch data for the specified time: GMT +0 00:00-23:59.

yyyy-MM-dd, e.g. 2019-08-01.
leagueIdstringfalseGet the schedule data of the current season of the specified event.
seasonstringfalseUse with leagueID to get the specified season, e.g. 18-19.
Return to the current season by default.
matchIdstringfalseGet match data for the specified match.

Response

ParameterValueDescription
matchId string
leagueId string
leagueName stringShort name, e.g. NBA.
quarterCount int2: the match has 2 quarter
4: the match has 4 quarter
matchTime intMatch scheduled time, unix timestamp
status int0: 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 stringRest time of the quarter, e.g. 01:23
homeId string
homeName string
homeRank intLeague ranking of home team
awayId string
awayName string
awayRank intLeague ranking of away team
homeScore intTotal score of home team
awayScore intTotal score of away team
homeFirstQuarterScore int
awayFirstQuarterScore int
homeSecondQuarterScore int
awaySecondQuarterScore int
homeThirdQuarterScore int
awayThirdQuarterScore int
homeFourthQuarterScore int
awayFourthQuarterScore int
overTimeCount intNumber of overtime
homeFirstOverTimeScore int
awayFirstOverTimeScore int
homeSecondOverTimeScore int
awaySecondOverTimeScore int
homeThirdOverTimeScore int
awayThirdOverTimeScore int
leagueSeason stringSeason of league
matchType int1: Regular season
2: Post season
3: Pre-season
- 1: Unclassified
playoffsId stringOnly the playoffs have data.
stageId stringOnly the cups have data.
hasStats booleanIs there stats data?
explain stringReturn to the live text of the match, e.g. [Spurs][SAS] Team Timeout: Regular.
roundType stringFor cups, e.g. Groups
For league playoffs, e.g. Western 1 Round
group stringGroup name of the cup, e.g. A.
neutral booleanIs 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 & ResultsiSportsAPI

    Contact