nfl statistics feeds · updated 08.03.12 ! 6!sportsdata nfl statistics feeds ! stats list –...

Updated 08.03.12

1 SPORTSDATA NFL STATISTICS FEEDS

NFL Statistics Feeds

2012-13 Season

Updated 08.03.12


Table of Contents

Overview .................................................................................................................................................. 3 Stats List – Game Information ............................................................................................................... 4 Stats List – Play-by-Play Information .................................................................................................... 6 Stats List – Player Statistics .................................................................................................................. 7 Stats List – Standings Information ...................................................................................................... 12 Stats List – Team Information ............................................................................................................. 14 Stats List – Team Statistics ................................................................................................................. 15 Boxscore Feed – Details ...................................................................................................................... 21 Depth Chart Feed – Details .................................................................................................................. 24 Game Roster Feed – Details ................................................................................................................ 28 Injuries Feed – Details .......................................................................................................................... 31 Play Summary Feed – Details .............................................................................................................. 34 Play-by-Play Feed – Details ................................................................................................................. 37 Season Schedule Feed – Details ......................................................................................................... 40 Seasonal Statistics Feed – Details ...................................................................................................... 43 Standings Feed – Details ...................................................................................................................... 57 Game Statistics Feed – Details ............................................................................................................ 61 Game Summary Feed – Details ........................................................................................................... 77 Team Hierarchy Feed – Details ............................................................................................................ 81 Team Roster Feed – Details ................................................................................................................. 83 Weekly Schedule Feed – Details ......................................................................................................... 86

Updated 08.03.12


Overview The Gold Standard in Real-time Sports Stats SportsData’s team of data-entry experts crunch play-by-play information for packaging and delivery using new technology that results in the fastest updates in the industry. And because our clients demand depth, no statistic is too small. We are focused on:

Accuracy. From instant play-by-play to in-game clean up, official and final we maintain the highest standard in data accuracy.

Simplicity. We deliver your sports data feed to customer specifications, or in any industry-standard format; our flexibility makes your transition fast and seamless.

Speed. We offer true real-time delivery of data using highly-optimized publishing techniques.

Service. We approach every client relationship as an opportunity for a long-term partnership, and will work tirelessly for you from Day 1.

NFL Statistics Feeds

We package our comprehensive stats collection into the following feeds, each focused on serving specific information needs.

Boxscore – top-level team scores by quarter

Depth Chart – team depth chart rankings for every position

Game Roster – player information for each match-up, including height/weight, jersey number, position and injury status

Game Statistics – detailed game stats at the player and team level, including extensive offense, defense and special teams breakouts

Game Summary – team comparisons for all major stat categories within a game, as well as deeper insights such as third/fourth down and red zone efficiency

Injuries – detailed information on injuries, including the injury type and player game and practice status

Play Summary – real-time play detail for every game play

Play-by-Play – detailed, real-time stats on every team possession and game event

Season Schedule – provides the date, time, location and other event details for every match-up, for the season, as well as links to the seven other feeds

Seasonal Statistics – detailed season stats at the team level and player level, including extensive offense, defense and special teams breakouts

Standings – detailed information on wins and losses, broken down by conference, division and various scenarios

Team Hierarchy – conference, division, and team identification and association information

Team Roster – player information for a team, including height/weight, jersey number, position and injury status

Weekly Schedule – provides the date, time, location and other event details for every match-up, for the week, as well as links to the seven other feeds

Updated 08.03.12


Stats List – Game Information

Stat

Boxscore

Depth Chart

Gam

e Roster

Injuries

Play Sum

mary

Play-by-Play

Season Schedule

Seasonal Statistics

Standings

Gam

e Statistics

Gam

e Sum

mary

Team

Hierarchy

Team

Roster

Weekly

Schedule

Away rotation X X Away team city X X X X X X X X X X Away team id X X X X X X X X X X Away team name X X X X X X X X Broadcast info, cable X X Broadcast info, Internet X X Broadcast info, network X X Broadcast info, satellite X X Date of game X X X X X X X X X X X Depth charts X Field surface X X X Game clock time X Game number X X Game quarter X Game status X X X X X X X X X X Game type X X Home rotation X X Home team city X X X X X X X X X X Home team id X X X X X X X X X X Home team name X X X X X X X X Humidity X X Player college X X X Player date of birth X Player height X X X Player injury – description (type) X X X

Player injury – game status X X X

Player injury – notes X Player injury – practice status X X X

Player injury – start date X X X Player jersey number X X X X X X X Player names – abbr. X X X Player names – first name X Player names – full X X X X X X X Player names – last name X Player position X X X X X X Player salary X X X Player status X X X X Player weight X X X Points by quarter X Schedules kickoff X X X X X X X X X X X Season X X X Season Type X X X Starting lineups X X Total points scored by team X X

Venue address X X X Venue capacity X X X

Updated 08.03.12


Venue city X X X Venue country X X X Venue name X X X Venue state X X X Venue type X X X Venue zip X X X Weather condition X X Weather temperature X X Week X X Wind direction X X Wind speed X X

Updated 08.03.12


Stats List – Play-by-Play Information

Stat

Boxscore

Depth Chart

Gam

e Roster

Injuries

Play Sum

mary

Play-by-Play

Season Schedule

Seasonal Statistics

Standings

Gam

e Statistics

Gam

e Sum

mary

Team

Hierarchy

Team

Roster

Weekly

Schedule

Down X X Drive start, game clock time X X

Location, side of field X X Location, yard line X X Non-play event, game clock time X X

Non-play event, type X X Play start, game clock time X X

Play type X X Players participating – jersey number X X

Players participating – name X X

Players participating – position X X

Players participating – team X X

Points by quarter X Quarter X X Remaining challenges X Remaining timeouts X Scoring drives – amount of pts scored X X

Scoring drives – description X X

Scoring Drives – players involved X X

Scoring drives – quarter X X Scoring drives – team X X Scoring drives – time of game X X

Scoring drives – type of score X X

Sequence number X Summary of play X X Team possession X X Total points scored X X Yards to first down X X

Updated 08.03.12


Stats List – Player Statistics

Stat

Boxscore

Depth Chart

Gam

e Roster

Injuries

Play Sum

mary

Play-by-Play

Season Schedule

Seasonal Statistics

Standings

Gam

e Statistics

Gam

e Sum

mary

Team

Hierarchy

Team

Roster

Weekly

Schedule

Blocked field goal returns - 10+ yards X X X





Blocked field goal returns – average return X X X

Blocked field goal returns - longest ret. X X X

Blocked field goal returns - returns X X X

Blocked field goal returns - total yards X X X

Blocked field goal returns - touchdowns X X X

Blocked kicks X X X Blocked punt returns - 10+ yards X X X

Blocked punt returns - 20+ yards X X X




Blocked punt returns - average return X X X

Blocked punt returns - longest return X X X

Blocked punt returns - returns X X X

Blocked punt returns - total yards X X X

Blocked punt returns - touchdowns X X X

Extra points - attempted X X X Extra points - blocked X X X Extra points - made X X X Extra points - percent made X X X

Field goal returns - 10+ yards X X X




Field goal returns - 50+ X X X

Updated 08.03.12


yards Field goal returns - average return X X X

Field goal returns - longest return X X X

Field goal returns - returns X X X

Field goal returns - total yards X X X

Field goal returns - touchdowns X X X

Field goals - attempted X X X Field goals - attempted, 1-19 yards X X X

Field goals - attempted, 20-29 yards X X X



Field goals - attempted, 50+ yards X X X

Field goals - blocked X X X Field goals - longest made X X X

Field goals - made X X X Field goals - made, 1-19 yards X X X

Field goals - made, 20-29 yards X X X



Field goals - made, 50+ yards X X X

Field goals - percent made X X X

Fumbles - forced X X X Fumbles - fumbles X X X Fumbles - lost X X X Fumbles - opponent recovery X X X

Fumbles - opponent touchdowns from recovery

X X X

Fumbles - out of bounds X X X Fumbles - own recovery X X X Fumbles - own touchdowns from recovery

X X X

Fumbles - recovered X X X Fumbles - touchdowns X X X Fumbles - yards from opponent recovery X X X

Fumbles - yards from own recovery X X X

Games Played X Games Started X Interceptions - interceptions X X X

Interceptions - longest interception X X X

Interceptions - X X X

Updated 08.03.12


touchdowns from interceptions Interceptions - yards from interceptions X X X

Kickoff returns - 10+ yards X X X





Kickoff returns - average return X X X

Kickoff returns - fair catches X X X

Kickoff returns - longest kick return X X X

Kickoff returns - return yards X X X

Kickoff returns - returns X X X Kickoff returns - touchdowns X X X

Kickoffs - average gross yards X X X

Kickoffs - average net yards X X X

Kickoffs – end zone kicks X X X Kickoffs - gross yards X X X Kickoffs - inside opponents 20 yard line X X X

Kickoffs - kicks X X X Kickoffs - longest kick X X X Kickoffs - net yards X X X Kickoffs - percentage inside opponents 20 yard line

X X X

Kickoffs - percentage touchbacks X X X

Kickoffs - returned X X X Kickoffs - total return yards X X X

Kickoffs - touchbacks X X X Passes defended X X X Passing - 10+ yards X X X Passing - 20+ yards X X X Passing - 30+ yards X X X Passing - 40+ yards X X X Passing - 50+ yards X X X Passing - attempts X X X Passing - avg. yards per pass attempt X X X

Passing - completion percentage X X X

Passing - completions X X X Passing - first downs X X X Passing - interception percentage X X X

Passing - interceptions X X X Passing - longest pass X X X Passing - rating X X X

Updated 08.03.12


Passing - red zone attempts X X X

Passing - sacked X X X Passing - sacked yards lost X X X

Passing - total yards X X X Passing - touchdown percentage X X X

Passing - touchdowns X X X Penalties - first downs X X X Penalties - total penalties X X X Penalties - yards X X X Played X Punt returns - 10+ yards X X X Punt returns - 20+ yards X X X Punt returns - 30+ yards X X X Punt returns - 40+ yards X X X Punt returns - 50+ yards X X X Punt returns - average return X X X

Punt returns - fair catches X X X

Punt returns - longest return X X X

Punt returns - return yards X X X

Punt returns - total returns X X X

Punt returns - touchdowns X X X

