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
{}