Season statistics

GET https://soccer.sportmonks.com/api/v2.0/seasons/:SEASON_ID?include=stats

Introduction

Responses of the Seasons endpoint are limited to Seasons of the Leagues available in the Plan you are subscribed to. Responses provide you details about for example the Season ID, Name, League ID, Year and if the Season is Active Yes or No.

One of the main features of the Seasons endpoint is the ability to retrieve full Season Games, (history) Fixtures, Results or Upcoming Fixtures. This can be achieved by using the proper Includes which are listed in the section Endpoint Details.

In this example, we've included the overall season statistics. We calculate a wide range of stats for you like the number of matches, matches played, goals scored, clean sheets, yellow cards, average goal per minute, etc

Pagination

NO - Indicates if this endpoint contains pagination.

Nested Includes

2 - You can add a maximum of 2 levels of nested includes.

Includes Options

league stages rounds upcoming results groups goalscorers cardscorers assistscorers aggregatedGoalscorers aggregatedCardscorers aggregatedAssistscorers stage round fixtures

Request Params

RESPONSES

status: OK

{"data":{"id":17141,"name":"2020/2021","league_id":501,"is_current_season":true,"current_round_id":194996,"current_stage_id":77447501,"stats":{"data":{"id":2203,"season_id":17141,"league_id":501,"number_of_clubs":12,"number_of_matches":198,"number_of_matches_played":169,"number_of_goals":417,"matches_both_teams_scored":67,"number_of_yellowcards":489,"number_of_yellowredcards":12,"number_of_redcards":21,"avg_goals_per_match":2.47,"avg_yellowcards_per_match":2.89,"avg_yellowredcards_per_match":0.07,"avg_redcards_per_match":0.12,"team_with_most_goals_id":62,"team_with_most_goals_number":69,"team_with_most_conceded_goals_id":246,"team_with_most_conceded_goals_number":53,"team_with_most_goals_per_match_id":62,"team_with_most_goals_per_match_number":2.38,"season_topscorer_id":96792,"season_topscorer_number":15,"season_assist_topscorer_id":129857,"season_assist_topscorer_number":9,"team_most_cleansheets_id":273,"team_most_cleansheets_number":14,"goals_scored_minutes":{"0-15":"11.51%","15-30":"19.42%","30-45":"14.87%","45-60":"18.23%","60-75":"16.55%","75-90":"22.06%"},"goalkeeper_most_cleansheets_id":1265,"goalkeeper_most_cleansheets_number":14,"goal_scored_every_minutes":36,"btts":39.64,"goal_line":{"over":{"0_5":91.72,"1_5":72.78,"2_5":44.38,"3_5":21.3,"4_5":10.06,"5_5":4.14},"under":{"0_5":8.28,"1_5":27.22,"2_5":55.62,"3_5":78.7,"4_5":89.94,"5_5":95.86}},"avg_corners_per_match":9.79,"team_most_corners_count":198,"team_most_corners_id":62,"goals_conceded":{"all":1.23,"home":1.23,"away":1.24},"goals_scored":{"all":1.23,"home":1.24,"away":1.23},"win_percentage":{"all":38.46,"home":37.28,"away":39.64},"defeat_percentage":{"all":38.46,"home":39.64,"away":37.28},"draw_percentage":23.08,"avg_homegoals_per_match":1.24,"avg_awaygoals_per_match":1.23,"avg_player_rating":6.68,"updated_at":{"date":"2021-02-14 13:55:03.000000","timezone_type":3,"timezone":"UTC"}}}},"meta":{"subscription":{"started_at":{"date":"2017-03-20 21:02:56.000000","timezone_type":3,"timezone":"UTC"},"trial_ends_at":null,"ends_at":null},"plan":{"name":"Free Plan","price":"0.00","request_limit":"3,1"},"sports":[{"id":1,"name":"Soccer","current":true},{"id":6,"name":"Cricket","current":false}]}}