Punting - average gross yards X X X

Punting - average net yards X X X

Punting - blocked X X X Punting - gross yards X X X Punting - inside opp 20 yard line X X X

Punting - longest punt X X X Punting - net yards X X X Punting - percent inside opp 20 yard line X X X

Punting - percent touchbacks X X X

Punting - punts X X X Punting - return yards X X X Punting - returned X X X Punting - touchbacks X X X Quarterback hits X X X Receiving - 10+ yards X X X Receiving - 20+ yards X X X Receiving - 30+ yards X X X Receiving - 40+ yards X X X Receiving - 50+ yards X X X Receiving - average reception X X X

Receiving - first downs X X X Receiving - fumbled on reception X X X

Receiving - longest reception X X X

Receiving - receptions X X X

Updated 08.03.12


Receiving - red zone attempts X X X

Receiving - target X X X Receiving - total yards X X X Receiving - touchdowns X X X Receiving - yards after completion X X X

Rushing - 10+ yards X X X Rushing - 20+ yards X X X Rushing - 30+ yards X X X Rushing - 40+ yards X X X Rushing - 50+ yards X X X Rushing - attempts X X X Rushing - average rush X X X Rushing – first down percentage X X X

Rushing - first downs X X X Rushing - fumbled on rush X X X

Rushing - longest rush X X X Rushing - red zone attempts X X X

Rushing - tackled for a safety X X X

Rushing - total yards X X X Rushing - touchdowns X X X Sacks - total sacks X X X Sacks - yards from sacks X X X Safeties - total X X X Started X Tackles - assisted tackles X X X

Tackles - combined tackles X X X

Tackles - tackles for a loss X X X

Tackles - total X X X Touchdowns - field goal return X X X

Touchdowns - fumble return X X X

Touchdowns - interception X X X

Touchdowns - kick return X X X

Touchdowns - other X X X Touchdowns - passing X X X Touchdowns - punt return X X X

Touchdowns - rushing X X X Two point conversion - attempted X X X

Two point conversion - failed X X X

Two point conversion - passing X X X

Two point conversion - receiving X X X

Two point conversion - rushing X X X

Updated 08.03.12


Stats List – Standings Information

Stat

Boxscore

Depth Chart

Gam

e Roster

Injuries

Play Sum

mary

Play-by-Play

Season Schedule

Seasonal Statistics

Standings

Gam

e Statistics

Gam

e Sum

mary

Team

Hierarchy

Team

Roster

Weekly

Schedule

Away losses X Away ties X Away winning perc. X Away wins X Decided by 7 points or fewer, losses X

Decided by 7 points or fewer, ties X

Decided by 7 points or fewer, wins X

Grass losses X Grass ties X Grass winning perc X Grass wins X Home losses X Home ties X Home winning perc X Home wins X In-conference losses X In-conference ties X In-conference winning perc X

In-conference wins X In-division losses X In-division ties X In-division winning perc X In-division wins X Last 5 games, losses X Last 5 games, ties X Last 5 games, wins X Non-conference losses X Non-conference ties X Non-conference winning perc X

Non-conference wins X Overall losses X Overall ties X Overall winning perc X Overall wins X Overtime losses X Overtime ties X Overtime winning perc X Overtime wins X Points against X Points for X Points net X Recent streak X Scored first, losses X Scored first, ties X Scored first, wins X Touchdowns against X

Updated 08.03.12


Touchdowns for X Touchdowns net X Turf losses X Turf ties X Turf winning perc X Turf wins X When leading at half, losses X

When leading at half, ties X When leading at half, wins X

Updated 08.03.12


Stats List – Team Information

Stat

Boxscore

Depth Chart

Gam

e Roster

Injuries

Play Sum

mary

Play-by-Play

Season Schedule

Seasonal Statistics

Standings

Gam

e Statistics

Gam

e Sum

mary

Team

Hierarchy

Team

Roster

Weekly

Schedule

Conference id X X Conference name X X Division id X X Division name X X Team id X X X X X X X X X X X X X Team name X X Team market X X

Updated 08.03.12


Stats List – Team Statistics

Stat

Boxscore

Depth Chart

Gam

e Roster

Injuries

Play Sum

mary

Play-by-Play

Season Schedule

Seasonal Statistics

Standings

Gam

e Statistics

Gam

e Sum

mary

Team

Hierarchy

Team

Roster

Weekly

Schedule

Average gain per offensive play X

Blocked field goal returns - 10+ yards X X





Blocked field goal returns - average return X X

Blocked field goal returns - longest ret. X X

Blocked field goal returns - returns X X

Blocked field goal returns - total yards X X

Blocked field goal returns - touchdowns X X

Blocked kicks X X Blocked punt returns - 10+ yards X X

Blocked punt returns - 20+ yards X X




Blocked punt returns - average return X X

Blocked punt returns - longest return X X

Blocked punt returns - returns X X

Blocked punt returns - total yards X X

Blocked punt returns - touchdowns X X

Extra points - attempted X X X Extra points - attempted by kicking X

Extra points - blocked X X Extra points - made X X X Extra points - made by kicking X

Extra points - percent made X X

Field goal returns - 10+ yards X X


Updated 08.03.12





Field goal returns - average return X X

Field goal returns - longest return X X

Field goal returns - returns X X

Field goal returns - total yards X X

Field goal returns - touchdowns X X

Field goals - attempted X X X Field goals - attempted, 1-19 yards X X

Field goals - attempted, 20-29 yards X X



Field goals - attempted, 50+ yards X X

Field goals - blocked X X X Field goals - longest made X X

Field goals - made X X X Field goals - made, 1-19 yards X X

Field goals - made, 20-29 yards X X



Field goals - made, 50+ yards X X

Field goals - percent made X X

Fourth down conversion - conversion attempts X X X

Fourth down conversion - conversion converted X X X

Fourth down conversion - conversion percentage X X X

Fourth down conversion - converted via a pass X X X

Fourth down conversion - converted via a penalty X X X

Fourth down conversion - converted via a rush X X X

Fumbles - forced X X Fumbles - lost X X X Fumbles - opponent recovery X X

Fumbles - opponent touchdowns from recovery

X X

Fumbles - out of bounds X X Fumbles - own recovery X X Fumbles - own X X

Updated 08.03.12


touchdowns from recovery Fumbles - recovered X X Fumbles - touchdowns X X Fumbles - yards from opponent recovery X X

Fumbles - yards from own recovery X X

Interception - longest interception X X

Interception - touchdowns from interceptions

X X

Interception - yards from interceptions X X X

Kickoff returns - 10+ yards X X





Kickoff returns - average return X X

Kickoff returns - fair catches X X

Kickoff returns - longest kick return X X

Kickoff returns - returns X X X Kickoff returns - touchdowns X X

Kickoff returns - yards X X X Kickoffs - average gross yards X X

Kickoffs - average net yards X X

Kickoffs - average return yards X X

Kickoffs - gross yards X X Kickoffs - inside opponents 20 yard line X X

Kickoffs - kicks X X X Kickoffs - longest kick X X Kickoffs - net yards X X Kickoffs - percentage inside opponents 20 yard line

X X

Kickoffs - percentage touchbacks X X

Kickoffs - returned X X Kickoffs - total return yards X X

Kickoffs - touchbacks X X X Kickoffs – end zone kicks X X X Pass defense X X Passing - 10+ yards X X Passing - 20+ yards X X Passing - 30+ yards X X Passing - 40+ yards X X Passing - 50+ yards X X

Updated 08.03.12


Passing - attempts X X X Passing - average pass X X Passing - completion percentage X X

Passing - completions X X X Passing - first downs X X X Passing - interception percentage X X

Passing - interceptions X X X Passing - longest pass X X Passing - net yards X Passing - rating X X Passing - red zone attempts X X

Passing - sacked X X X Passing - sacked yards lost X X X

Passing - total yards X X X Passing - touchdown percentage X X

Passing - touchdowns X X Penalty first downs X X X Punt returns - 10+ yards X X Punt returns - 20+ yards X X Punt returns - 30+ yards X X Punt returns - 40+ yards X X Punt returns - 50+ yards X X Punt returns - average return X X

Punt returns - fair catches X X

Punt returns - longest return X X

Punt returns - return yards X X X

Punt returns - total returns X X X

Punt returns - touchdowns X X

Punting - average gross yards X X X

Punting - average net yards X X X

Punting - average return yards X X

Punting - blocked X X X Punting - gross yards X X Punting - inside opp. 20 yard line X X

Punting - longest punt X X Punting - net yards X X Punting - percent inside opp. 20 yard line X X

Punting - percent touchbacks X X

Punting - punts X X X Punting - return yards X X Punting - returned X X Punting - touchbacks X X Quarterback hits X X Receiving - 10+ yards X X Receiving - 20+ yards X X

Updated 08.03.12


Receiving - 30+ yards X X Receiving - 40+ yards X X Receiving - 50+ yards X X Receiving - average reception X X

Receiving - first downs X X Receiving - fumbled on reception X X

Receiving - longest reception X X

Receiving - receptions X X Receiving - red zone attempts X X

Receiving - target X X Receiving - total yards X X Receiving - touchdowns X X Receiving - yards after completion X X

Red zone efficiency - red zone attempts X X

Red zone efficiency - red zone conversion percentage

X X

Red zone efficiency - red zone conversions X X

Rushing - 10+ yards X X Rushing - 20+ yards X X Rushing - 30+ yards X X Rushing - 40+ yards X X Rushing - 50+ yards X X Rushing – attempts X X X Rushing - average rush X X X Rushing - first down percentage X X

Rushing - first downs X X X Rushing - fumbled on rush X X

Rushing - longest rush X X Rushing - red zone attempts X X

Rushing - tackled for a safety X X

Rushing - total yards X X X Rushing - touchdowns X X Sacks - total sacks X X Sacks - yards from sacks X X Tackles - assisted tackles X X

Tackles - combined tackles X X

Tackles - tackles for a loss X X

Tackles - total tackles X X Third down conversion - attempts X X X

Third down conversion - converted X X X

Third down conversion - percentage X X X

Third down conversion - via a pass X X X

Third down conversion - via a penalty X X X

Updated 08.03.12


Third down conversion - via a rush X X X

