Matches Statistics
This endpoint allows you to retrieve the statistics from matches.
Types of the statistics: Punts, Passing touchdowns, First downs, Gross yards passing, Field goals, Fumbles lost, Average rushing yards per attempt, Average passing yards per attempt, Rushing yards, Total yards, Third down efficiency, Red zone passing attempts, Yards penalized, First downs by penalty, Rushing attempts, Interceptions thrown, First downs by rushing, Average yards per punt, Touchdowns, Red zone efficiency, First downs by passing, Fumbles, Penalties, Average yards per play, Net yards passing, Red zone rushing attempts, 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.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"
}
]
}
]