iSports API – Sports API Documentation & Example Responses for Developers

Change Log

2026-07-07

• Other Odds - Overtime & Penalty Shootout Added odds for extra time and penalty shootouts, and supports Handicap, Total Goals, and 1x2 European odds data.

2026-06-13

• Other Odds - Outrights Updated typeId list to include additional group types for the 2026 World Cup expanded 48-team format: Added: 23 (Winner of group I), 24 (Winner of group J), 25 (Winner of group K), 26 (Winner of group L), 29 (Qualified from group I), 30 (Qualified from group J), 31 (Qualified from group K), 32 (Qualified from group L), 35 (Round of 16)

2026-06-11

• Stats - Player Stats (Match) Added 2 goalkeeper-specific fields to Player Stats (Match): saves (saves made by the goalkeeper) and punches (times the goalkeeper punched the ball clear).

2026-06-04

• Live Data - Lineups Updated the description for the isPreview parameter to provide clearer guidance on its behavior and scope.

2026-05-29

• Live Data - Events Added penalty shootout kick records to the Events endpoint response. A new penalty list is now returned for matches that include a penalty shootout, providing a detailed breakdown of each kick. The penalty list includes the following fields per kick:eventId、homeEvent、playerId、playerName、homeScore、awayScore、missed、oprTime

• Live Data - Shooting events Added XY coordinate fields to the shooting event response, providing precise spatial data for each shot. The following new fields are now available:startX / startY、endX / endY、goalX / goalY、blockX / blockY

2026-05-21

• Live Data - Live Text Renamed field "matchTime" to "time", and added five new fields: "state","happenTime", "teamID", "homePlayerID", "awayPlayerID".

2026-05-07

• Other Odds - Handicap Corners (In-play) Added three parameters "matchTime", "homeCorner" and "awayCorner", and updated providers.

• Other Odds - Total Corners (In-play) Added three parameters "matchTime", "homeCorner" and "awayCorner", and updated providers.

• Other Odds - Total Corners (In-play) The form of data updates has changed.

• Other Odds - Handicap Corners (In-play) The form of data updates has changed.

2026-04-29

• Live Data - Shooting events Add coordinate data to the shot event interface.

2026-04-23

• Live Data - Lineups Added one parameter "isCaptain" to Lineups. Upgraded Product: [Live Data]

• Stats - Player Stats (Match) Added 3 parameters: duelTotal, aerialTotal and highClaims to Player Stats (Match). Upgraded Product: [Stats]

2026-03-26

• Live Data - Match Insights Add Match Insights, Upgrade Product: [Live data]

2026-02-26

• Common API - Player Modify Record Add Player Modify Record, Upgrade Product: [Common API]

• Common API - Team Modify Record Add Team Modify Record, Upgrade Product: [Common API]

2026-01-29

• Common API - Providers for Asian Markets Add Providers for Asian Markets, Upgrade Product: [Common API]

2026-01-28

• Profile - Referee Profile Extended the referee statistics API with additional performance data, including home and away results and recent match-based metrics.

• Other Odds - Card Add Card, Upgrade Product: [Odds PRO]

• Other Odds - Both Teams to Score Add Both Team to Score, Upgrade Product: [Odds PRO]

• Other Odds - Team Goals Add Team Goals , Upgrade Product: [Odds PRO]

• Other Odds - Corners 1x2 (pre-match) Add Corners 1x2(pre-match) , Upgrade Product: [Odds PRO]

• Profile - Player Profile Add 2 fields "country2 " "country2Id".

2025-11-24

• Live Data - Events The Events API now supports the parameter "cmd=new". Use this to return data updated in the last 3 minutes.

2025-11-21

• Live Data - Stats Expanded the returned dataset for the type field in the Stats API. New statistic items have been added starting from index 47, including multiple popular xG-related metrics. Newly added fields with descriptions: 47: BigChances – Number of clear goal-scoring opportunities. 48: BigChancesMissed – Number of clear chances that were not converted. 49: ShotsInsideBox – Total shots taken from inside the penalty box. 50: ShotsOutsideBox – Total shots taken from outside the penalty box. 51: DuelsWon – Number of duels successfully won. 52: ExpectedGoals (xG) – Estimated probability of scoring based on shot quality. 53: xGOpenPlay – Expected goals generated from open-play situations. 54: xGSetPlay – Expected goals generated from set-piece situations. 55: xGNonPenalty – Expected goals excluding penalties. 56: xGOT (Expected Goals On Target) – Expected goals based on shots that hit the target. 57: TouchesInOppositionBox – Number of ball touches inside the opponent’s penalty area. 58: AccurateCrosses – Number of successfully completed/correct crosses. 59: GroundDuelsWon – Number of ground duels won. 60: AerialDuelsWon – Number of aerial duels won. 61: Clearances – Number of defensive clearances made.

