iSports API – Sports API Documentation & Example Responses for Developers

Live Text

Thời gian cập nhật: 2026-07-09 14:35

Introduction

• This API endpoint returns live text content for a specified matchId. Only NBA and WNBA matches are supported.

• If matchId is omitted, all live text content updated in the last 2 minutes across matches is returned.

• You can use it with the Match List of Live Text endpoint to first obtain a list of available matchIds.

Related Plans

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

Request

Path: /sport/basketball/livetext
Method: GET
Calls: This interface is limited to 3 seconds/call;
Recommend Calls: 10 seconds/call
Parameters:

Parameter	Value	Required	Description
matchId	string	false	Returns live text content for the specified match. If omitted, returns all live text content updated in the last 2 minutes across matches.

Response

Parameter	Value	Description
recordId	string	Unique ID of this live text record.
matchId	string	Unique ID of the match.
remainTime	string	Remaining time in the current quarter, e.g. 10:00.
teamKind	int	1: Home team 2: Away team 3: Neutral — used for events that are not attributed to either team, e.g. quarter or game start/end.
matchState	int	0: Not started 1: First quarter 2: Second quarter 3: Third quarter 4: Fourth quarter 5: First OT 6: Second OT 7: Third OT 50: Half-time -1: Finished -2: TBD -3: Interrupted -4: Cancelled -5: Postponed
score	string	Current score, e.g. 2-0.
content	string	Description of the live text event, e.g. Charlisse Leger-Walker makes 12-foot pullup jump shot (Diamond Miller assists).
playerId1	string	ID of the player primarily involved in this event (e.g. shooter, scorer). Returns empty if not applicable.
playerId2	string	ID of a secondary player involved in this event (e.g. assist provider). Returns empty if not applicable.
playerId3	string	ID of a third player involved in this event, if applicable. Returns empty if not applicable.
refereeId	string	ID of the referee involved in this event (e.g. foul call). Returns empty if not applicable.

Example Request

Example Response

• This API endpoint returns live text content for a specified matchId. Only NBA and WNBA matches are supported.\n\n • If matchId is omitted, all live text content updated in the last 2 minutes across matches is returned. \n\n • You can use it with the Match List of Live Text endpoint to first obtain a list of available matchIds.

Liên hệ