iSports API – Sports API Documentation & Example Responses for Developers

Live Text

Update Time: 2026-05-21 17:39

Introduction

• This API endpoint returns the content of live text of the specified match ID. You can use it with the Match List of Live Text endpoint.

• Without parameter, return all the match text live content updated in the last 2 minutes.

• Currently limited to major leagues or cups.

Related Plans

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

Request

Path: /sport/football/livetext
Method: GET
Calls: This interface is limited to 3 second/call;
Recommend Calls: 15 second/call
Parameters:

Parameter	Value	Required	Description
matchId	string	false	For faster updates, use no parameters by default. Use 'matchId' only in special cases.

Response

Parameter	Value	Description
liveId	string	Unique identifier for the live text entry
matchId	string	Unique identifier for the match
content	string	Live text event description
time	int	Timestamp of the live text update, unix timestamp
state	int	0: Not started 1: First half 2: Half-time break 3: Second half 4: Extra time 5: Penalty -1: Finished -10: Cancelled -11: TBD -12: Terminated -13: Interrupted -14: Postponed
happenTime	int	Minute in the match when the event occurred
teamID	string	Identifier of the team involved in the event
homePlayerID	string	Identifier of the home team player involved in the event
awayPlayerID	string	Identifier of the away team player involved in the event

Example Request

Example Response

• This API endpoint returns the content of live text of the specified match ID. You can use it with the Match List of Live Text endpoint.\n\n • Without parameter, return all the match text live content updated in the last 2 minutes.\n\n • Currently limited to major leagues or cups.

Contact