Time of possession X Total first downs X X Total fumbles X X X Total interceptions X X X Total net yards X Total offensive plays X Total penalties X X X Total penalty yards X X X Total return yardage (n/I kickoffs) X X

Total safeties on defense X X Total turnovers X X Touchdowns - field goal return X X X

Touchdowns - fumble return X X X

Touchdowns - interception X X X

Touchdowns - kick return X X X

Touchdowns - other X X Touchdowns - passing X X X Touchdowns - punt return X X X

Touchdowns - rushing X X X Touchdowns - total touchdowns X X

Two point conversion - attempted X X X

Two point conversion - failed X X

Two point conversion - made X

Two point conversion - passing X X

Two point conversion - receiving X X

Two point conversion - rushing X X

Updated 08.03.12


Boxscore Feed – Details

This feed provides key stats on every team and player score.

Element/Attribute/Value Descriptions

File Breakdown – Boxscore Feed Element Attribute Values Description

game Id GUID format Unique ID for a specific game

scheduled Dynamic The date and time of the game

home Dynamic Unique id of home team

away Dynamic Unique id of away team

quarter 1, 2, 3, 4, 5 Game quarter

clock MM:SS Game time

status scheduled The game is scheduled to occur

created We are ready to begin recording actions against a scheduled game

inprogress The game is in progress

complete The game is over, but stat validation is not complete

closed The game is over and stats have been validated

reopened The game stats are in the process of being corrected


clock MM:SS Game time at the start of the play

Child elements: team, scoring_drives

team

id Dynamic Unique id for a specific team

name Dynamic Team name

market Dynamic Team city

remaining_challenges

2, 1, 0 Remaining challenges in the game

remaining_timeouts

3, 2, 1, 0 Remaining timeouts in the game

Child elements: scoring

scoring points Dynamic Total Points scored in the game

Child elements: quarter

quarter

number 1, 2, 3, 4, 5 Quarter number

points Dynamic Points scored in the quarter

scoring_drives This is the root element for each scoring drive.

Child elements: drive

Updated 08.03.12


drive sequence Dynamic The scoring drive sequence number

clock Dynamic The game time the scoring drive began

quarter 1, 2, 3, 4, 5 The quarter when the scoring drive began

team Dynamic The team scoring

Child elements: score

score type Dynamic The type of scoring play (e.g., touchdown)

clock Dynamic The game time of the scoring play

quarter 1, 2, 3, 4, 5 The quarter of the scoring play

points Dynamic The number of points scored

Child elements: summary, links

summary N/A Dynamic The text summary of the scoring play

links N/A Dynamic Root element for each play link; child elements: link

link rel summary Play summary

href Dynamic Link to the specific play

Updated 08.03.12


Boxscore Feed - File Naming Convention

Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/boxscore-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/[year]/[nfl_season]/[nfl_season_week]/[away_team]/[home_team]/boxscore.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [year] = yyyy [nfl_season] = Preseason (PRE), Regular Season (REG), Postseason (PST) [nfl_season_week] = 1 - 17 [format] = xml [home_team], [away_team] = <see schedule feed> Update Timing

This feed will be continually updated as events occur. Copyright

The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.

Updated 08.03.12


Depth Chart Feed – Details

This feed provides team depth chart information for each match-up


File Breakdown – Roster Feed Element Attribute Values Description











Child elements: team

team id Dynamic Unique id for a specific team



Child elements: offense, defense, special teams

offense Root element for position; child elements: position

position name Dynamic Abbreviated position name

desc Dynamic Position description

Child elements: player

player id GUID format Unique player ID

depth Dynamic Player depth number

name_full Dynamic Player full name

position Dynamic Player position

jersey_number Dynamic Player jersey number

status ACT Active

DUP Duplicate

EXE Exempt

IR Injured Reserve

NON Non football related injured reserve

Updated 08.03.12


NWT Not with team

PRA Practice Squad

PUP Physically unable to perform

RET Retired

SUS Suspended

UDF Unsigned draft pick

UFA Unsigned free agent

defense Root element for position; child elements: position









status ACT Active

DUP Duplicate

EXE Exempt

IR Injured Reserve


NWT Not with team

PRA Practice Squad


RET Retired

SUS Suspended



special_teams Root element for position; child elements: position









Updated 08.03.12


status ACT Active

DUP Duplicate

EXE Exempt

IR Injured Reserve


NWT Not with team

PRA Practice Squad


RET Retired

SUS Suspended



Updated 08.03.12


Depth Chart Feed - File Naming Convention

Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/depth_chart-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/[year]/[nfl_season]/[nfl_season_week]/[away_team]/[home_team]/depthchart.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [year] = yyyy [nfl_season] = Preseason (PRE), Regular Season (REG), Postseason (PST) [nfl_season_week] = 1 - 17 [format] = xml [home_team], [away_team] = <see schedule feed>

Update Timing



Updated 08.03.12


Game Roster Feed – Details

This feed provides player information for each match-up, including height/weight, jersey number, position, player status and injuries.


File Breakdown – Game Roster Feed Element Attribute Values Description
















player id GUID format Unique ID for a specific player

name_full Dynamic Player name

name_first Dynamic Player first name

name_last Dynamic Player last name

name_abbr Dynamic Abbreviated player name (first initial, last name)

birthdate Dynamic Player date of birth

height Dynamic Player height

weight Dynamic Player weight

college Dynamic Player college attended



status ACT Active

DUP Duplicate

Updated 08.03.12


EXE Exempt

IR Injured Reserve


NWT Not with team

PRA Practice Squad


RET Retired

SUS Suspended



salary Dynamic Player salary

started Dynamic Player started the game

played Dynamic Player appeared in the game

Child elements: injuries

injuries Root element of each injury; child elements: injury

injury id GUID format Unique ID for each injury

start_date Dynamic Injury start date

game_status DOU Doubtful

OUT Out of game

PRO Probable

QST Questionable

UNK Unknown

practice_status Did Not Participate

Did not participate in practice

Limited Participation

Limited participation in practice

Full Participation

Fully participated in practice

OUT Did not practice

Child elements: description

description N/A Dynamic Description of the injury

Updated 08.03.12


Game Roster Feed - File Naming Convention

Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/roster-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/[year]/[nfl_season]/[nfl_season_week]/[away_team]/[home_team]/roster.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [year] = yyyy [nfl_season] = Preseason (PRE), Regular Season (REG), Postseason (PST) [nfl_season_week] = 1 - 17 [format] = xml [home_team], [away_team] = <see schedule feed>

Update Timing

This feed will be updated several times each week as relevant events occur. Copyright


Updated 08.03.12


Injuries Feed – Details

This feed provides detailed information on injuries, including the injury type and player game and practice status.


File Breakdown – Injuries Feed Element Attribute Values Description












team









status ACT Active

DUP Duplicate

EXE Exempt

IR Injured Reserve


NWT Not with team

PRA Practice Squad


RET Retired

SUS Suspended

Updated 08.03.12





injuries This is the root element that contains each individual injury

Child elements: injury




OUT Out of game

PRO Probable

QST Questionable

UNK Unknown





Full Participation



Child elements: description, notes


notes N/A Dynamic Notes about the injury

Updated 08.03.12


Injuries Feed - File Naming Convention Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/roster-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/[year]/[nfl_season]/[nfl_season_week]/[away_team]/[home_team]/injuries.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [year] = yyyy [nfl_season] = Preseason (PRE), Regular Season (REG), Postseason (PST) [nfl_season_week] = 1 - 17 [format] = xml [home_team], [away_team] = <see schedule feed> Update Timing



Updated 08.03.12


Play Summary Feed – Details

This feed provides real-time play details on every game play.


File Breakdown – Play Summary Feed Element Attribute Values Description

play id GUID format

Unique ID for a specific play

game GUID format

Unique game ID

type Dynamic Play type

official true, false Whether or not the play was official

clock MM:SS Game time at the start of the play


controller Dynamic Abbreviate team name in possession of the ball

updated Dynamic The last time the play was updated (will reflect any modified play entry)

formation Dynamic Offensive play formation

direction Dynamic Offensive play direction

distance Dynamic Distance gained/lossed on the play

defense_formation Dynamic Defensive formation

defense_action Dynamic Defensive action, ie blitz

Child elements: summary, start_situation, end_situation, statistics

summary N/A Dynamic Summary of the event

start_situation team Dynamic Unique id of team in possession at the beginning of the play

side Dynamic Two/three-letter abbreviation of team whose side of the field the play began

yard_line Dynamic Yard line where play started

down Dynamic Down when the play started

yfd Dynamic Yards to a first down

end_situation team Dynamic Two/three-letter abbreviation of team in possession at the end of the play

side Dynamic Two/three-letter abbreviation of team whose side of the field the play ended

yard_line Dynamic Yard line where play ended

down Dynamic Down when the play ends

yfd Dynamic Yards to a first down

statistics N/A N/A Root element for participating players

Updated 08.03.12



player id GUID format

Unique ID for a specific player

name Dynamic Player name

jersey Dynamic Player jersey number

position Dynamic The participating player’s two/three-letter team abbreviation

team Dynamic Unique ID for a specific player

Child elements: all offensive, defensive and special teams statistics; please see statistics feed for details

Updated 08.03.12


