Schedule & Results

Update Time: 2022-03-24 17:52

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: /basketball_th/schedule.aspx
  • Method: GET
  • Calls: This interface is limited to 60 second/call.
  • Recommend Calls: 6 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 Max 50 Ids.

Response

Parameter Value Description
matchId int
leagueId int  
leagueName string Short name, e.g. NBA.
quarterCount int 2: the match has 2 quarter
4: the match has 4 quarter
matchTime date Match scheduled time, GMT +7 (Bangkok Time)
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 int
homeName string
homeRank string League ranking of home team
awayId int
awayName string
awayRank string League ranking of away team
homeScore int Total score of home team
awayScore int Total score of away team
home1 int
away1 int
home2 int
away2 int
home3 int
away3 int
home4 int
away4 int
overTimeCount int Number of overtime
homeOt1 int
awayOt1 int
homeOt2 int
awayOt2 int
homeOt3 int
awayOt3 int
leagueSeason string Season of league
matchType int 1: Regular season
2: Post season
3: Pre-season
- 1: Unclassified
hasStats boolean Is there stats data?
explain string Return to the live text of the match, e.g. [Spurs][SAS] Team Timeout: Regular.
playoffsId string Only the playoffs have data.
stageId string Only the cups have data.
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?
    • 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 iSportsAPI