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

Raw ↑
{
  "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"}
      ]
    }
  ]
}