• Profile - Player Profile Added six new player attribute fields to the Player Profile API: 1.PAC– Speed. 2.SHO– Shooting ability 3.PAS – Passing ability 4.DRI – Ball control 5.DEF – Defensive ability 6.PHY – Strength & stamina Included concise English descriptions for each attribute. Updated API response examples and field definitions accordingly.

2024-11-07

• Live animation - Time line Add API Time line.

2024-08-05

• Profile - Player Profile Add cmd=more parameter. Get player honor data.

• Profile - Team Profile 1.Add cmd=more parameter. Get team introduction and team honors data. 2.Add 1 field "country_logo" .

2024-05-13

• Stats - Matches Analysis Add 4 fields "homeSingleDouble" "awaySingleDouble ""homeDataVs"and "awayDataVs".

2024-04-22

• Other Odds - Total Corners (In-play) Add half time total odds of corner.

• Other Odds - Total Corners (pre-match) Add half time total odds of corner.

2024-03-20

• Other Odds - Double Chance (pre-match) Add Double Chance odds , Upgrade Product: [Odds PRO]

• Other Odds - EuroHandicap (pre-match) Add EuroHandicap odds , Upgrade Product: [Odds PRO]

2024-03-07

• Profile - Team Profile Add day parameter. After adding this parameter, only the data added or modified within this time will be returned. It is recommended to enter day=1 or day=2.

2023-09-13

• Live Data - Schedule & Results Add 1 field "var".

• Live Data - Livescores Changes Add 1 field "var".

• Live Data - Livescores for Today Add 1 field "var".

2023-06-21

• Profile - Team Profile Add 1 field "isNational" .

2022-12-06

• Live Data - Schedule Changes Update Example Response

• Stats - Player Stats (Match) Update Example Response

• Live Data - Schedule & Results Update Example Response

• Live Data - Livescores Changes Update Example Response

• Live Data - Livescores for Today Update Example Response

• Live Data - Schedule Changes Add 2 fields "injuryTime" and "updateTime".

2022-12-03

• Live Data - Schedule & Results Add 2 fields "injuryTime" and "updateTime".

2022-12-02

• Stats - Player Stats (Match) Add 1 fields "isBest" .

• Live Data - Livescores Changes Add 1 fields "injuryTime" .

• Live Data - Livescores for Today Add 2 fields "injuryTime" and "updateTime".

2022-08-16

• Live Data - Schedule Changes Add API Schedule Changes.

2022-08-03

• Stats - Player Stats (Match) Added "penaltySave" field.

2022-06-23

• Profile - Teamlist with Player Profile Add API Teamlist with Player Profile.

2022-06-21

• Odds (18 Agencies) - Odd Modify Record Add API Odd Modify Record.

2022-05-20

• Other Odds - Outrights Add 3 fields "type" "item""company".

2022-05-19

• Stats - List of Player Stats (Match) Add one field "modifyTime".

• Profile - Player Profile Added the parameter "day" to get the player data that has been modified within the specified number of days.

• Live Data - Live Text Add one field "matchId".

• Common API - Schedule & Results (Basic) Add 4 fields "homeId" "awayId""homeHalfScore""awayHalfScore".

2022-04-27

• Odds (18 Agencies) - Historical Odds (All) By default, it returns the match data from GMT+0 0:00 to the currently completed match.

• Odds (18 Agencies) - Historical Odds (Main) By default, it returns the match data from GMT+0 0:00 to the currently completed match.

• Stats - Top Scorer Add two fields "matchNum" and "subNum".

• Stats - League Standing Add one field "scoreCountType". Whether to show the additional points column, if the value is not 0 then show.

• Stats - League Standing Add two fields "beginRank" and "endRank".

• Stats - Cup Standing Without parameter, return the list of cups whose points have been updated in the last 24 hours.

• Stats - League Standing Without parameter, return the list of leagues whose points have been updated in the last 24 hours.

• Stats - Player Stats (League & Cup) Add one field "wasFouledCount".

• Stats - Player Stats (Match) Add two fields "shotOnPost" and "errorLeadToGoal".

• Stats - Matches Analysis The field "matchTime" is adjusted to the timestamp of GMT+0.

• Profile - Cup Stage Profile Add one field "groupLineupCount".The number of qualifying teams in each group. eg. "groupLineupCount": "A,2;B,1;C,2;D,1;E,2;F,1;G,2;H,2" This item may not be available, if there is, it will take precedence over lineCount.

• Profile - League & Cup Profile Add the description of the competition system. If there is no data, it will not be returned. eg. http://api.isportsapi.com/sport/football/league?api_key=<YOUR_API_KEY>&cmd=rule