In this article we will explain our main Season Types, such as pre-season and regular-season, that are shared between sports, and also those unique cases applicable to each sport.
Season Types By Sport - Table
See the table below for what season types exist for which sports.
The numerical values correspond to the SeasonType field used in many Game-related tables.
| Sport |
1 - Regular (REG) |
2 -Pre-Season (PRE) |
3 - Post-Season (POST) |
5 - All-Star (STAR) |
6 - Exhibition (EXH) |
| NFL | Yes | Yes | Yes | Yes | - |
| MLB | Yes | Yes | Yes | Yes | - |
| NBA | Yes | Yes | Yes | Yes | Yes |
| NHL | Yes | Yes | Yes | Yes | - |
| CFB | Yes | - | Yes | - | - |
| CBB | Yes | - | Yes | - | - |
| Golf | - | - | - | - | - |
| NASCAR | - | - | - | - | - |
| Soccer | - | - | - | - | - |
| MMA | - | - | - | - | - |
| CWBB | Yes | Yes | Yes | - | - |
| Tennis | - | - | - | - | - |
| LoL | - | - | - | - | - |
| CS:GO | - | - | - | - | - |
Important notes:
- For all sports, seasons are called by year, e.g. 2023.
- Sports with no season types are called using the year and the year only.
- When a season type is available but is not specified, the regular season will be returned.
- When a season type is available, it can be specified immediately after the year, e.g. 2023PRE.
Season Type Descriptions
Pre-season (PRE)
These contain pre-season games.
Example call: 2023PRE
Regular Season (REG)
All regular season games.
NBA note: The in-season tournament games with the exception of the final are tagged as regular season, as they count towards the regular season record. The final is tagged as EXH, type six, as it is purely an exhibition game. Both the final and the other in-season tournament games are marked with an additional flag: InseasonTournament will be set to True.
As mentioned, when a season year is called without any parameter, it is effectively calling the regular season and thus the same as calling REG.
Example call: 2023
Example call: 2023REG
Post-season (POST)
Post-season games, usually part of playoffs.
For more information on how games are handled within the post-season, see this dedicated guide.
Example call: 2023POST
All-Star (STAR)
Only returns All-Star game(s) for the season in question.
Example call: 2023STAR
Exhibition (EXH)
Only returns exhibition game(s) for the season in question. At this moment this is only used for NBA's in-season tournament final game, which does not count towards regular season standings. On the day of the final game, this will be the season type, before reverting back to 2023REG the following day.
Example call: 2023EXH
What to expect when calling Post Season data with SportsDataIO
The season parameter for the NFL, NBA, MLB, NHL playoffs, the College Football bowl games, and the Men's College Basketball Tournament will be the same as the regular season except the season type (POST) will be added at the end.
For example, in the NFL regular season for 2021, the season parameter used is 2021 or 2021REG. For the 2021 playoffs, the season parameter would only be 2021POST. The same logic will apply to future seasons.
When to Expect the Current Season Endpoint Transition with SportsDataIO
NFL: Early March
MLB: Early January
NBA: after the postseason end date
NHL: after the postseason end date
CFB: Late January
CBB: at the start of the new season
Comments
0 comments
Article is closed for comments.