Matches Statistics
This endpoint allows you to retrieve the statistics from matches.
Types of the statistics: 7 meters, Wing goals, Technical faults, Fastbreak goals, Goal streak, Red cards, Steals, Shorthanded goals, Shooting efficiency, Saves, 2 min penalty, 6m goals, 9m goals, Timeouts, Goals in powerplay, Yellow cards.
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://handball.sportdevs.com/matches-statistics?match_id=eq.{match_id}
Query Parameters
- match_id integer
Default value:
eq.200
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": 200,
"statistics": [
{
"type": "2 min penalty",
"period": "1ST",
"category": "Penalty",
"away_team": "2",
"home_team": "2"
},
{
"type": "2 min penalty",
"period": "ALL",
"category": "Penalty",
"away_team": "2",
"home_team": "2"
},
{
"type": "7 meters",
"period": "1ST",
"category": "Goals",
"away_team": "0/0 (0%)",
"home_team": "0/0 (0%)"
},
{
"type": "7 meters",
"period": "2ND",
"category": "Goals",
"away_team": "2/2 (100%)",
"home_team": "1/1 (100%)"
},
{
"type": "7 meters",
"period": "ALL",
"category": "Goals",
"away_team": "2/2 (100%)",
"home_team": "1/1 (100%)"
},
{
"type": "Goals in powerplay",
"period": "1ST",
"category": "Goals extra",
"away_team": "1",
"home_team": "3"
},
{
"type": "Goals in powerplay",
"period": "ALL",
"category": "Goals extra",
"away_team": "1",
"home_team": "3"
},
{
"type": "Goal streak",
"period": "1ST",
"category": "Goals extra",
"away_team": "2",
"home_team": "6"
},
{
"type": "Goal streak",
"period": "2ND",
"category": "Goals extra",
"away_team": "3",
"home_team": "3"
},
{
"type": "Goal streak",
"period": "ALL",
"category": "Goals extra",
"away_team": "3",
"home_team": "6"
},
{
"type": "Shorthanded goals",
"period": "1ST",
"category": "Goals extra",
"away_team": "1",
"home_team": "2"
},
{
"type": "Shorthanded goals",
"period": "ALL",
"category": "Goals extra",
"away_team": "1",
"home_team": "2"
},
{
"type": "Timeouts",
"period": "1ST",
"category": "Other",
"away_team": "1",
"home_team": "1"
},
{
"type": "Timeouts",
"period": "2ND",
"category": "Other",
"away_team": "1",
"home_team": "1"
},
{
"type": "Timeouts",
"period": "ALL",
"category": "Other",
"away_team": "2",
"home_team": "2"
},
{
"type": "Yellow cards",
"period": "1ST",
"category": "Penalty",
"away_team": "0",
"home_team": "1"
},
{
"type": "Yellow cards",
"period": "ALL",
"category": "Penalty",
"away_team": "0",
"home_team": "1"
}
]
}
]