HIhighlightly
Football.Match Box Score

Retrieve box scores for specified match id.

Refresh interval: Once every 5 minutes

Retrieve detailed per-player box score match statistics data by specifying the matchId as the path parameter.

The player box score statistics contain the general team information as well as a list of players and their respective stats. Each player has high level metadata information:

DataDescription
idUnique identifier for the player.
Match ratingMatch performance rating (e.g., "8.00").
Shirt numberPlayer's shirt/jersey number.
PositionPlaying position (e.g., "Goalkeeper", "Defender").
Is a captainIndicates if the player was the team captain.
Minutes playedTotal minutes played in the match.
Is a substituteIndicates if the player started as a substitute.
OffsideNumber of offsides committed.
StatisticsDetailed performance metrics.
NameCommonly known name of the player.
Full namePlayer's full registered name.
LogoURL to the player's image/logo, if available.

Besides the general metadata, each player has the following granular match performance statistics:

StatisticDescription
Goals scoredNumber of goals the player scored in the match.
Goals savedNumber of opponent shots saved (goalkeeper stat).
Goals concededGoals allowed by the player's team while they were the goalkeeper.
AssistsPasses that directly led to a goal.
Total dribblesTotal dribble attempts made.
Successful dribblesDribble attempts that successfully beat an opponent.
Failed dribblesDribble attempts that were unsuccessful.
Dribble success ratePercentage of dribbles that were successful.
Fouls receivedTimes the player was fouled by opponents.
Fouls commitedFouls committed by the player.
Total tacklesTotal tackles attempted.
Total interceptionsNumber of times the player intercepted an opponent's pass.
Shots on targetShots directed at goal that required a save or resulted in a goal.
Shots off targetShots that missed the goal completely.
Shots totalTotal shots attempted (on and off target).
Shots accuracyPercentage of shots that were on target.
Penalties scoredPenalty kicks successfully converted into goals.
Penalties missedPenalty kicks that failed to score.
Total penaltiesTotal penalty kicks taken.
Penalty accuracyPercentage of penalties scored.
Passing accuracyPercentage of completed passes.
Successful passesPasses that successfully reached a teammate.
Failed passesPasses that failed to reach a teammate.
Total passesTotal passes attempted.
Key passesPasses that directly created a goal-scoring opportunity.
Red cardsNumber of red cards received.
Yellow cardsNumber of yellow cards received.
Second yellow cardsNumber of second yellow cards leading to a red card.
Total duelsNumber of 1v1 challenges contested.
Won duelsNumber of duels won.
Lost duelsNumber of duels lost.
Duel success ratePercentage of duels won.
Expected assists (xA)The estimated number of assists the player should have, based on chance quality.
Expected goals (xG)The estimated number of goals the player should have scored, based on chance quality.
Expected goals on target (xGOT)The expected number of goals based on the placement and quality of shots on target.
Expected goals on target conceded (xGOT Conceded)The expected number of goals a goalkeeper should have conceded based on shots faced.
Expected goals prevented (xGP)Difference between expected goals on target conceded and actual goals conceded (goalkeeper stat).

Below is an example of what you can aim to achieve with the player box score endpoint:

Football player box score example

get/football/box-score/{matchId}

Request

Path parameters

matchIdnumber required

Requested match id.

Headers

x-rapidapi-hoststring required

sport-highlights-api.p.rapidapi.com

x-rapidapi-keystring required

Rapid API Token

Response

Example response

[
  {
    "team": {
      "id": 34824,
      "logo": "https://highlightly.net/soccer/images/teams/34824.png",
      "name": "Liverpool"
    },
    "players": [
      {
        "matchRating": "6.90",
        "shirtNumber": 2,
        "position": "Defender",
        "minutesPlayed": 90,
        "statistics": [
          {
            "dribblesTotal": 3,
            "dribblesSuccessful": 2,
            "dribblesFailed": 1,
            "dribbleSuccessRate": "66.67 %",
            "fouledOthers": 1,
            "tacklesTotal": 7,
            "interceptionsTotal": 1,
            "duelsTotal": 19,
            "duelsWon": 10,
            "duelsLost": 9,
            "duelSuccessRate": "52.63 %",
            "passesAccuracy": "78.57 %",
            "passesSuccessful": 22,
            "passesTotal": 28,
            "passesKey": 3,
            "penaltiesAccuracy": "0.00 %",
            "shotsOnTarget": 1,
            "shotsTotal": 1,
            "shotsAccuracy": "100.00 %",
            "expectedGoals": 0.12,
            "expectedAssists": 0.25,
            "expectedGoalsOnTarget": 0.16
          }
        ]
      }
    ]
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.