Play Summary Feed - File Naming Convention

Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/extended-play-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/[year]/[nfl_season]/[nfl_season_week]/[away_team]/[home_team]/plays/[play_id].[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [year] = yyyy [nfl_season] = Preseason (PRE), Regular Season (REG), Postseason (PST) [nfl_season_week] = 1 - 17 [home_team], [away_team] = <see schedule feed> [play_id] = ID for the play <see Play-By-Play> [format] = xml Update Timing

This feed will be continually updated as events occur. Copyright The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.

Updated 08.03.12


Play-by-Play Feed – Details

This feed provides detailed, real-time stats on every team possession and game event.


File Breakdown – Play-by-Play Feed Element Attribute Values Description











Child elements: quarter

quarter number 1, 2, 3, 4, 5 Game quarter

Child elements: event, drive

event clock MM:SS Game clock when event takes place

type Dynamic The type of event (Note: These are non-play events such as coin tosses and timeouts)

sequence Dynamic The number of the sequence in the game (Note: Events and play each add to this)


Child elements: winner, summary

winner id Dynamic Unique id of the winner of a coin toss

outcome Dynamic The decision made by coin toss winner

summary N/A Dynamic Text summary of the event

drive clock Dynamic Time that the drive starts

team Dynamic Two/three-letter abbreviation of team in possession

Child elements: play

play id GUID format Unique play ID

clock Dynamic Game clock when play takes place

Updated 08.03.12


type Dynamic Type of play (e.g., pass, rush, kick)

sequence Dynamic The number of the sequence in the game (Note: Events and play each add to this)


side Dynamic Two/three-letter abbreviation of team on whose side of field the play takes place

yard_line Dynamic Yard line on which the play takes place

down 1, 2, 3, 4 The down of the play

yfd 1-10 Yards to a first down

Child elements: participants, summary, links

participants N/A N/A Root element for participating players





position Dynamic The participating player’s two/three-letter team abbreviation

team Dynamic Unique ID for a specific player

summary N/A Dynamic Text summary of the play

links N/A Dynamic Root element for each play link

Child elements: link

link rel summary Play summary

href Dynamic Link to the specific play

type Dynamic The file type

Updated 08.03.12


Play by Play Feed - File Naming Convention

Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/pbp-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/[year]/[nfl_season]/[nfl_season_week]/[away_team]/[home_team]/pbp.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [year] = yyyy [nfl_season] = Preseason (PRE), Regular Season (REG), Postseason (PST) [nfl_season_week] = 1 - 17 [format] = xml [home_team], [away_team] = <see schedule feed> Update Timing



Updated 08.03.12


Season Schedule Feed – Details

This feed provides the date, time, location and event details for every match-up in a season, as well as links to the other five main SportsData feeds.


File Breakdown – Season Schedule Feed Element Attribute Values Description

season season Dynamic The year in which the season began

type PRE Pre-season

REG Regular season

PST Post season

Child elements: week

week week 1 to 17 The week in the season

Child elements: game

game id GUID format Unique ID for a specific game


home_rotation XX or XXX Home team rotation number

away_rotation XX or XXX Away team rotation number






complete The game is over, but stat validation is not done



Child elements: venue, weather, broadcast, links

venue id GUID format Unique ID for a specific venue

country Dynamic Country location of venue

name Dynamic Name of venue

city Dynamic City location of venue

state Dynamic State location of venue

capacity Dynamic Seating capacity of venue

surface Dynamic Field surface

type Dynamic Type of venue structure

Updated 08.03.12


zip Dynamic Zip code of venue

address Dynamic Address of venue

weather temperature Dynamic Weather temperature at game kickoff

condition Dynamic Weather condition at game kickoff

humidity Dynamic Weather humidity at game kickoff

Child elements: wind

wind speed Dynamic Wind speed at game kickoff

direction Dynamic Wind direction at game kickoff

broadcast

network Dynamic Network broadcasting game

satellite Dynamic Satellite channel broadcasting game

internet Dynamic Internet site broadcasting game

cable Dynamic Cable channel broadcasting game

links N/A N/A Root element for feed links


link rel statistics Feed of team and player stats for a game

summary Feed of summary stats for a game

pbp Feed of play-by-play details for a game

boxscore Feed of a Boxscore for a game

roster Feed of team rosters for a game

injuries Feed of team injuries for a game

depthchart Feed of team depth chart for a game

href Dynamic The url linking to a specific feed


Updated 08.03.12


Season Schedule Feed – File Naming Convention

Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/schedule-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/[year]/[nfl_season]/schedule.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [year] = yyyy [nfl_season] = Preseason (PRE), Regular Season (REG), Postseason (PST) [format] = xml Update Timing



Updated 08.03.12


Seasonal Statistics Feed – Details

This feed provides detailed season stats at the team level and player level, including extensive offense, defense and special teams breakouts.


File Breakdown – Team Seasonal Statistics Feed Element Attribute Values Description

season season Dynamic Year of competition

season_type PRE Pre-season

REG Regular season

PST Post season


team




Child elements: two_point_conversion, touchdowns, third_down_efficiency, rushing, redzone_efficiency, receiving, punting, punt_return, penalty, passing, kickoffs, kick_return, goal_efficiency, fumbles, fourth_down_efficiency, first_downs, field_goal_return, field_goal, extra_point, defense, blocked_punt_return, block_field_goal_return, players

two_point_conversion att Dynamic Team two point conversion attempts

pass Dynamic Team two point conversions via a pass

rush Dynamic Team two point conversions via a rush

rec Dynamic Team two point conversions received

failed Dynamic Failed team two point conversions

touchdowns pass Dynamic Team passing touchdowns

rush Dynamic Team rushing touchdowns

int Dynamic Team touchdowns from interceptions

fum_ret Dynamic Team touchdowns from returned fumbles

punt_ret Dynamic Team touchdowns from punt returns

kick_ret Dynamic Team touchdowns from kick returns

fg_ret Dynamic Team touchdowns from field goal returns

other Dynamic Other, misc. team touchdowns

third_down_efficiency att Dynamic Team three point conversion attempts

conv Dynamic Team three point conversions

pct Dynamic Team three point conversion percentage

pass Dynamic Team three point conversions via a pass

rush Dynamic Team three point conversions via a rush

Updated 08.03.12


pen Dynamic Team three point conversions via a penalty

rushing att Dynamic Team rushing attempts

yds Dynamic Team rushing yards

avg Dynamic Team average yards per rushing attempt

lg Dynamic Team long rush

td Dynamic Team rushing touchdowns

fd Dynamic Team first downs via a rush

fd_pct Dynamic Team percentage of rushes for a first down

sfty Dynamic Team rushes tackled for a safety

rz_att Dynamic Team red zone rushes attempts

fum Dynamic Team rushing fumbles

yds_10_pls Dynamic Team rushes for 10 or more yards





redzone_efficiency att Dynamic Red Zone attempts

td Dynamic Red Zone touchdowns

pct Dynamic Red Zone conversion percentage

receiving tar Dynamic Team receiving targets

rec Dynamic Team receptions

yds Dynamic Team receiving yards

yac Dynamic Team yards after catch

fd Dynamic Team first downs via a reception

avg Dynamic Team average yards per reception

td Dynamic Team receiving touchdowns

lg Dynamic Team long reception

rz_tar Dynamic Team red zone receiving targets

fum Dynamic Team receiving fumbles

yds_10_pls Dynamic Team receptions for 10 or more yards





punting punts Dynamic Team punts

yds Dynamic Team gross punt yards

net_yds Dynamic Team net punt yards

Updated 08.03.12


lg Dynamic Team long punt

blk Dynamic Team blocked punts

In20 Dynamic Team punts inside the opponents’ 20 yard line

tb Dynamic Team punts for touchbacks

ret Dynamic Team punts returned by opponents

avg Dynamic Team average gross yards per punt

net_avg Dynamic Team average net yards per punt

ret_yds Dynamic Team total opponents’ punt return yards

avg_ret Dynamic Team average opponents’ punt return yards

in20_pct Dynamic Team percentage of punts inside opp’s 20

tb_pct Dynamic Team percentage of punts for touchbacks

punt_return returns Dynamic Team punt returns

yds Dynamic Team punt return yards

fc Dynamic Team fair catches on punt returns

lg Dynamic Team long punt return

td Dynamic Team touchdowns on punt returns

avg Dynamic Team average yards per punt return

yds_10_pls Dynamic Team punt returns of 10+ yards





penalty num Dynamic Team number of penalties

yds Dynamic Team penalty yards

fd Dynamic Team first downs via a penalty

passing att Dynamic Team passing attempts

cmp Dynamic Team pass completions

cmp_avg Dynamic Team average yards per completion

yds Dynamic Team passing yards

lg Dynamic Team long pass

sk Dynamic Team sacked on offense

sk_yds Dynamic Team yards lost from sacks

td Dynamic Team passing touchdowns

int Dynamic Team passing interceptions

fd Dynamic Team passing first downs

sfty Dynamic Team times tackled for a safety

rating Dynamic Team combined passer rating

Updated 08.03.12


avg Dynamic Team average yards per passing attempt

cmp_pct Dynamic Team passing completion percentage

td_pct Dynamic Team percent of passes for touchdowns

Int_pct Dynamic Team percent of passes intercepted

rz_att Dynamic Team red zone passing attempts

yds_10_pls Dynamic Team passes of 10+ yards





kickoffs kicks Dynamic Team kickoffs

yds Dynamic Team gross kickoff yards

net_yds Dynamic Team net kickoff yards

lg Dynamic Team longest kickoff

endzone Dynamic Team kickoffs in opponents’ end zone

in20 Dynamic Team kickoffs inside opponents’ 20 yard line

tb Dynamic Team kickoffs for touchbacks

ret Dynamic Team kickoffs returned by opponents

avg Dynamic Team average gross yards per kickoff

net_avg Dynamic Team average net yards per kickoff

ret_yds Dynamic Team opponents’ kickoff return yards

avg_ret Dynamic Team average opponents’ return yards per kickoff

in20_pct Dynamic Team percentage of kickoffs inside opponents’ 20 yard line

tb_pct Dynamic Team percentage of kickoff for touchbacks

kick_return returns Dynamic Team number of kickoff returns

yds Dynamic Team kickoff return yards

fc Dynamic Team fair catches on kickoff returns

lg Dynamic Team long kickoff return

td Dynamic Team kickoffs returned for touchdown

avg Dynamic Team average yards per kickoff return

yds_10_pls Dynamic Team kick returns of 10+ yards





goal_efficiency att Dynamic Team goal-to-go attempts

Updated 08.03.12


td Dynamic Team goal-to-go touchdown conversions

pct Dynamic Team goal-to-go conversion percentage

fumbles fum Dynamic Team fumbles

lost Dynamic Team fumbles lost

oob Dynamic Team fumbles out of bounds

own_rec Dynamic Team fumble recoveries

own_rec_yds Dynamic Team yards from fumble recoveries

own_rec_td Dynamic Team touchdowns from fumble coveries

force_fum Dynamic Team forced fumbles

opp_rec Dynamic Team fumbles recovered by opponents

opp_rec_yds Dynamic Team yards allowed from opponents’ fumble recoveries

opp_rec_td Dynamic Team touchdowns allowed from opponents’ fumble reoveries

fourth_down_efficiency att Dynamic Team fourth down attempts

conv Dynamic Team fourth down conversions

pct Dynamic Team fourth down conversion percentage

pass Dynamic Team fourth down conversions via a pass

rush Dynamic Team fourth down conversions via a rush

pen Dynamic Team fourth down conversions via a penalty

first_downs num Dynamic Team first downs

pass Dynamic Team first downs via a pass

rush Dynamic Team first downs via a rush

pen Dynamic Team first downs via a penalty

field_goal_return returns Dynamic Team field goal returns

yds Dynamic Team field goal return yards

lg Dynamic Team long field goal return

td Dynamic Team touchdowns from field goal return

avg Dynamic Team average field goal return yards

yds_10_pls Dynamic Team field goal returns of 10+ yards





field_goal att Dynamic Team field goal attempts

made Dynamic Team field goalls made

pct Dynamic Team field goal percentage made

lg Dynamic Team long field goal made

Updated 08.03.12


att_19 Dynamic Team field goals attempted 0-19 yards

made_19 Dynamic Team field goals made 0-19 yards







att_50 Dynamic Team field goals attempted 50+ yards

made_50 Dynamic Team field goals made 50+ yards

extra_point att Dynamic Team extra points attempted

made Dynamic Team extra points made

pct Dynamic Team extra point percentage made

blk Dynamic Team extra points attempts blocked

defense tackle Dynamic Team total tackles

ast Dynamic Team assisted tackles

comb Dynamic Team combined tackles

tlost Dynamic Team tackles for a loss

sack Dynamic Team sacks

sack_yds Dynamic Team sack yards

sfty Dynamic Team safeties

int Dynamic Team interceptions

int_yds Dynamic Team interception yards

int_lg Dynamic Team long interception

int_td Dynamic Team interceptions returned for a touchdown


fum_rec Dynamic Team fumble recoveries

fum_td Dynamic Team fumble recoveries for a touchdown

qh Dynamic Team quarterback hurries

pd Dynamic Team passes defended

bk Dynamic Team blocked kicks

sp_tackle Dynamic Special teams total tackles

sp_ast Dynamic Special teams assisted tackles

sp_comb Dynamic Special teams combined tackles

sp_force_fum Dynamic Special teams forced fumbles

sp_fum_rec Dynamic Special teams fumble recoveries

misc_tackle Dynamic Misc total tackles

Updated 08.03.12


misc_ast Dynamic Misc assisted tackles

misc_comb Dynamic Misc combined tackles

misc_force_fum Dynamic Misc forced fumbles

misc_fum_rec Dynamic Misc fumble recoveries

blocked_punt_return returns Dynamic Team blocked punt returns

yds Dynamic Team blocked punt return yards

lg Dynamic Team long blocked punt return

td Dynamic Team blocked punts returned for a touchdown

avg Dynamic Team average blocked punt return yards

yds_10_pls Dynamic Team blocked punt returns of 10+ yards





blocked_field_goal_return

returns Dynamic Team blocked field goal returns

yds Dynamic Team blocked field goal return yards

lg Dynamic Team long blocked field goal return

td Dynamic Team blocked field goals returned for a touchdown

avg Dynamic Team average blocked field goal return yards

yds_10_pls Dynamic Team blocked field goal returns of 10+ yards






games_played Dynamic Number of games played

games_started Dynamic Number of games started




Child elements: two_point_conversion, touchdowns, rushing, receiving, punting, punt_return, penalty, passing, kickoffs, kick_return, fumbles, first_downs, field_goal_return, field_goal, extra_point, defense, blocked_punt_return, block_field_goal_return

two_point_conversion att Dynamic Player two point conversion attempts

pass Dynamic Player two point conversions via a pass

rush Dynamic Player two point conversions via a rush

rec Dynamic Player two point conversions received

Updated 08.03.12


failed Dynamic Failed Player two point conversions

touchdowns pass Dynamic Player passing touchdowns

rush Dynamic Player rushing touchdowns

int Dynamic Player touchdowns from interceptions

fum_ret Dynamic Player touchdowns from returned fumbles

punt_ret Dynamic Player touchdowns from punt returns

kick_ret Dynamic Player touchdowns from kick returns

fg_ret Dynamic Player touchdowns from field goal returns

other Dynamic Other, misc. Player touchdowns

rushing att Dynamic Player rushing attempts

yds Dynamic Player rushing yards

avg Dynamic Player average yards per rushing attempt

lg Dynamic Player long rush

td Dynamic Player rushing touchdowns

fd Dynamic Player first downs via a rush

fd_pct Dynamic Player percentage of rushes for a first down

sfty Dynamic Player rushes tackled for a safety

rz_att Dynamic Player red zone rushes attempts

fum Dynamic Player rushing fumbles

yds_10_pls Dynamic Player rushes for 10 or more yards





receiving tar Dynamic Player receiving targets

rec Dynamic Player receptions

yds Dynamic Player receiving yards

yac Dynamic Player yards after catch

fd Dynamic Player first downs via a reception

avg Dynamic Player average yards per reception

td Dynamic Player receiving touchdowns

lg Dynamic Player long reception

rz_tar Dynamic Player red zone receiving targets

fum Dynamic Player receiving fumbles

yds_10_pls Dynamic Player receptions for 10 or more yards



Updated 08.03.12




punting punts Dynamic Player punts

yds Dynamic Player gross punt yards

net_yds Dynamic Player net punt yards

lg Dynamic Player long punt

blk Dynamic Player blocked punts

In20 Dynamic Player punts inside the opponents’ 20 yard line

tb Dynamic Player punts for touchbacks

ret Dynamic Player punts returned by opponents

avg Dynamic Player average gross yards per punt

net_avg Dynamic Player average net yards per punt

ret_yds Dynamic Player total opponents’ punt return yards

avg_ret Dynamic Player average opponents’ punt return yards

in20_pct Dynamic Player percentage of punts inside opp’s 20

tb_pct Dynamic Player percentage of punts for touchbacks

punt_return returns Dynamic Player punt returns

yds Dynamic Player punt return yards

fc Dynamic Player fair catches on punt returns

lg Dynamic Player long punt return

td Dynamic Player touchdowns on punt returns

avg Dynamic Player average yards per punt return

yds_10_pls Dynamic Player punt returns of 10+ yards





penalty num Dynamic Player number of penalties

yds Dynamic Player penalty yards

fd Dynamic Player first downs via a penalty

passing att Dynamic Player passing attempts

cmp Dynamic Player pass completions

yds Dynamic Player passing yards

lg Dynamic Player long pass

sk Dynamic Player sacked on offense

sk_yds Dynamic Player yards lost from sacks

td Dynamic Player passing touchdowns

Updated 08.03.12


int Dynamic Player passing interceptions

fd Dynamic Player passing first downs

sfty Dynamic Player times tackled for a safety

rating Dynamic Player combined passer rating

avg Dynamic Player average yards per passing attempt

cmp_pct Dynamic Player passing completion percentage

td_pct Dynamic Player percent of passes for touchdowns

Int_pct Dynamic Player percent of passes intercepted

rz_att Dynamic Player red zone passing attempts

yds_10_pls Dynamic Player passes of 10+ yards





kickoffs kicks Dynamic Player kickoffs

yds Dynamic Player gross kickoff yards

net_yds Dynamic Player net kickoff yards

lg Dynamic Player longest kickoff

endzone Dynamic Player kickoffs in opponents’ end zone

in20 Dynamic Player kickoffs inside opponents’ 20 yard line

tb Dynamic Player kickoffs for touchbacks

ret Dynamic Player kickoffs returned by opponents

avg Dynamic Player average gross yards per kickoff

net_avg Dynamic Player average net yards per kickoff

ret_yds Dynamic Player opponents’ kickoff return yards

avg_ret Dynamic Player average opponents’ return yards per kickoff

in20_pct Dynamic Player percentage of kickoffs inside opponents’ 20 yard line

tb_pct Dynamic Player percentage of kickoff for touchbacks

kick_return returns Dynamic Player number of kickoff returns

yds Dynamic Player kickoff return yards

fc Dynamic Player fair catches on kickoff returns

lg Dynamic Player long kickoff return

td Dynamic Player kickoffs returned for touchdown

avg Dynamic Player average yards per kickoff return

yds_10_pls Dynamic Player kick returns of 10+ yards


Updated 08.03.12





fumbles fum Dynamic Player fumbles

lost Dynamic Player fumbles lost

oob Dynamic Player fumbles out of bounds

own_rec Dynamic Player fumble recoveries

own_rec_yds Dynamic Player yards from fumble recoveries

own_rec_td Dynamic Player touchdowns from fumble coveries

force_fum Dynamic Player forced fumbles

opp_rec Dynamic Player fumbles recovered by opponents

opp_rec_yds Dynamic Player yards allowed from opponents’ fumble recoveries

opp_rec_td Dynamic Player touchdowns allowed from opponents’ fumble reoveries

first_downs num Dynamic Player first downs

pass Dynamic Player first downs via a pass

rush Dynamic Player first downs via a rush

pen Dynamic Player first downs via a penalty

field_goal_return returns Dynamic Player field goal returns

yds Dynamic Player field goal return yards

lg Dynamic Player long field goal return

td Dynamic Player touchdowns from field goal return

avg Dynamic Player average field goal return yards

yds_10_pls Dynamic Player field goal returns of 10+ yards





field_goal att Dynamic Player field goal attempts

made Dynamic Player field goalls made

pct Dynamic Player field goal percentage made

lg Dynamic Player long field goal made

att_19 Dynamic Player field goals attempted 0-19 yards

made_19 Dynamic Player field goals made 0-19 yards




Updated 08.03.12





att_50 Dynamic Player field goals attempted 50+ yards

made_50 Dynamic Player field goals made 50+ yards

extra_point att Dynamic Player extra points attempted

made Dynamic Player extra points made

pct Dynamic Player extra point percentage made

blk Dynamic Player extra points attempts blocked

defense tackle Dynamic Player total tackles

ast Dynamic Player assisted tackles

comb Dynamic Player combined tackles

tlost Dynamic Player tackles for a loss

sack Dynamic Player sacks

sack_yds Dynamic Player sack yards

sfty Dynamic Player safeties

int Dynamic Player interceptions

int_yds Dynamic Player interception yards

int_lg Dynamic Player long interception


fum_rec Dynamic Player fumble recoveries

fum_td Dynamic Player fumble recoveries for a touchdown

qh Dynamic Player quarterback hurries

pd Dynamic Player passes defended

bk Dynamic Player blocked kicks

sp_tackle Dynamic Player teams total tackles

sp_ast Dynamic Player special teams assisted tackles

sp_comb Dynamic Player special teams combined tackles

sp_force_fum Dynamic Player special teams forced fumbles

sp_fum_rec Dynamic Player special teams fumble recoveries

misc_tackle Dynamic Player misc total tackles

misc_ast Dynamic Player misc assisted tackles

misc_comb Dynamic Player misc combined tackles

misc_force_fum Dynamic Player misc forced fumbles

misc_fum_rec Dynamic Player misc fumble recoveries

blocked_punt_return returns Dynamic Player blocked punt returns

yds Dynamic Player blocked punt return yards

Updated 08.03.12


lg Dynamic Player long blocked punt return

td Dynamic Player blocked punts returned for a touchdown

avg Dynamic Player average blocked punt return yards

yds_10_pls Dynamic Player blocked punt returns of 10+ yards






returns Dynamic Player blocked field goal returns

yds Dynamic Player blocked field goal return yards

lg Dynamic Player long blocked field goal return

td Dynamic Player blocked field goals returned for a touchdown

avg Dynamic Player average blocked field goal return yards

yds_10_pls Dynamic Player blocked field goal returns of 10+ yards





Updated 08.03.12


Seasonal Statistics Feed - File Naming Convention

Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/statistics-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/teams/[team]/[year]/[nfl_season]/statistics.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [team] = team abbreviation <see Team Hierarchy> [year] = yyyy [nfl_season] = Preseason (PRE), Regular Season (REG), Postseason (PST) [format] = xml

Update Timing

This feed will be continually updated as events occur. Copyright The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.

Updated 08.03.12


Standings Feed – Details

This feed provides detailed information on injuries, including the injury type and player game and practice status.


File Breakdown – Standings Feed Element Attribute Values Description

standings season Dynamic The year of the season

type PRE Pre-season

REG Regular season

PST Post season

Child elements: conference

conference

id AFC or NFC Abbreviated name for a specific conference

name AFC or NFC Abbreviated name for a specific conference

Child elements: division

division id e.g., AFC_EAST

Abbreviated name for a specific division

name e.g., AFC_EAST



team




Child elements: overall, in_conference, non_conference, in_division, home, away, overtime, grass, turf, scored_first, decided_by_7_points, leading_at_half, last_5, points, touchdowns, streak

overall

wins Dynamic Overall wins

losses Dynamic Overall losses

ties Dynamic Overall ties

wpct Dynamic Overall winning percentage

in_conference

wins Dynamic In-conference wins

losses Dynamic In-conference losses

ties Dynamic In-conference ties

wpct Dynamic In-conference winning percentage

non_conference

wins Dynamic Non-conference wins

losses Dynamic Non-conference losses

ties Dynamic Non-conference ties

wpct Dynamic Non-conference winning percentage

Updated 08.03.12


in_division

wins Dynamic In-division wins

losses Dynamic In-division losses

ties Dynamic In-division ties

wpct Dynamic In-division winning percentage

home

wins Dynamic Home wins

losses Dynamic Home losses

ties Dynamic Home ties

wpct Dynamic Home winning percentage

away

wins Dynamic Away wins

losses Dynamic Away losses

ties Dynamic Away ties

wpct Dynamic Away winning percentage

overtime

wins Dynamic Overtime wins

losses Dynamic Overtime losses

ties Dynamic Overtime ties

wpct Dynamic Overtime winning percentage

grass

wins Dynamic Grass wins

losses Dynamic Grass losses

ties Dynamic Grass ties

wpct Dynamic Grass winning percentage

turf

wins Dynamic Turf wins

losses Dynamic Turf losses

ties Dynamic Turf ties

wpct Dynamic Turf winning percentage

scored_first

wins Dynamic Scored first, wins

losses Dynamic Scored first, losses

ties Dynamic Scored first, ties

decided_by_7_points

wins Dynamic Decided by 7 points or fewer, wins

losses Dynamic Decided by 7 points or fewer, losses

ties Dynamic Decided by 7 points or fewer, ties

leading_at_half

wins Dynamic Leading at the half, wins

losses Dynamic Leading at the half, losses

ties Dynamic Leading at the half ties

last_5

wins Dynamic Last 5 games, wins

losses Dynamic Last 5 games, losses

ties Dynamic Last 5 games, ties

points for Dynamic Points for

Updated 08.03.12


against Dynamic Points against

net Dynamic Net points

touchdowns

for Dynamic Touchdowns for

against Dynamic Touchdowns against

streak

type Win or Loss Winning or losing streak

value Dynamic Number of consecutive wins or losses

Updated 08.03.12


Standings Feed - File Naming Convention Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/standings-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/teams/[year]/[nfl_season]/standings.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [year] = yyyy [nfl_season] = Preseason (PRE), Regular Season (REG), Postseason (PST) [format] = xml Update Timing This feed will be updated several times each week as relevant events occur. Copyright


Updated 08.03.12


Game Statistics Feed – Details

This feed provides detailed game stats at the player and team level, including extensive offense, defense and special teams breakouts.


File Breakdown – Game Statistics Feed Element Attribute Values Description










reopened The games stats are in the process of being corrected


team




Child elements: two_point_conversion, touchdowns, third_down_efficiency, rushing, redzone_efficiency, receiving, punting, punt_return, penalty, passing, kickoffs, kick_return, goal_efficiency, fumbles, fourth_down_efficiency, first_downs, field_goal_return, field_goal, extra_point, defense, blocked_punt_return, block_field_goal_return

two_point_conversion att Dynamic Team two point conversion attempts

pass Dynamic Team two point conversions via a pass

rush Dynamic Team two point conversions via a rush

rec Dynamic Team two point conversions received

failed Dynamic Failed team two point conversions






Updated 08.03.12


att Dynamic Player two point conversion attempts

pass Dynamic Player two point conversions via a pass

rush Dynamic Player two point conversions via a rush

rec Dynamic Player two point conversions received

failed Dynamic Failed Player two point conversions

touchdowns pass Dynamic Team passing touchdowns

rush Dynamic Team rushing touchdowns

int Dynamic Team touchdowns from interceptions

fum_ret Dynamic Team touchdowns from returned fumbles

punt_ret Dynamic Team touchdowns from punt returns

kick_ret Dynamic Team touchdowns from kick returns

fg_ret Dynamic Team touchdowns from field goal returns

other Dynamic Other, misc. team touchdowns






pass Dynamic Player passing touchdowns

rush Dynamic Player rushing touchdowns

int Dynamic Player touchdowns from interceptions

fum_ret Dynamic Player touchdowns from returned fumbles

punt_ret Dynamic Player touchdowns from punt returns

Kick_ret Dynamic Player touchdowns from kick returns

fg_ret Dynamic Player touchdowns from field goal returns

other Dynamic Other, misc. player touchdowns

third_down_efficiency att Dynamic Team three point conversion attempts

conv Dynamic Team three point conversions

pct Dynamic Team three point conversion percentage

pass Dynamic Team three point conversions via a pass

rush Dynamic Team three point conversions via a rush

pen Dynamic Team three point conversions via a penalty

rushing att Dynamic Team rushing attempts

yds Dynamic Team rushing yards

avg Dynamic Team average yards per rushing attempt

lg Dynamic Team long rush

td Dynamic Team rushing touchdowns

Updated 08.03.12


fd Dynamic Team first downs via a rush

fd_pct Dynamic Team percentage of rushes for a first down

sfty Dynamic Team rushes tackled for a safety

rz_att Dynamic Team red zone rushes attempts

fum Dynamic Team rushing fumbles











att Dynamic Player rushing attempts

yds Dynamic Player rushing yards

avg Dynamic Player average yards per rushing attempt

lg Dynamic Player long rush

td Dynamic Player rushing touchdowns

fd Dynamic Player first downs via a rush

fd_pct Dynamic Player percentage of rushes for a first down

sfty Dynamic Player rushes tackled for a safety

rz_att Dynamic Player red zone rushes attempts

fum Dynamic Player rushing fumbles






redzone_efficiency att Dynamic Red Zone attempts

td Dynamic Red Zone touchdowns

pct Dynamic Red Zone conversion percentage

receiving tar Dynamic Team receiving targets

rec Dynamic Team receptions

yds Dynamic Team receiving yards

yac Dynamic Team yards after catch

Updated 08.03.12


fd Dynamic Team first downs via a reception

avg Dynamic Team average yards per reception

td Dynamic Team receiving touchdowns

lg Dynamic Team long reception

rz_tar Dynamic Team red zone receiving targets

fum Dynamic Team receiving fumbles











tar Dynamic Player receiving targets

rec Dynamic Player receptions

yds Dynamic Player receiving yards

yac Dynamic Player yards after catch

fd Dynamic Player first downs via a reception

avg Dynamic Player average yards per reception

td Dynamic Player receiving touchdowns

lg Dynamic Player long reception

rz_tar Dynamic Player red zone receiving targets

fum Dynamic Player receiving fumbles






punting punts Dynamic Team punts

yds Dynamic Team gross punt yards

net_yds Dynamic Team net punt yards

lg Dynamic Team long punt

blk Dynamic Team blocked punts

In20 Dynamic Team punts inside the opponents’ 20 yard line

Updated 08.03.12


tb Dynamic Team punts for touchbacks

ret Dynamic Team punts returned by opponents

avg Dynamic Team average gross yards per punt

net_avg Dynamic Team average net yards per punt

ret_yds Dynamic Team total opponents’ punt return yards

avg_ret Dynamic Team average opponents’ punt return yards

in20_pct Dynamic Team percentage of punts inside opp’s 20

tb_pct Dynamic Team percentage of punts for touchbacks






punts Dynamic Player punts

yds Dynamic Player gross punt yards

net_yds Dynamic Player net punt yards

lg Dynamic Player long punt

blk Dynamic Player blocked punts

In20 Dynamic Player punts inside the opponents’ 20 yard line

tb Dynamic Player punts for touchbacks

ret Dynamic Player punts returned by opponents

avg Dynamic Player average gross yards per punt

net_avg Dynamic Player average net yards per punt

ret_yds Dynamic Player total opponents’ punt return yards

avg_ret Dynamic Player average opponents’ punt return yards

in20_pct Dynamic Player percentage of punts inside opp’s 20

tb_pct Dynamic Player percentage of punts for touchbacks

punt_returns returns Dynamic Team punt returns

yds Dynamic Team punt return yards

fc Dynamic Team fair catches on punt returns

lg Dynamic Team long punt return

td Dynamic Team touchdowns on punt returns

avg Dynamic Team average yards per punt return





Updated 08.03.12








returns Dynamic Player punt returns

yds Dynamic Player punt return yards

fc Dynamic Player fair catches on punt returns

lg Dynamic Player long punt return

td Dynamic Player touchdowns on punt returns

avg Dynamic Player average yards per punt return






penalty num Dynamic Team number of penalties

yds Dynamic Team penalty yards

fd Dynamic Team first downs via a penalty






num Dynamic Player number of penalties

yds Dynamic Player penalty yards

fd Dynamic Player first downs via a penalty

passing att Dynamic Team passing attempts

cmp Dynamic Team pass completions

yds Dynamic Team passing yards

lg Dynamic Team long pass

sk Dynamic Team sacked on offense

sk_yds Dynamic Team yards lost from sacks

td Dynamic Team passing touchdowns

int Dynamic Team passing interceptions

fd Dynamic Team passing first downs

Updated 08.03.12


sfty Dynamic Team times tackled for a safety

rating Dynamic Team combined passer rating

avg Dynamic Team average yards per passing attempt

cmp_pct Dynamic Team passing completion percentage

cmp_avg Dynamic Team average completion yards

td_pct Dynamic Team percent of passes for touchdowns

Int_pct Dynamic Team percent of passes intercepted












att Dynamic Player passing attempts

cmp Dynamic Player pass completions

yds Dynamic Player passing yards

lg Dynamic Player long pass

sk Dynamic Player sacked on offense

sk_yds Dynamic Player yards lost from sacks

td Dynamic Player passing touchdowns

int Dynamic Player passing interceptions

int_td Dynamic Player interception touchdowns

fd Dynamic Player passing first downs

sfty Dynamic Player times tackled for a safety

rating Dynamic Player combined passer rating

avg Dynamic Player average yards per passing attempt

cmp_pct Dynamic Player passing completion percentage

cmp_avg Dynamic Player passing completion average

td_pct Dynamic Player percent of passes for touchdowns

Int_pct Dynamic Player percent of passes intercepted



Updated 08.03.12






kickoffs kicks Dynamic Team kickoffs

yds Dynamic Team gross kickoff yards

net_yds Dynamic Team net kickoff yards

lg Dynamic Team longest kickoff

endzone Dynamic Team kickoffs in opponents’ end zone

in20 Dynamic Team kickoffs inside opponents’ 20 yard line

tb Dynamic Team kickoffs for touchbacks

ret Dynamic Team kickoffs returned by opponents

avg Dynamic Team average gross yards per kickoff

net_avg Dynamic Team average net yards per kickoff

ret_yds Dynamic Team opponents’ kickoff return yards

avg_ret Dynamic Team average opponents’ return yards per kickoff

in20_pct Dynamic Team percentage of kickoffs inside opponents’ 20 yard line

tb_pct Dynamic Team percentage of kickoff for touchbacks






kicks Dynamic Player kickoffs

yds Dynamic Player gross kickoff yards

net_yds Dynamic Player net kickoff yards

lg Dynamic Player longest kickoff

endzone Dynamic Player kickoffs in opponents’ end zone

in20 Dynamic Player kickoffs inside opponents’ 20 yard line

tb Dynamic Player kickoffs for touchbacks

ret Dynamic Player kickoffs returned by opponents

avg Dynamic Player average gross yards per kickoff

net_avg Dynamic Player average net yards per kickoff

ret_yds Dynamic Player opponents’ kickoff return yards

avg_ret Dynamic Player average opponents’ return yards per kickoff

in20_pct Dynamic Player percentage of kickoffs inside opponents’ 20 yard line

Updated 08.03.12


tb_pct Dynamic Player percentage of kickoff for touchbacks

kick_return returns Dynamic Team number of kickoff returns

yds Dynamic Team kickoff return yards

fc Dynamic Team fair catches on kickoff returns

lg Dynamic Team long kickoff return

td Dynamic Team kickoffs returned for touchdown

avg Dynamic Team average yards per kickoff return











returns Dynamic Player number of kickoff returns

yds Dynamic Player kickoff return yards

fc Dynamic Player fair catches on kickoff returns

lg Dynamic Player long kickoff return

td Dynamic Player kickoffs returned for touchdown

avg Dynamic Player average yards per kickoff return






goal_efficiency att Dynamic Team goal-to-go attempts

td Dynamic Team goal-to-go touchdown conversions

pct Dynamic Team goal-to-go conversion percentage

fumbles fum Dynamic Team fumbles

lost Dynamic Team fumbles lost

oob Dynamic Team fumbles out of bounds

own_rec Dynamic Team fumble recoveries

own_rec_yds Dynamic Team yards from fumble recoveries

own_rec_td Dynamic Team touchdowns from fumble coveries

Updated 08.03.12



opp_rec Dynamic Team fumbles recovered by opponents

opp_rec_yds Dynamic Team yards allowed from opponents’ fumble recoveries

opp_rec_td Dynamic Team touchdowns allowed from opponents’ fumble reoveries

Child element: player





fum Dynamic Player fumbles

lost Dynamic Player fumbles lost

oob Dynamic Player fumbles out of bounds

own_rec Dynamic Player fumble recoveries

own_rec_yds Dynamic Player yards from fumble recoveries

own_rec_td Dynamic Player touchdowns from fumble coveries

force_fum Dynamic Player force fumbles

opp_rec Dynamic Player fumbles recovered by opponents

opp_rec_yds Dynamic Player yards allowed from opponents’ fumble recoveries

opp_rec_td Dynamic Player touchdowns allowed from opponents’ fumble reoveries

fourth_down_efficiency att Dynamic Team fourth down attempts

conv Dynamic Team fourth down conversions

pct Dynamic Team fourth down conversion percentage

pass Dynamic Team fourth down conversions via a pass

rush Dynamic Team fourth down conversions via a rush

pen Dynamic Team fourth down conversions via a penalty

first_downs num Dynamic Team first downs

pass Dynamic Team first downs via a pass

rush Dynamic Team first downs via a rush

pen Dynamic Team first downs via a penalty






num Dynamic Player first downs

Updated 08.03.12


pass Dynamic Player first downs via a pass

rush Dynamic Player first downs via a rush

pen Dynamic Player first downs via a penalty

field_goal_return returns Dynamic Team field goal returns

yds Dynamic Team field goal return yards

lg Dynamic Team long field goal return

td Dynamic Team touchdowns from field goal return

avg Dynamic Team average field goal return yards






Child element: player

player returns GUID format Player field goal returns

yds Dynamic Player field goal return yards

lg Dynamic Player long field goal return

td Dynamic Player touchdowns from field goal return

avg Dynamic Player average field goal return yards






field_goal att Dynamic Team field goal attempts

made Dynamic Team field goalls made

pct Dynamic Team field goal percentage made

lg Dynamic Team long field goal made









att_50 Dynamic Team field goals attempted 50+ yards

Updated 08.03.12


made_50 Dynamic Team field goals made 50+ yards






att Dynamic Player field goal attempts

made Dynamic Player field goalls made

pct Dynamic Player field goal percentage made

lg Dynamic Player long field goal made

blk Dynamic Player field goals blocked









att_50 Dynamic Player field goals attempted 50+ yards

made_50 Dynamic Player field goals made 50+ yards

extra_point att Dynamic Team extra points attempted

made Dynamic Team extra points made

pct Dynamic Team extra point percentage made

blk Dynamic Team extra points attempts blocked






att Dynamic Player extra points attempted

made Dynamic Player extra points made

pct Dynamic Player extra point percentage made

blk Dynamic Player extra points attempts blocked

defense tackle Dynamic Team total tackles

ast Dynamic Team assisted tackles

comb Dynamic Team combined tackles

Updated 08.03.12


tlost Dynamic Team tackles for a loss

sack Dynamic Team sacks

sack_yds Dynamic Team sack yards

sfty Dynamic Team safeties

int Dynamic Team interceptions

int_yds Dynamic Team interception yards

int_lg Dynamic Team long interception

int_td Dynamic Team interception touchdowns


fum_rec Dynamic Team fumble recoveries

fum_td Dynamic Team fumble recoveries for a touchdown

qh Dynamic Team quarterback hurries

pd Dynamic Team passes defended

bk Dynamic Team blocked kicks

sp_tackle Dynamic Special teams total tackles

sp_ast Dynamic Special teams assisted tackles

sp_comb Dynamic Special teams combined tackles

sp_force_fum Dynamic Special teams forced fumbles

sp_fum_rec Dynamic Special teams fumble recoveries

misc_tackle Dynamic Misc total tackles

misc_ast Dynamic Misc assisted tackles

misc_comb Dynamic Misc combined tackles

misc_force_fum Dynamic Misc forced fumbles

misc_fum_rec Dynamic Misc fumble recoveries






tackle Dynamic Player total tackles

ast Dynamic Player assisted tackles

comb Dynamic Player combined tackles

tlost Dynamic Player tackles for a loss

sack Dynamic Player sacks

sack_yds Dynamic Player sack yards

sfty Dynamic Player safeties

int Dynamic Player interceptions

Updated 08.03.12


int_yds Dynamic Player interception yards

int_lg Dynamic Player long interception

int_td Dynamic Player interceptions returned for a touchdown


fum_rec Dynamic Player fumble recoveries

fum_td Dynamic Player fumble recoveries for a touchdown

qh Dynamic Player quarterback hurries

pd Dynamic Player passes defended

bk Dynamic Player blocked kicks

sp_tackle Dynamic Special teams player total tackles

sp_ast Dynamic Special teams player assisted tackles

sp_comb Dynamic Special teams player combined tackles

sp_force_fum Dynamic Special teams player forced fumbles

sp_fum_rec Dynamic Special teams player fumble recoveries

misc_tackle Dynamic Misc player total tackles

misc_ast Dynamic Misc player assisted tackles

misc_comb Dynamic Misc player combined tackles

misc_force_fum Dynamic Misc player forced fumbles

misc_fum_rec Dynamic Misc player fumble recoveries

blocked_punt_return returns Dynamic Team blocked punt returns

yds Dynamic Team blocked punt return yards

lg Dynamic Team long blocked punt return

td Dynamic Team blocked punts returned for a touchdown

avg Dynamic Team average blocked punt return yards











returns Dynamic Player blocked punt returns

yds Dynamic Player blocked punt return yards

lg Dynamic Player long blocked punt return

Updated 08.03.12


td Dynamic Player blocked punts returned for a touchdown

avg Dynamic Player average blocked punt return yards







returns Dynamic Team blocked field goal returns

yds Dynamic Team blocked field goal return yards

lg Dynamic Team long blocked field goal return

td Dynamic Team blocked field goals returned for a touchdown

avg Dynamic Team average blocked field goal return yards











returns Dynamic Player blocked field goal returns

yds Dynamic Player blocked field goal return yards

lg Dynamic Player long blocked field goal return

td Dynamic Player blocked field goals returned for a touchdown

avg Dynamic Player average blocked field goal return yards






Updated 08.03.12


Game Statistics Feed - File Naming Convention

Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/statistics-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/[year]/[nfl_season]/[nfl_season_week]/[away_team]/[home_team]/statistics.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [year] = yyyy [nfl_season] = Preseason (PRE), Regular Season (REG), Postseason (PST) [nfl_season_week] = 1 - 17 [format] = xml [home_team], [away_team] = <see schedule feed> Update Timing



Updated 08.03.12


Game Summary Feed – Details

This feed provides team comparisons for all major stat categories within a game, as well as deeper insights such as third/fourth down and red zone efficiency. It is modeled after the Final Team Statistics section of NFL.com’s Game Book.

Element/Attribute/Value Descriptions File Breakdown – Game Summary Feed

Element Attribute Values Description game Id GUID format Unique ID for a specific game











team




Child elements: first_downs, third_down_efficiency, fourth_down_efficiency, total_yards, rushing_yards, passing, return_yards, kickoffs, punts, penalties, fumbles, touchdowns, extra_points, field_goals, redzone_efficiency, goal_efficiency, safeties, turnovers, final_score, possession_time

first_downs total Dynamic Total first downs within game

Child elements: passing, rushing, penalty

passing N/A Dynamic Passing first downs

rushing N/A Dynamic Rushing first downs

penalty N/A Dynamic First downs from a penalty

third_down_efficiency att Dynamic Third down conversion attempts

converted Dynamic Third down conversions made

pct Dynamic Third down conversion percentage


passing N/A Dynamic Third down conversions via passing

Updated 08.03.12


rushing N/A Dynamic Third down conversions via rushing

penalty N/A Dynamic Third down conversions via penalties

fourth_down_efficiency att Dynamic Fourth down conversion attempts

converted Dynamic Fourth down conversions made

pct Dynamic Fourth down conversion percentage


passing N/A Dynamic Fourth down conversions via passing

rushing N/A Dynamic Fourth down conversions via rushing

penalty N/A Dynamic Fourth down conversions via penalties

total_yards plays Dynamic Total offensive plays in the game

yds Dynamic Total net yards

avg Dynamic Average yards per offensive play

rushing_yards plays Dynamic Rushing plays

yds Dynamic Net rushing yards

avg Dynamic Average gain per rushing play

passing att Dynamic Pass attempts

cmp Dynamic Pass completions

avg Dynamic Average yards per pass attempt

int Dynamic Intercepted passes

sack Dynamic Number of times sacked

Child elements: yards

yards net_yds Dynamic Net passing yards

gross_yds Dynamic Gross passing yards

sack_yds Dynamic Yards lost from sacks

return_yards total Dynamic Total return yards (not including kickoffs)

Child elements: punt_return, kickoff_return, int_return

punt_return number Dynamic Total number of punt returns

yds Dynamic Punt return yards

kickoff_return number Dynamic Total number of kickoff returns

yds Dynamic Kickoff return yards

int_return number Dynamic Total number of interception returns

yds Dynamic Interception return yards

kickoffs number Dynamic Total number of kickoffs

endzone Dynamic Kickoffs landing in end zone

tb Dynamic Kickoffs resulting in touchbacks

punts number Dynamic Total number of punts

avg Dynamic Average gross punt distance

Updated 08.03.12


blk Dynamic Number of punts blocked

net_avg Dynamic Net punting average

penalties number Dynamic Number of penalties

yds Dynamic Penalty yards

fumbles number Dynamic Number of fumbles

lost Dynamic Fumbles lost

touchdowns number Dynamic Total touchdowns

Child elements include: passing, rushing, interception, fumble_return, punt_return, kickoff_return, field_goal_return

passing N/A Dynamic Passing touchdowns

rushing N/A Dynamic Rushing touchdowns

interception N/A Dynamic Interceptions returned for a touchdown

fumble_return N/A Dynamic Fumbles returned for a touchdown

punt_return N/A Dynamic Punts returned for a touchdown

kickoff_return N/A Dynamic Kickoffs returned for a touchdown

field_goal_return N/A Dynamic Field goals returned for a touchdown

extra_points att Dynamic Extra points attempted

made Dynamic Extra points made

Child elements: kicking, two_points

kicking att Dynamic Extra point kick attempts

made Dynamic Extra point kicks made

blk Dynamic Extra point kicks blocked

two_points att Dynamic Two point conversion attempts

made Dynamic Two point conversions made

field_goals att Dynamic Field goals attempted

made Dynamic Field goals made

blk Dynamic Blocked field goal attempts

redzone_efficiency att Dynamic Red zone attempts

td Dynamic Red zone touchdowns

pct Dynamic Red zone efficiency (conversion) percentage

goal_efficiency att Dynamic Goal-to-go attempts

td Dynamic Goal-to-go touchdowns

pct Dynamic Goal-to-go efficiency (conversion) percentage

safeties number Dynamic Number of safeties by defense

turnovers number Dyanmic Number of turnovers

final_score N/A Dynamic Total points scored

possession_time N/A 00:00 Time of possession

Updated 08.03.12


Game Summary Feed - File Naming Convention

Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/summary-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/[year]/[nfl_season]/[nfl_season_week]/[away_team]/[home_team]/summary.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [year] = yyyy [nfl_season] = Preseason (PRE), Regular Season (REG), Postseason (PST) [nfl_season_week] = 1 - 17 [format] = xml [home_team], [away_team] = <see schedule feed>

Update Timing



Updated 08.03.12


Team Hierarchy Feed – Details


File Breakdown – Team Hierarchy Feed Element Attribute Values Description

league id NFL Abbreviated name of the league

Child elements: conference

conference

id AFC or NFC Abbreviated name for a specific conference

name AFC or NFC Abbreviated name for a specific conference

Child elements: division

division id e.g.

AFC_EAST


name e.g.

AFC EAST

Abbreviated name for a specifc division





Child elements: venue











Updated 08.03.12


Team Hierarchy Feed - File Naming Convention

Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/hierarchy-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/teams/hierarchy.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [format] = xml Update Timing

This feed will be updated as events occur. Copyright The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.

Updated 08.03.12


Team Roster Feed – Details

This feed provides player information for each team, including height/weight, jersey number, position, player status and injuries.


File Breakdown – Team Roster Feed Element Attribute Values Description







name_first Dynamic Player first name

name_last Dynamic Player last name

name_abbr Dynamic Abbreviated player name (first initial, last name)

birthdate Dynamic Player date of birth

height Dynamic Player height

weight Dynamic Player weight

college Dynamic Player college attended



status ACT Active

DUP Duplicate

EXE Exempt

IR Injured Reserve


NWT Not with team

PRA Practice Squad


RET Retired

SUS Suspended



salary Dynamic Player salary


injuries Root element of each injury; child elements: injury

Updated 08.03.12





OUT Out of game

PRO Probable

QST Questionable

UNK Unknown





Full Participation



Child elements: description


Updated 08.03.12


Team Roster Feed - File Naming Convention

Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/roster-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/teams/[team]/roster.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [year] = yyyy [team] = abbreviation for team (example: MIN, NE) [format] = xml [home_team], [away_team] = <see schedule feed>

Update Timing



Updated 08.03.12


Weekly Schedule Feed – Details

This feed provides the date, time, location and event details for every match-up in a season, as well as links to the other five main SportsData feeds.


File Breakdown – Weekly Schedule Feed Element Attribute Values Description

games season Dynamic The year in which the season began

week 1 to 17 The week in the season

Child elements: game

game id GUID format Unique ID for a specific game


home_rotation XX or XXX Home team rotation number

away_rotation XX or XXX Away team rotation number






complete The game is over, but stat validation is not done



Child elements: venue, weather, broadcast, links











weather temperature Dynamic Weather temperature at game kickoff

condition Dynamic Weather condition at game kickoff

Updated 08.03.12


humidity Dynamic Weather humidity at game kickoff

Child elements: wind

wind speed Dynamic Wind speed at game kickoff

direction Dynamic Wind direction at game kickoff

broadcast

network Dynamic Network broadcasting game

satellite Dynamic Satellite channel broadcasting game

internet Dynamic Internet site broadcasting game

cable Dynamic Cable channel broadcasting game

links N/A N/A Root element for feed links


link rel statistics Feed of team and player stats for a game

summary Feed of summary stats for a game

pbp Feed of play-by-play details for a game

boxscore Feed of a Boxscore for a game

roster Feed of team rosters for a game

injuries Feed of team injuries for a game

depthchart Feed of team depth chart for a game

href Dynamic The url linking to a specific feed


Updated 08.03.12


Weekly Schedule Feed - File Naming Convention

Schema Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/schema/schedule-v1.0.xsd?api_key=[your_api_key] Feed Syntax: http://api.sportsdatallc.org/nfl-[access_level][version]/[year]/[nfl_season]/[nfl_season_week]/schedule.[format]?api_key=[your_api_key] Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t) [version] = whole number (sequential, starting with the number 1) [year] = yyyy [nfl_season] = Preseason (PRE), Regular Season (REG), Postseason (PST) [nfl_season_week] = 1 – 17 [format] = xml Update Timing



nfl statistics feeds · updated 08.03.12 ! 6!sportsdata nfl statistics feeds ! stats list –...

Documents