Match statistics

1. Endpoint
2. Parameters
3. Response

On this page, we will show how you can use our football API to get match statistics.

Any football website would be incomplete without being able to show its visitors the statistics of the match. In fact, this applies to any football-related product, including mobile apps, TV shows, and even radio shows. Match statistics allow people to compare the teams and predict the outcome of the game in real-time. Using our head to head football api endpoint, you can compare the two teams before the start of the match. Using our statistics football api endpoint you can compare them as their rivalry unfolds. That is why we are glad to have this api endpoint included in our service.

Endpoint

When using our football api endpoint for match statistics all you need is the id of the match that you get from the livescore api endpoint and the history api endpoint. The match needs to have started in order to have statistics available. Thus, this api endpoint will not work for fixtures that you get our fixtures api endpoint.

In the example above, our football API will provide you with the match statistics of the game between Liverpool and Manchester City. The response is a list of all the statistics that we have for this match for both teams. An example JSON response is shown below. Then follows an explanation of what is what in it. First, we will look at the parameters table, which luckily contains only one parameter.

Parameters

Response

The response, from the match statistics football api endpoint, is pretty concise and straight forward, but we are going to explain it just in case. In it, the key that is in the data array is the type of the statistic that we providing and the value is either null or it is two numbers separated by a colon. The first value is for the home team and the second value is for the away team. When it comes to the yellow and red cards, using this api endpoint you will get the number of cards, and if you want to get the details of which players received the cards, you can use our match events api endpoint.

{
    "success": true,
    "data": {
        "yellow_cards": "0:1",
        "red_cards": "0:0",
        "substitutions": "3:1",
        "possesion": "48:52",
        "free_kicks": "10:13",
        "goal_kicks": "11:6",
        "throw_ins": "21:18",
        "offsides": "3:5",
        "corners": "4:13",
        "shots_on_target": "5:3",
        "shots_off_target": "4:8",
        "attempts_on_goal": "9:11",
        "saves": "2:2",
        "fauls": "10:5",
        "treatments": "1:0",
        "penalties": "0:0",
        "shots_blocked": "3:8",
        "dangerous_attacks": "33:56",
        "attacks": "82:91"
    }
}