iSports API – Sports API Documentation & Example Responses for Developers

Match Stats

Thời gian cập nhật: 2026-07-16 14:26

Introduction

• This API endpoint returns real-time technical statistics for basketball matches (GMT+0 00:00–23:59).
By default, returns technical statistics for matches within the last 24 hours.

• Player statistics currently supports NBA, WNBA, CBA, Asociación de Clubes de Baloncesto, Basketball Bundesliga, Ligue Nationale de Basket, Lega Basket Serie A, Euro, Russian Basketball Super League, NBL(A), and Korea Basketball League.

• By using endpoints Schedule & Results (Basic) and Match Modify Record, you can get basic information of matches.

• The following offensive statistics can be calculated using formulas.
- Free Throws Percentage (FT%) = Free Throws Made / Free Throws Attempts
- 2-Pointers Percentage (2P%) = 2-Pointers Field Goals Made / 2-Pointers Attempts
- 3-Pointers Percentage (3P%) = 3-Pointers Field Goals Made / 3-Pointers Attempts
- Field Goals Percentage (FG%) = Field Goals Made / Field Goals Attempts
- Total Rebounds (Reb) = Defensive Rebounds + Offensive Rebounds

Related Plans

You can use this api by subscribing plans: Stats.

Request

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

Parameter	Value	Required	Description
date	string	false	Match date, format yyyy-MM-dd, e.g. 2026-07-01. Only the past 7 days can be queried.
matchId	string	false	Returns match stats for the specified match.

Response

Parameter		Value	Description
matchId		string	Unique ID of the match.
homeTeamName		string	Name of the home team.
awayTeamName		string	Name of the away team.
costTime		string	Elapsed match time. Returns empty for matches that have not started or have already finished; only populated during live matches.
homeScore		int	Total score of the home team.
homeFastScore		int	Fast-break points scored by the home team.
homeInsideScore		int	Points scored in the paint by the home team.
homeLeadingScore		int	Maximum leading margin of the home team during the match.
homeTotalMiss		int	Total turnovers by the home team.
awayScore		int	Total score of the away team.
awayFastScore		int	Fast-break points scored by the away team.
awayInsideScore		int	Points scored in the paint by the away team.
awayLeadingScore		int	Maximum leading margin of the away team during the match.
awayTotalMiss		int	Total turnovers by the away team.
homePlayers		list	Player statistics for the home team.
	playerId	string	Unique ID of the player.
	playerName	string	Name of the player.
	location	string	Position of the player, e.g. Center, Guard. Only available for starting lineup players; returns empty for substitutes.
	playingTime	int	Minutes played.
	shootHit	int	Field goals made.
	shoot	int	Field goals attempted.
	threePointHit	int	3-point field goals made.
	threePointShot	int	3-point field goals attempted.
	penaltyShotHit	int	Free throws made.
	penaltyShot	int	Free throws attempted.
	attack	int	Offensive rebounds.
	defend	int	Defensive rebounds.
	assist	int	Assists
	foul	int	Personal fouls.
	rob	int	Steals
	miss	int	Turnovers.
	cover	int	Blocks.
	score	int	Points scored by the player.
	onFloor	boolean	true: player is currently on the floor false: player is not currently on the floor
awayPlayers		list	Player statistics for the away team. Same structure as homePlayers.
	playerId	string
	playerName	string
	location	string
	playingTime	int
	shootHit	int
	shoot	int
	threePointHit	int
	threePointShot	int
	penaltyShotHit	int
	penaltyShot	int
	attack	int
	defend	int
	assist	int
	foul	int
	rob	int
	miss	int
	cover	int
	score	int
	onFloor	boolean

Example Request

Example Response

• This API endpoint returns real-time technical statistics for basketball matches (GMT+0 00:00–23:59). \n By default, returns technical statistics for matches within the last 24 hours.\n\n • Player statistics currently supports NBA, WNBA, CBA, Asociación de Clubes de Baloncesto, Basketball Bundesliga, Ligue Nationale de Basket, Lega Basket Serie A, Euro, Russian Basketball Super League, NBL(A), and Korea Basketball League.\n\n • By using endpoints Schedule & Results (Basic) and Match Modify Record, you can get basic information of matches.\n\n • The following offensive statistics can be calculated using formulas.\n - Free Throws Percentage (FT%) = Free Throws Made / Free Throws Attempts\n - 2-Pointers Percentage (2P%) = 2-Pointers Field Goals Made / 2-Pointers Attempts\n - 3-Pointers Percentage (3P%) = 3-Pointers Field Goals Made / 3-Pointers Attempts\n - Field Goals Percentage (FG%) = Field Goals Made / Field Goals Attempts\n - Total Rebounds (Reb) = Defensive Rebounds + Offensive Rebounds\n

Liên hệ