Matches Statistics
This endpoint allows you to retrieve the statistics from matches.
Types of the statistics: Tackles won, Goals prevented, Shots outside box, Expected goals, Through balls, Counter attacks, Shots inside box, Dribbles, Offsides, Red cards, Penalty saves, Passes, Timeouts, Counter attack shots, Interceptions, Yellow cards, Big chances, Shots on target, Shots off target, Big saves, Errors lead to a shot, Free kicks, Fouls, Recoveries, Errors lead to a goal, Fouled in final third, High claims, Clearances, Throw-ins, Blocked shots, Crosses, Aerials won, Touches in penalty area, Goal kicks, Hit woodwork, Ball possession, Counter attack goals, Accurate passes, Duels won, Total tackles, Dispossessed, Final third entries, Corner kicks, Goalkeeper saves, Final third phase, Aerial duels, Total shots, Tackles, Punches, Duels, Total saves, Expected assists, Big chances scored, Ground duels, Possession lost, Big chances missed, 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"
}
]
}
]