Commentaries API

Commentaries API

Returns match stats, lineups and player stats. This is the place to go for more data about the match. For the top leagues, we provide play-by-play commentaries as long as live team and player statistics.

Available Data:

  • match_id: Unique id of the match
  • match_info:
    • stadium: Name of the stadium
    • attendance: Number of match attendants
    • referee: Name of the refere
  • lineup: Teams linups
    • id: Player’s id
    • number: Player’s number
    • name: Player’s name
    • pos: Player’s position in the field
  • subs: Teams substitutes
    • id: player’s id
    • number: Player’s number
    • name: Player’s name
    • pos: Player’s position in the field
  • substitutions: Player substitutions
    • off_name: Off player’s name
    • on_name: On player’s name
    • off_id: off player’s id
    • on_id: On player’s id
    • minute: Minute of substitution
  • comments: Match live comments
    • id: Id of the comment
    • important: Is this event important?
    • isgoal: Is this event a goal?
    • minute: Minute of the event
    • comment: Comment text on match event
  • match_stats: Statistics of the match
    • shots_total: Number of shots
    • shots_ongoal: Number of shots on goal
    • fouls: Number of fouls
    • corners: Number of Corners
    • offsides: Number of offsides
    • possesiontime: Percentage of possession
    • yellowcards: Number of yellow cards
    • redcards: Number of red cards
    • saves: Number of saves
  • player_stats: Players’ stats
    • id: id of the player
    • num: Player’s number
    • name: Player’s name
    • pos: Player’s position
    • posx: Player’s X position on a grid
    • posy: Player’s Y position on a grid
    • shots_total: Total shots
    • shots_on_goal: Shots on target
    • goals: Goals scored
    • assists: Assists
    • offsides: Offsides
    • fouls_drawn: Fouls gained
    • fouls_committed: Foulds committed
    • saves: Saves
    • yellowcards: Yello cards
    • redcards: Red cards
    • pen_score: Penalties scored
    • pen_miss: Penalties missed

Try this endpoint in our live documentation here