iSports API – Sports API Documentation & Example Responses for Developers

League Standing

Thời gian cập nhật: 2026-06-29 15:40

Introduction

• This API endpoint returns league standings for a specified league, including total, home, away, and first-half breakdowns.

• Use it with the League Standing (Get Subleague) endpoint to get available subLeagueId values when a league has multiple stages or divisions.

• Without parameters, returns all leagues and cups with standings updated in the past 24 hours. Use the League & Cup Profile endpoint to get basic league information.

Related Plans

You can use this api by subscribing plans: Stats.

Request

Path: /sport/football/standing/league
Method: GET
Calls: This interface is limited to 3 seconds/call;
Recommend Calls: 1 day/call
Parameters:

Parameter	Value	Required	Description
leagueId	string	true	League ID to retrieve standings for. If the league has multiple stages or sub-leagues, standings are differentiated by sub-league. Use subLeagueId to filter to a specific stage.
subLeagueId	string	false	Sub-league or stage ID. If omitted, returns the standings of the first sub-league in the subLeagueInfos list by default (e.g., leagueId=1122&subLeagueId=1122).

Response

Parameter		Value	Description
leagueInfo		object	Basic profile of the league
	leagueId	string
	name	string	Full league name (e.g., Brazil Serie A)
	shortName	string	Abbreviated league name (e.g., BRA D1)
	logo	string	League logo image URL. Do not hotlink directly; download and serve locally.
	color	string	Theme color as an RGB hex code (e.g., #B5A150)
	totalRound	int	Total number of rounds in the season
	currentRound	int	Current round in progress
	currentSeason	string	Current season identifier (e.g., 2026, 2025-2026)
subLeagueInfos		list	List of sub-leagues or stages within the league
	subLeagueId	string
	name	string	Sub-league or stage name (e.g., League, Western Play-off)
	totalRound	int	Total rounds in this sub-league
	currentRound	int	Current round in this sub-league
	hasScore	boolean	true: Standing data is available false: Not available
	hasTwoLegs	boolean	true: Ties are decided over two legs false: Single match
	currentSubLeague	boolean	true: This sub-league is currently in progress false: Not in progress
teamInfos		list	List of teams participating in this league
	teamId	string
	name	string	Team name
	logo	string	Team logo image URL. Do not hotlink directly; download and serve locally.
	area	int	Conference zone 0: No division 1: East 2: West
totalStandings		list	Full-match standings (all venues)
	rank	int	Current league position
	teamId	string
	winRate	string	Win rate as a percentage (e.g., 57.1)
	drawRate	string	Draw rate as a percentage
	loseRate	string	Loss rate as a percentage
	winAverage	string	Average goals scored per match
	loseAverage	string	Average goals conceded per match
	deduction	string	Points deducted
	deductionExplain	string	Explanation of points deduction. Empty string if no deduction.
	recentFirstResult	int	Result of most recent match 0: Win 1: Draw 2: Loss 3: Empty
	recentSecondResult	int	Result of 2nd most recent match. 0: Win 1: Draw 2: Loss 3: Empty
	recentThirdResult	int	Result of 3rd most recent match. 0: Win 1: Draw 2: Loss 3: Empty
	recentFourthResult	int	Result of 4th most recent match. 0: Win 1: Draw 2: Loss 3: Empty
	recentFifthResult	int	Result of 5th most recent match. 0: Win 1: Draw 2: Loss 3: Empty
	recentSixthResult	int	Result of 6th most recent match. 0: Win 1: Draw 2: Loss 3: Empty
	color	string	Promotion or relegation zone indicator. Corresponds to the index of the matching entry in leagueColorInfos (starting from 0). -1 indicates no promotion or relegation status.
	red	int	Red cards received
	totalCount	int	Total matches played
	winCount	int	Matches won
	drawCount	int	Matches drawn
	loseCount	int	Matches lost
	getScore	int	Goals scored
	loseScore	int	Goals conceded
	goalDifference	int	Goal difference (goals scored minus goals conceded)
	totalAddScore	int	Additional points awarded (e.g., bonus points)
	integral	int	Total points (excluding deductions)
halfStandings		list	First-half standings (all venues)
	rank	int	Current league position
	teamId	string
	winRate	string	Win rate as a percentage (e.g., 57.1)
	drawRate	string	Draw rate as a percentage
	loseRate	string	Loss rate as a percentage
	winAverage	string	Average goals scored per match
	loseAverage	string	Average goals conceded per match
	totalCount	int	Total matches played
	winCount	int	Matches won
	drawCount	int	Matches drawn
	loseCount	int	Matches lost
	getScore	int	Goals scored
	loseScore	int	Goals conceded
	goalDifference	int	Goal difference (goals scored minus goals conceded)
	integral	int	Total points (excluding deductions)
homeStandings		list	Full-match standings, home matches only
awayStandings		list	Full-match standings, away matches only
homeHalfStandings		list	First-half standings, home matches only
awayHalfStandings		list	First-half standings, away matches only
leagueColorInfos		list	Color legend for promotion and relegation zones
	color	string	RGB hex color code (e.g., #ffff00)
	leagueName	string	Zone label (e.g., Title Play-offs, Relegation Play-offs)
	beginRank	int	Starting rank of this zone
	endRank	int	Ending rank of this zone
lastUpdateTime		int	Timestamp of the last standings update (Unix timestamp, GMT+0)
scoreCountType		int	Indicates whether additional points (totalAddScore) are applied in this league. 0: No additional points — column can be hidden. Any other value: additional points are in use — display the totalAddScore column.
conference		boolean	true: This league uses a conference format false: Standard league format

Example Request

Example Response

• This API endpoint returns league standings for a specified league, including total, home, away, and first-half breakdowns.\n\n • Use it with the League Standing (Get Subleague) endpoint to get available subLeagueId values when a league has multiple stages or divisions.\n\n • Without parameters, returns all leagues and cups with standings updated in the past 24 hours. Use the League & Cup Profile endpoint to get basic league information.

Liên hệ