iSports API – Sports API Documentation & Example Responses for Developers

Player Stats (Match)

Update Time: 2026-06-29 15:34

Introduction

• This API endpoint returns players' technical statistics of specified matchId. You can use it with the List of Player Stats (Match) endpoint.

• Currently only some top leagues are supported.

• support to check back the matches within a week.

Related Plans

You can use this api by subscribing plans: Stats.

Request

Path: /sport/football/playerstats/match
Method: GET
Calls: This interface is limited to 10 seconds/call;
Recommend Calls: 1 minute/call
Parameters:

Parameter	Value	Required	Description
matchId	string	true	for detailed statistical data specified match; support to check back the matches within a week.

Response

Parameter	Value	Description
playerId	string
teamId	string
number	int	Player's shirt number
name	string	Player's full name
positionName	string	Player's position (e.g., Goalkeeper, Defender)
shots	int	Total shots attempted
shotsTarget	int	Shots on target
keyPass	int	Key passes (directly creating a goal-scoring opportunity)
passRate	string	Pass accuracy rate (e.g., 0.741935 = 74.2%)
aerialWon	int	Aerial duels won
touches	int	Total ball touches
dribblesWon	int	Successful dribbles
wasFouled	int	Times fouled by an opponent
dispossessed	int	Times dispossessed
turnOver	int	Times possession was lost without a foul
offsides	int	Times caught offside
tackles	int	Tackles attempted
interception	int	Interceptions made
clearances	int	Clearances made
clearanceWon	int	Clearances won under pressure
shotsBlocked	int	Opponent shots blocked
offsideProvoked	int	Times an opponent was caught offside due to this player
fouls	int	Fouls committed
totalPass	int	Total passes attempted
accuratePass	int	Accurate passes completed
crossNum	int	Crosses attempted
crossWon	int	Successful crosses
longBall	int	Long balls attempted
longBallWon	int	Successful long balls
throughBall	int	Through balls attempted
throughBallWon	int	Successful through balls
rating	string	Player match rating (e.g., 7.5)
red	int	Red cards received
yellow	int	Yellow cards received
assist	int	Assists
playingTime	int	Minutes played
goals	int	Goals scored
firstTeam	boolean	true: Player started in the lineup false: Substitute
penaltyGoals	int	Goals scored from penalty kicks
shotOnPost	int	Shots hitting the post
errorLeadToGoal	int	Errors directly leading to an opponent's goal
secondYellow	int	Second yellow cards received (resulting in red)
penaltySave	int	Penalty kicks saved (goalkeepers only). 0 if not applicable
isBest	boolean	true: Player of the match false: Not selected
duelTotal	int	Total 1v1 duels participated in
aerialTotal	int	1v1 duels won. Note: despite the field name, this represents successful duels, not total count.
highClaims	int	High balls successfully claimed (goalkeepers only). 0 if not applicable
saves	int	Saves made (goalkeepers only). 0 if not applicable
punches	int	Times the goalkeeper punched the ball clear. 0 if not applicable

Example Request

Example Response

• This API endpoint returns players' technical statistics of specified matchId. You can use it with the List of Player Stats (Match) endpoint.\n\n • Currently only some top leagues are supported.\n\n • support to check back the matches within a week.

Contact