Matches Statistics
This endpoint allows you to retrieve the statistics from matches.
Types of the statistics: Goals prevented, Shots outside box, Expected goals, Crosses, Counter attacks, Aerials won, Shots inside box, Dribbles, Offsides, Red cards, Goal kicks, Hit woodwork, Ball possession, Counter attack goals, Passes, Timeouts, Counter attack shots, Interceptions, Accurate passes, Yellow cards, Big chances, Duels won, Shots on target, Shots off target, Free kicks, Fouls, Corner kicks, Goalkeeper saves, Total shots, Tackles, Expected assists, Clearances, Possession lost, Throw-ins, Big chances missed, Blocked shots, Long balls.
Multi-language: This feature allows the user to manually change the language of the API response by adding value to the
lang
attribute. Example:lang=en
.
Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.
Update Period: The endpoint is updated every minute. Recommended Calls: Limit calls to 1 every minute.
Use Cases
Get statistics from a specific match_idhttps://football.sportdevs.com/matches-statistics?match_id=eq.{match_id}
Query Parameters
- match_id integer
Default value:
eq.1
The id of the match
- offset string
Default value:
0
Limiting and Pagination
- limit string
Default value:
50
Limiting and Pagination
- lang string
Default value:
en
Multi-language
- 200
OK
- application/json
- Schema
- Example (from schema)
Schema array
- match_id integer
The id of the match
Note: This is a Foreign Key to
injuries.match_id
. - statistics jsonb
The statistics of the match
[
{
"match_id": 1,
"statistics": [
{
"type": "Accurate passes",
"period": "1ST",
"category": "Passes",
"away_team": "242 (84%)",
"home_team": "102 (66%)"
},
{
"type": "Accurate passes",
"period": "2ND",
"category": "Passes",
"away_team": "138 (72%)",
"home_team": "261 (83%)"
},
{
"type": "Accurate passes",
"period": "ALL",
"category": "Passes",
"away_team": "380 (79%)",
"home_team": "363 (77%)"
},
{
"type": "Aerials won",
"period": "1ST",
"category": "Duels",
"away_team": "12",
"home_team": "14"
},
{
"type": "Aerials won",
"period": "2ND",
"category": "Duels",
"away_team": "7",
"home_team": "14"
},
{
"type": "Aerials won",
"period": "ALL",
"category": "Duels",
"away_team": "19",
"home_team": "28"
},
{
"type": "Ball possession",
"period": "1ST",
"category": "Possession",
"away_team": "64%",
"home_team": "36%"
},
{
"type": "Ball possession",
"period": "2ND",
"category": "Possession",
"away_team": "37%",
"home_team": "63%"
},
{
"type": "Ball possession",
"period": "ALL",
"category": "Possession",
"away_team": "50%",
"home_team": "50%"
},
{
"type": "Big chances",
"period": "1ST",
"category": "Shots extra",
"away_team": "2",
"home_team": "1"
},
{
"type": "Big chances",
"period": "2ND",
"category": "Shots extra",
"away_team": "1",
"home_team": "4"
},
{
"type": "Big chances",
"period": "ALL",
"category": "Shots extra",
"away_team": "3",
"home_team": "5"
},
{
"type": "Big chances missed",
"period": "1ST",
"category": "Shots extra",
"away_team": "0",
"home_team": "1"
},
{
"type": "Big chances missed",
"period": "2ND",
"category": "Shots extra",
"away_team": "1",
"home_team": "4"
},
{
"type": "Big chances missed",
"period": "ALL",
"category": "Shots extra",
"away_team": "1",
"home_team": "5"
},
{
"type": "Blocked shots",
"period": "1ST",
"category": "Shots",
"away_team": "3",
"home_team": "2"
},
{
"type": "Blocked shots",
"period": "2ND",
"category": "Shots",
"away_team": "0",
"home_team": "5"
},
{
"type": "Blocked shots",
"period": "ALL",
"category": "Shots",
"away_team": "3",
"home_team": "7"
},
{
"type": "Clearances",
"period": "1ST",
"category": "Defending",
"away_team": "5",
"home_team": "6"
},
{
"type": "Clearances",
"period": "2ND",
"category": "Defending",
"away_team": "9",
"home_team": "2"
},
{
"type": "Clearances",
"period": "ALL",
"category": "Defending",
"away_team": "14",
"home_team": "8"
},
{
"type": "Corner kicks",
"period": "1ST",
"category": "TVData",
"away_team": "3",
"home_team": "1"
},
{
"type": "Corner kicks",
"period": "2ND",
"category": "TVData",
"away_team": "1",
"home_team": "4"
},
{
"type": "Corner kicks",
"period": "ALL",
"category": "TVData",
"away_team": "4",
"home_team": "5"
},
{
"type": "Counter attack goals",
"period": "1ST",
"category": "Shots extra",
"away_team": "1",
"home_team": "0"
},
{
"type": "Counter attack goals",
"period": "2ND",
"category": "Shots extra",
"away_team": "0",
"home_team": "0"
},
{
"type": "Counter attack goals",
"period": "ALL",
"category": "Shots extra",
"away_team": "1",
"home_team": "0"
},
{
"type": "Counter attacks",
"period": "1ST",
"category": "Shots extra",
"away_team": "2",
"home_team": "0"
},
{
"type": "Counter attacks",
"period": "2ND",
"category": "Shots extra",
"away_team": "0",
"home_team": "0"
},
{
"type": "Counter attacks",
"period": "ALL",
"category": "Shots extra",
"away_team": "2",
"home_team": "0"
},
{
"type": "Counter attack shots",
"period": "1ST",
"category": "Shots extra",
"away_team": "1",
"home_team": "0"
},
{
"type": "Counter attack shots",
"period": "2ND",
"category": "Shots extra",
"away_team": "0",
"home_team": "0"
},
{
"type": "Counter attack shots",
"period": "ALL",
"category": "Shots extra",
"away_team": "1",
"home_team": "0"
},
{
"type": "Crosses",
"period": "1ST",
"category": "Passes",
"away_team": "1/5 (20%)",
"home_team": "3/8 (38%)"
},
{
"type": "Crosses",
"period": "2ND",
"category": "Passes",
"away_team": "0/1 (0%)",
"home_team": "7/18 (39%)"
},
{
"type": "Crosses",
"period": "ALL",
"category": "Passes",
"away_team": "1/6 (17%)",
"home_team": "10/26 (38%)"
},
{
"type": "Dribbles",
"period": "1ST",
"category": "Duels",
"away_team": "3/6 (50%)",
"home_team": "1/3 (33%)"
},
{
"type": "Dribbles",
"period": "2ND",
"category": "Duels",
"away_team": "0/2 (0%)",
"home_team": "0/1 (0%)"
},
{
"type": "Dribbles",
"period": "ALL",
"category": "Duels",
"away_team": "3/8 (38%)",
"home_team": "1/4 (25%)"
},
{
"type": "Duels won",
"period": "1ST",
"category": "Duels",
"away_team": "22",
"home_team": "26"
},
{
"type": "Duels won",
"period": "2ND",
"category": "Duels",
"away_team": "22",
"home_team": "23"
},
{
"type": "Duels won",
"period": "ALL",
"category": "Duels",
"away_team": "44",
"home_team": "49"
},
{
"type": "Fouls",
"period": "ALL",
"category": "TVData",
"away_team": "9",
"home_team": "10"
},
{
"type": "Free kicks",
"period": "1ST",
"category": "TVData",
"away_team": "3",
"home_team": "5"
},
{
"type": "Free kicks",
"period": "2ND",
"category": "TVData",
"away_team": "7",
"home_team": "3"
},
{
"type": "Free kicks",
"period": "ALL",
"category": "TVData",
"away_team": "10",
"home_team": "8"
},
{
"type": "Goalkeeper saves",
"period": "1ST",
"category": "Shots extra",
"away_team": "1",
"home_team": "1"
},
{
"type": "Goalkeeper saves",
"period": "2ND",
"category": "Shots extra",
"away_team": "2",
"home_team": "2"
},
{
"type": "Goalkeeper saves",
"period": "ALL",
"category": "Shots extra",
"away_team": "3",
"home_team": "3"
},
{
"type": "Goal kicks",
"period": "1ST",
"category": "TVData",
"away_team": "4",
"home_team": "8"
},
{
"type": "Goal kicks",
"period": "2ND",
"category": "TVData",
"away_team": "8",
"home_team": "1"
},
{
"type": "Goal kicks",
"period": "ALL",
"category": "TVData",
"away_team": "12",
"home_team": "9"
},
{
"type": "Interceptions",
"period": "1ST",
"category": "Defending",
"away_team": "0",
"home_team": "0"
},
{
"type": "Interceptions",
"period": "2ND",
"category": "Defending",
"away_team": "3",
"home_team": "1"
},
{
"type": "Interceptions",
"period": "ALL",
"category": "Defending",
"away_team": "3",
"home_team": "1"
},
{
"type": "Long balls",
"period": "1ST",
"category": "Passes",
"away_team": "17/41 (41%)",
"home_team": "16/43 (37%)"
},
{
"type": "Long balls",
"period": "2ND",
"category": "Passes",
"away_team": "21/54 (39%)",
"home_team": "27/50 (54%)"
},
{
"type": "Long balls",
"period": "ALL",
"category": "Passes",
"away_team": "38/95 (40%)",
"home_team": "43/93 (46%)"
},
{
"type": "Offsides",
"period": "1ST",
"category": "TVData",
"away_team": "0",
"home_team": "0"
},
{
"type": "Offsides",
"period": "2ND",
"category": "TVData",
"away_team": "0",
"home_team": "1"
},
{
"type": "Offsides",
"period": "ALL",
"category": "TVData",
"away_team": "0",
"home_team": "1"
},
{
"type": "Passes",
"period": "1ST",
"category": "Passes",
"away_team": "289",
"home_team": "155"
},
{
"type": "Passes",
"period": "2ND",
"category": "Passes",
"away_team": "192",
"home_team": "314"
},
{
"type": "Passes",
"period": "ALL",
"category": "Passes",
"away_team": "481",
"home_team": "469"
},
{
"type": "Possession lost",
"period": "1ST",
"category": "Duels",
"away_team": "68",
"home_team": "71"
},
{
"type": "Possession lost",
"period": "2ND",
"category": "Duels",
"away_team": "72",
"home_team": "77"
},
{
"type": "Possession lost",
"period": "ALL",
"category": "Duels",
"away_team": "140",
"home_team": "148"
},
{
"type": "Shots inside box",
"period": "1ST",
"category": "Shots extra",
"away_team": "4",
"home_team": "5"
},
{
"type": "Shots inside box",
"period": "2ND",
"category": "Shots extra",
"away_team": "2",
"home_team": "8"
},
{
"type": "Shots inside box",
"period": "ALL",
"category": "Shots extra",
"away_team": "6",
"home_team": "13"
},
{
"type": "Shots off target",
"period": "1ST",
"category": "Shots",
"away_team": "5",
"home_team": "3"
},
{
"type": "Shots off target",
"period": "2ND",
"category": "Shots",
"away_team": "0",
"home_team": "5"
},
{
"type": "Shots off target",
"period": "ALL",
"category": "Shots",
"away_team": "5",
"home_team": "8"
},
{
"type": "Shots on target",
"period": "1ST",
"category": "Shots",
"away_team": "3",
"home_team": "1"
},
{
"type": "Shots on target",
"period": "2ND",
"category": "Shots",
"away_team": "2",
"home_team": "2"
},
{
"type": "Shots on target",
"period": "ALL",
"category": "Shots",
"away_team": "5",
"home_team": "3"
},
{
"type": "Shots outside box",
"period": "1ST",
"category": "Shots extra",
"away_team": "7",
"home_team": "1"
},
{
"type": "Shots outside box",
"period": "2ND",
"category": "Shots extra",
"away_team": "0",
"home_team": "4"
},
{
"type": "Shots outside box",
"period": "ALL",
"category": "Shots extra",
"away_team": "7",
"home_team": "5"
},
{
"type": "Tackles",
"period": "1ST",
"category": "Defending",
"away_team": "4",
"home_team": "7"
},
{
"type": "Tackles",
"period": "2ND",
"category": "Defending",
"away_team": "8",
"home_team": "6"
},
{
"type": "Tackles",
"period": "ALL",
"category": "Defending",
"away_team": "12",
"home_team": "13"
},
{
"type": "Throw-ins",
"period": "1ST",
"category": "TVData",
"away_team": "10",
"home_team": "6"
},
{
"type": "Throw-ins",
"period": "2ND",
"category": "TVData",
"away_team": "4",
"home_team": "14"
},
{
"type": "Throw-ins",
"period": "ALL",
"category": "TVData",
"away_team": "14",
"home_team": "20"
},
{
"type": "Total shots",
"period": "1ST",
"category": "Shots",
"away_team": "11",
"home_team": "6"
},
{
"type": "Total shots",
"period": "2ND",
"category": "Shots",
"away_team": "2",
"home_team": "12"
},
{
"type": "Total shots",
"period": "ALL",
"category": "Shots",
"away_team": "13",
"home_team": "18"
},
{
"type": "Yellow cards",
"period": "1ST",
"category": "TVData",
"away_team": "0",
"home_team": "0"
},
{
"type": "Yellow cards",
"period": "2ND",
"category": "TVData",
"away_team": "2",
"home_team": "1"
},
{
"type": "Yellow cards",
"period": "ALL",
"category": "TVData",
"away_team": "2",
"home_team": "1"
}
]
}
]