iSports API – Sports API Documentation & Example Responses for Developers

Live Text

Update Time: 2026-06-04 11:02

Introduction

• This API endpoint returns live text commentary events for a specified match. Use it alongside the Match List of Live Text endpoint to get available match IDs.

• Without a matchId parameter, returns all live text events updated in the last 2 minutes.

• Coverage is limited to major leagues and cup competitions.

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	Filter results to a specific match. If omitted, returns all live text events updated in the last 2 minutes — recommended for real-time polling.

Response

Parameter	Value	Description
liveId	string	Unique live text event ID (auto-increment)
matchId	string
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 live text commentary events for a specified match. Use it alongside the Match List of Live Text endpoint to get available match IDs.\n\n • Without a matchId parameter, returns all live text events updated in the last 2 minutes. \n\n • Coverage is limited to major leagues and cup competitions.

Contact