Matches Statistics
This endpoint allows you to retrieve the statistics from matches.
Types of the statistics: Punts, Passing touchdowns, First downs, Gross yards passing, Interceptions thrown, First downs by rushing, Average yards per punt, Field goals, Touchdowns, Red zone efficiency, Fumbles lost, First downs by passing, Fumbles, Penalties, Rushing yards, Total yards, Third down efficiency, Net yards passing, Yards penalized, First downs by penalty, Time of Possession, Turnovers.
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://american-football.sportdevs.com/matches-statistics?match_id=eq.{match_id}
Query Parameters
- match_id integer
Default value:
eq.2
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
matches-live.id
. - statistics jsonb
The statistics of the match
[
{
"match_id": 2,
"statistics": [
{
"type": "Average yards per punt",
"period": "ALL",
"category": "Punting",
"away_team": "37.333",
"home_team": "38.714"
},
{
"type": "Field goals",
"period": "ALL",
"category": "Attacking",
"away_team": "2/2",
"home_team": "1/1"
},
{
"type": "First downs",
"period": "ALL",
"category": "Downs",
"away_team": "22",
"home_team": "12"
},
{
"type": "First downs by passing",
"period": "ALL",
"category": "Downs",
"away_team": "6",
"home_team": "7"
},
{
"type": "First downs by penalty",
"period": "ALL",
"category": "Downs",
"away_team": "1",
"home_team": "4"
},
{
"type": "First downs by rushing",
"period": "ALL",
"category": "Downs",
"away_team": "12",
"home_team": "4"
},
{
"type": "Fumbles",
"period": "ALL",
"category": "Penalty",
"away_team": "2",
"home_team": "3"
},
{
"type": "Fumbles lost",
"period": "ALL",
"category": "Penalty",
"away_team": "0",
"home_team": "1"
},
{
"type": "Gross yards passing",
"period": "ALL",
"category": "Passing",
"away_team": "105",
"home_team": "218"
},
{
"type": "Interceptions thrown",
"period": "ALL",
"category": "Passing",
"away_team": "0",
"home_team": "0"
},
{
"type": "Net yards passing",
"period": "ALL",
"category": "Passing",
"away_team": "105",
"home_team": "218"
},
{
"type": "Passing touchdowns",
"period": "ALL",
"category": "Passing",
"away_team": "1",
"home_team": "1"
},
{
"type": "Penalties",
"period": "ALL",
"category": "Penalty",
"away_team": "1",
"home_team": "9"
},
{
"type": "Punts",
"period": "ALL",
"category": "Punting",
"away_team": "6",
"home_team": "7"
},
{
"type": "Red zone efficiency",
"period": "ALL",
"category": "Attacking",
"away_team": "6/6",
"home_team": "2/2"
},
{
"type": "Rushing yards",
"period": "ALL",
"category": "Attacking",
"away_team": "265",
"home_team": "31"
},
{
"type": "Third down efficiency",
"period": "ALL",
"category": "Downs",
"away_team": "4/14 (28%)",
"home_team": "4/17 (23%)"
},
{
"type": "Time of Possession",
"period": "ALL",
"category": "Attacking",
"away_team": "28:37",
"home_team": "31:23"
},
{
"type": "Total yards",
"period": "ALL",
"category": "Attacking",
"away_team": "370",
"home_team": "249"
},
{
"type": "Touchdowns",
"period": "ALL",
"category": "Attacking",
"away_team": "5",
"home_team": "2"
},
{
"type": "Turnovers",
"period": "ALL",
"category": "Attacking",
"away_team": "0",
"home_team": "1"
},
{
"type": "Yards penalized",
"period": "ALL",
"category": "Penalty",
"away_team": "15",
"home_team": "92"
}
]
}
]