SportsDataIO · JSON Structure
Sportsdataio Nfl Structure
JSON structure documentation for SportsDataIO NFL API data types
Type:
Properties: 0
Sports DataStatisticsLive ScoresFantasy SportsOddsNFLNBAMLBNHLSoccer
SportsDataIO NFL API Structure is a JSON Structure definition published by SportsDataIO.
Meta-schema:
JSON Structure
{
"name": "SportsDataIO NFL API Structure",
"description": "JSON structure documentation for SportsDataIO NFL API data types",
"version": "1.0",
"sport": "NFL",
"baseUrl": "https://api.sportsdata.io/v3/nfl",
"structures": [
{
"name": "Season",
"description": "NFL season information",
"fields": [
{"name": "Season", "type": "integer", "required": true, "description": "Season year (e.g., 2025)"},
{"name": "SeasonType", "type": "integer", "required": true, "description": "1=Preseason, 2=Regular Season, 3=Postseason"},
{"name": "Week", "type": "integer", "required": false, "description": "Current week of season"},
{"name": "StartDate", "type": "string", "required": false, "description": "Season start date"},
{"name": "EndDate", "type": "string", "required": false, "description": "Season end date"}
]
},
{
"name": "Team",
"description": "NFL team information",
"fields": [
{"name": "TeamID", "type": "integer", "required": true, "description": "Unique team identifier"},
{"name": "Key", "type": "string", "required": true, "description": "Team abbreviation (e.g., NE, GB, SEA)"},
{"name": "Active", "type": "boolean", "required": true, "description": "Whether team is currently active"},
{"name": "City", "type": "string", "required": true, "description": "Team city"},
{"name": "Name", "type": "string", "required": true, "description": "Team name (e.g., Patriots, Packers)"},
{"name": "Conference", "type": "string", "required": true, "description": "AFC or NFC"},
{"name": "Division", "type": "string", "required": true, "description": "Division name (East, West, North, South)"},
{"name": "FullName", "type": "string", "required": false, "description": "Full team name (City + Name)"},
{"name": "StadiumID", "type": "integer", "required": false, "description": "Home stadium ID"},
{"name": "HeadCoach", "type": "string", "required": false, "description": "Head coach name"}
]
},
{
"name": "Game",
"description": "NFL game/score information",
"fields": [
{"name": "GameKey", "type": "string", "required": true, "description": "Unique game key"},
{"name": "GameID", "type": "integer", "required": true, "description": "Unique game identifier"},
{"name": "Season", "type": "integer", "required": true, "description": "Season year"},
{"name": "SeasonType", "type": "integer", "required": true, "description": "Season type"},
{"name": "Week", "type": "integer", "required": true, "description": "Week number"},
{"name": "Date", "type": "string", "required": true, "description": "Game date and time"},
{"name": "AwayTeam", "type": "string", "required": true, "description": "Away team abbreviation"},
{"name": "HomeTeam", "type": "string", "required": true, "description": "Home team abbreviation"},
{"name": "AwayScore", "type": "integer", "required": false, "description": "Away team final score"},
{"name": "HomeScore", "type": "integer", "required": false, "description": "Home team final score"},
{"name": "Status", "type": "string", "required": true, "description": "Game status (Scheduled, InProgress, Final, Canceled)"},
{"name": "Quarter", "type": "string", "required": false, "description": "Current quarter"},
{"name": "TimeRemaining", "type": "string", "required": false, "description": "Time remaining in current quarter"},
{"name": "OverUnder", "type": "number", "required": false, "description": "Over/under total betting line"},
{"name": "PointSpread", "type": "number", "required": false, "description": "Point spread (negative = home favored)"},
{"name": "HomeMoneyLine", "type": "integer", "required": false, "description": "Home team moneyline odds"},
{"name": "AwayMoneyLine", "type": "integer", "required": false, "description": "Away team moneyline odds"}
]
},
{
"name": "PlayerGame",
"description": "NFL player statistics for a single game",
"fields": [
{"name": "PlayerID", "type": "integer", "required": true, "description": "Unique player identifier"},
{"name": "Name", "type": "string", "required": true, "description": "Player full name"},
{"name": "Team", "type": "string", "required": true, "description": "Team abbreviation"},
{"name": "Position", "type": "string", "required": true, "description": "Player position (QB, RB, WR, TE, etc.)"},
{"name": "FantasyPoints", "type": "number", "required": false, "description": "Standard fantasy points scored"},
{"name": "FantasyPointsPPR", "type": "number", "required": false, "description": "PPR fantasy points scored"},
{"name": "PassingYards", "type": "number", "required": false, "description": "Passing yards (QB)"},
{"name": "PassingTouchdowns", "type": "number", "required": false, "description": "Passing TDs (QB)"},
{"name": "Interceptions", "type": "number", "required": false, "description": "Interceptions thrown (QB)"},
{"name": "RushingYards", "type": "number", "required": false, "description": "Rushing yards"},
{"name": "RushingTouchdowns", "type": "number", "required": false, "description": "Rushing TDs"},
{"name": "Receptions", "type": "number", "required": false, "description": "Receptions (PPR relevant)"},
{"name": "ReceivingYards", "type": "number", "required": false, "description": "Receiving yards"},
{"name": "ReceivingTouchdowns", "type": "number", "required": false, "description": "Receiving TDs"}
]
}
]
}