XML Feed Customer Documentation

XML Football Boxscore Feed

This feed includes post-game boxscores for all pre-season (NFL only), regular season, playoff and all-star (NFL only) games.

This feed includes in-progress boxscores for NFL and NCAAF games only. For NFL, all regular season, playoff and all-star games are included. For NCAAF, top-25 regular season and all bowl games are included.

Some data may not be available while the game is in-progress.

Feed Information

(warning) Note that the URLs listed above are not valid; keywords in parentheses must be replaced with real values.

Common Data

League Data

Item

 

Notes

Sport Id

 

Sport Name

 

League Id

 

League Name

 

League Short Name

 

Season Data

Item

 

Notes

Id

 

Name

 

Start Date

 

End Date

 

Team Data

(warning) Included for both the home and visitor teams.

Item

 

Notes

Id

 

Display Name

 

Player Data

(warning) Included for all players involved in the game.

Item

 

Notes

Id

 

First Name

 

Last Name

 

City

 

State

For Canada, USA only.

Country

 

Venue Data

Item

 

Notes

Id

 

Name

 

Short Name

 

City

 

State

For Canada, USA only.

Country

 

Timezone

 

Capacity

Season-specific.

Field Type

Football and Baseball only.

 

Game Info

Item

 

Notes

Id

 

Start date/time

 

Continue Date

Continue date, if the game is/was suspended

Name

Name of event (if applicable)

Status

Scheduled, etc.

Game Type

Regular season, etc.

Neutral Site?

True/false

Day Game?

True/false

Date/time TBD?

True/false

Attendance

Typically not available until the game is complete.

QA Status

Post game metadata describing the completeness and verification of game statistics (verified/finalized)

Football Game Info

Item

NFL

NCAAF

CFL

AFL

Notes

Weather Conditions

(error)

(error)

Cloudy, Sunny, etc.; Available for 2014-15 season forward

Temperature

(error)

(error)

Degrees fahrenheit; Available for 2014-15 season forward

Wind Direction

(error)

(error)

Available for 2014-15 season forward

Wind Speed

(error)

(error)

MPH; Available for 2014-15 season forward

Lineup

(warning) Included for both home and visitor teams.
(warning) Players may have multiple lineups if they played multiple positions in the game.

Item

NFL

NCAAF

CFL

AFL

Notes

Status

(warning)

(error)

Starter, etc. Not fully entered for NCAAF.  In-Progress: Available as players enter the game.

Position

(warning)

(error)

Not fully entered for NCAAF.  In-Progress: Available as players enter the game.

Official Info (Post-Game)

Item

NFL

NCAAF

CFL

AFL

Notes

Referee

(error)

 

Umpire

(error)

 

Head Linesman

(error)

 

Line Judge

(error)

 

Side Judge

(error)

(error)

 

Back Judge

(error)

 

Field Judge

(error)

(error)

 

Replay Official

(error)

(error)

(error)

 

Video Operator

(error)

(error)

(error)

 

Scorer

(error)

(error)

(error)

 

Gaming Info

Item

NFL

NCAAF

CFL

AFL

Notes

Visitor Team Rotation Number

 

Home Team Rotation Number

 

Visitor Team Closing Spread

 

Home Team Closing Spread

 

Visitor Team Opening Spread

 

Home Team Opening Spread

 

Over/Under

 

Scoring Summary

(warning) Included for both home and visitor teams.

Item

NFL

NCAAF

CFL

AFL

Notes

Quarter

 

Time

 

Cumulative Score

(error)

(error)

(error)

(error)

calculated

Scoring Type (TD, FG, etc.)

 

How Scored (Pass, Rush, etc.)

 

Conversion (XPt Success, 2XPt Success, etc.)

(error)

For CFL, conversions are separate elements and the "scoring type" describes the conversion.

2XPt Conversion How (Rush, Pass, etc.)

(error)

For CFL, conversions are separate elements and the "how scored" describes the 2XPt conversion how.

Yardage

(error)

 

Scoring Player

(error)

 

From Player

(error)

 

Conversion Scoring Player

(error)

 

From Conversion Player

(error)

 

Team Stats

(warning) Included for both home and visitor teams.

Stat

Description

NFL

NCAAF

CFL

Notes

attendance_totalTotal attendance

 
defense_assisted_tacklesNumber of defense assisted tackles

(error)

(error)

 
defense_misc_assisted_tacklesNumber of defense miscellaneous assisted tackles

(error)

(error)

 
defense_misc_solo_tacklesNumber of defense miscellaneous solo tackles

(error)

(error)

 
defense_solo_tacklesNumber of defense solo tackles

(error)

(error)

 
defense_special_teams_assisted_tacklesNumber of special teams assisted tackles

(error)

(error)

 
defense_special_teams_solo_tacklesNumber of special teams solo tackles

(error)

(error)

 

extra_point_kicks_attempted

Number of kick attempts for extra points

(error)

(error)

 

extra_point_kicks_blocked

Number of blocked kick attempts for extra points

(error)

(error)

 

extra_point_kicks_succeeded

Number of successful kicks for extra points

(error)

 

extra_point_passes_attempted

Number of 2-point conversion pass attempts

(error)

(error)

 

extra_point_passes_succeeded

Number of successful 2-point conversion passes

(error)

(error)

 

extra_point_rushes_attempted

Number of 2-point conversion attempts

(error)

(error)

 

extra_point_rushes_succeeded

Number of successful 2-point conversions

(error)

(error)

 

failed_conversion_returnsNumber of failed conversion returns

(error)

(error)

 

field_goals_attempted

Number of field goal attempts

(error)

 

field_goals_blocked

Number of field goals blocked

(error)

(error)

 

field_goals_succeeded

Number of successful field goals

(error)

 

field_goals_succeeded_longest_yardsLongest successful field goal in yards

(error)

(error)

 

fourth_downs_attempted

Number of fourth downs attempted

(error)

 

fourth_downs_succeeded

Number of successful fourth downs

(error)

 

fumble_touchdowns

Number of touchdowns resulting from opposition fumbles

(error)

(error)

 

fumbles

Number of fumbles

 

fumbles_lost

Number of fumbled balls lost to opposition

 

fumbles_recovered_defenseNumber of fumbles recovered by defense

(error)

(error)

 
fumbles_recovered_offenseNumber of fumbles recovered by offense

(error)

(error)

 

games_lost

Number of games lost

 

games_played

Number of games played

 

games_tied

Number of games tied

(error)

(error)

 

games_won

Number of games won

 

goal_to_go_attempted

Number of goal-to-go attempts

(error)

(error)

 

goal_to_go_succeeded

Number of successful goal-to-go attempts

(error)

(error)

 

interception_return_longest_yards

Largest total of interception return yards in a game

(error)

 

interception_return_yards

Number of interception return yards

(error)

 

interception_returns

Number of interception returns

(error)

 

interception_touchdowns

Number of interception touchdowns

(error)

(error)

 

kickoff_return_longest_yards

Longest total of kickoff return yards in a game

(error)

 

kickoff_return_touchdowns

Number of touchdowns resulting from kickoff returns

(error)

(error)

 

kickoff_return_yards

Number of kickoff return yards

 

kickoff_returns

Number of kickoff returns

 

kickoff_touchbacks

Number of kickoff touchbacks

(error)

(error)

 

kickoffs

Number of kickoffs

(error)

(error)

 

kickoffs_in_end_zone

Number of kickoffs in the end zone

(error)

(error)

 

other_touchdowns

Number of other touch downs

(error)

(error)

 

passer_rating

Team passer rating

 

passing_first_downs

Number of first downs by passing

 

passing_gross_yards

Number of passing yards lost and gained

(error)

 

passing_longest_yards

Longest passing play for the team

(error)

(error)

 

passing_net_yards

Number of yards gained by passing

 

passing_plays_attempted

Number of passing plays attempted

 

passing_plays_completed

Number of successful passing plays

 

passing_plays_intercepted

Number of passing plays intercepted by opposition

 

passing_plays_sacked

Number of times QB was sacked by opposition

 

passing_sacked_yards

Number of yards lost when QB was sacked by opposition

(error)

 

passing_touchdowns

Number of passing touchdowns

(error)

 

penalties

Number of penalties

 

penalty_first_downs

Number of penalty first downs

 

penalty_yards

Number of penalty yards

 

points

Number of points made

 

points_overtime

Number of points made in overtime

 

points_quarter_1

Number of points made in the first quarter

 

points_quarter_2

Number of points made in the second quarter

 

points_quarter_3

Number of points made in the third quarter

 

points_quarter_4

Number of points made in the fourth quarter

 

points_overtime_?Number of points for each overtime quarter

  "?" denotes overtime number (ex: points_overtime_1)
punt_blocksNumber of punts blocked

(error)

(error)

 

punt_return_faircatches

Number of punt return fair catches

(error)

(error)

 

punt_return_longest_yards

Single longest punt return by the team

(error)

(error)

 

punt_return_touchdowns

Number of touch downs resulting from punt returns

(error)

(error)

 

punt_return_yards

Number of yards gained with punt returns

 

punt_returns

Number of punt returns

 

punting_gross_yards

Punt yards

(error)

This is a rounded value.

punting_inside_twenty

Number of punts putting the other team inside their 20

(error)

(error)

 

punting_longest_gross_yards

Largest total of gross punting yards in a game

(error)

 

punting_longest_net_yards

Largest total of punting net yards gained in a game

(error)

(error)

 

punting_longest_yards

Longest single punt by the team

(error)

(error)

 

punting_net_yards

Number of yards gained (punts - returns) by punting

(error)

This is a rounded value.

punting_net_yards_avg

Team net punting average

(error)

 

punting_plays

Number of punting plays

 

punting_plays_blocked

Number of punting plays blocked by opposition

(error)

(error)

 

own_fumbles_recovered_touchdownsNumber of own fumbles recovered for touchdowns

(error)

(error)

 

receiving_longest_yards

Longest receiving play for the team

(error)

(error)

 

red_zone_scores_attempted

Number of red zone scoring attempts

(error)

 

red_zone_scores_succeeded

Number of successful red zone scoring attempts

(error)

 

rushing_first_downs

Number of first downs when rushing

 

rushing_gross_yards

Number of all yards gained or lost

(error)

(error)

 

rushing_longest_yards

Longest rushing play for the team

(error)

(error)

 

rushing_losses

Number of rushes that resulted into lost yards (tackles for loss)

(error)

(error)

 

rushing_lost_yards

Number of yards lost in rushing plays

(error)

(error)

 

rushing_net_yards

Number of yards gained in rushing plays

 

rushing_plays

Number of run plays

 

rushing_touchdowns

Number of rushing touchdowns

(error)

 

safeties

Number of safeties

(error)

(error)

 

third_downs_attempted

Number of third downs attempted

(error)

 

third_downs_succeeded

Number of successful third downs

(error)

 

time_of_possession_secs

Time of possession, in seconds

 

time_of_possession_secs_overtime

Overtime time of possession, in seconds

(error)

 

time_of_possession_secs_quarter_1

First quarter time of possession, in seconds

(error)

 

time_of_possession_secs_quarter_2

Second quarter time of possession, in seconds

(error)

 

time_of_possession_secs_quarter_3

Third quarter time of possession, in seconds

(error)

 

time_of_possession_secs_quarter_4

Fourth quarter time of possession, in seconds

(error)

 

total_first_downs

Total number of first downs

 

total_touchdowns

Total number of touchdowns

(error)

 

Player Stats

(warning) Included for both home and visitor teams.

Stat

Description

NFL

NCAAF

CFL

AFL

Notes

defense_assisted_tackles

Number of regular assisted tackles

(error)

(error)

 

defense_forced_fumbles

Number of forced fumbles

(error)

(error)

 

defense_fumble_recoveries

Number of defensive fumble recoveries

(error)

(error)

(error)

 

defense_interception_yards

Number of defensive interception return yards

(error)

 

defense_interceptions

Number of defensive interceptions

 

defense_misc_assisted_tackles

Number of misc assisted tackles

(error)

(error)

 

defense_misc_solo_tackles

Number of misc solo tackles

(error)

(error)

 

defense_miscellaneous_fumble_recoveries

Number of miscellaneous fumble recoveries

(error)

(error)

(error)

 

defense_pass_defenses

Number of pass defenses

(error)

(error)

 

defense_sack_yards

Number of defensive sack yards

(error)

(error)

 

defense_sacks

Number of defensive sacks

(error)

 

defense_solo_tackles

Number of regular solo tackles

(error)

(error)

 

defense_special_teams_assisted_tackles

Number of special teams assisted tackles

(error)

(error)

 

defense_special_teams_fumble_recoveries

Number of special teams fumble recoveries

(error)

(error)

(error)

 

defense_special_teams_solo_tackles

Number of special teams solo tackles

(error)

(error)

 

defense_special_teams_tackles

Number of special teams tackles

(error)

(error)

(error)

(error)

 

defense_special_teams_kicks_blockedNumber of special teams kicks blocked

(error)

(error)

(error)

 

defense_tackles

Number of regular tackles

(error)

(error)

(error)

 

defense_tackles_for_loss

Number of defensive tackles for a loss

(error)

 

defense_tackles_for_loss_yards

Number of yards lost on defensive tackles for a loss

(error)

(error)

(error)

 

extra_point_kicks_attempted

Number of extra point kicks attempted

(error)

 

extra_point_kicks_succeeded

Number of extra point kicks made

 

field_goals_attempted

Number of field goals attempted

This stat is also available for yard ranges:
0-9, 10-19, 20-29, 30-39, 40-49, 50-59, 60-

field_goals_attempted_againstNumber of field goals attempted against

(error)

(error)

(error)

(error)

 

field_goals_blocked

Number of field goals blocked

(error)

(error)

(error)

(error)

 

field_goals_succeeded

Number of field goals made

This stat is also available for yard ranges:
0-9, 10-19, 20-29, 30-39, 40-49, 50-59, 60-

field_goals_succeeded_againstNumber of field goals succeeded against

(error)

(error)

(error)

(error)

 

field_goals_succeeded_longest_yards

Longest field goal made

(error)

 

field_goals_succeeded_yards

Number of yards from field goals made

(error)

(error)

(error)

 

fumbles

Number of fumbles

(error)

 

fumbles_lost

Number of fumbles lost

(error)

 

fumbles_recovered_lost_by_opposition

Number of fumbles recovered that were fumbled by the opposing team

(error)

(error)

(error)

 

fumbles_recovered_touchdownsNumber of fumbles recovered returned for touchdowns

(error)

(error)

(error)

 

fumbles_recovered_touchdowns_longest_yards

Longest fumble returned for a touchdown

(error)

(error)

(error)

(error)

 

fumble_yards_opponent_recoveredNumber of yards opposing team gained/lost on fumble

(error)

(error)

(error)

 
fumble_yards_own_recoveredNumber of yards gained/lost on fumble

(error)

(error)

(error)

 

games_played

Number of games played

(error)

(error)

Post-Game only.

games_started

Number of games started

(error)

(error)

 

interception_returned_longest_yards

Longest interception returned

(error)

(error)

(error)

 

interceptions_returned_touchdowns

Number of interceptions returned for touchdowns

(error)

(error)

(error)

 

interceptions_returned_touchdowns_longest_yards

Longest interception returned for a touchdown

(error)

(error)

(error)

(error)

 

kicking_singles

Kicking singles

(error)

(error)

(error)

(error)

 

kickoff_longest_yards

Longest kickoff

(error)

(error)

(error)

 

kickoff_return_faircatches

Number of kickoff return fair catches

(error)

(error)

(error)

 

kickoff_return_longest_yards

Longest kickoff return

(error)

 

kickoff_return_touchdowns

Number of kickoffs returned for touchdowns

(error)

(error)

(error)

 

kickoff_return_touchdowns_longest_yards

Longest kickoff returned for a touchdown

(error)

(error)

(error)

(error)

 

kickoff_return_yards

Number of kickoff return yards

(error)

 

kickoff_returns

Number of kickoff returns

(error)

 

kickoff_singles

Number of single points off kickoffs

(error)

(error)

(error)

(error)

 

kickoff_yards

Number of kickoff yards

(error)

(error)

(error)

 

kickoffs

Number of kickoffs

(error)

(error)

(error)

 

own_fumbles_recovered

Number of owned fumbles recovered

(error)

(error)

(error)

 

own_fumbles_recovered_touchdownsNumber of own fumbles recovered for touchdowns

(error)

(error)

(error)

 

passer_rating

Quarterback Passer Rating

 

passing_2pt_conversions_succeeded

Number of successful passing 2pt conversions

(error)

 

passing_gross_yardsNumber of gross passing yards

(error)

(error)

(error)

 
passing_net_yardsNumber of net passing yards

(error)

(error)

(error)

 

passing_longest_yards

Longest pass completion

(error)

(error)

 

passing_plays_attempted

Number of passing attempts

 

passing_plays_completed

Number of passing completions

 

passing_plays_intercepted

Number of interceptions thrown

 

passing_plays_sacked

Number of times sacked while passing

(error)

(error)

 

passing_sacked_yards

Number of sack yards

(error)

(error)

(error)

 

passing_touchdowns

Number of passes thrown for touchdowns

 

passing_touchdowns_longest_yards

Longest pass thrown for a touchdown

(error)

(error)

(error)

 

passing_yards

Net passing yards

 

penalty_yards

Number of penalty yards against

(error)

(error)

(error)

(error)

 

points

Total points

(error)

(error)

(error)

 

punt_return_faircatches

Number of punt return fair catches

(error)

(error)

(error)

 

punt_return_longest_yards

Longest punt return

(error)

(error)

 

punt_return_touchdowns

Number of punts returned for touchdowns

(error)

(error)

(error)

 

punt_return_touchdowns_longest_yards

Longest punt returned for a touchdown

(error)

(error)

(error)

(error)

 

punt_return_yards

Number of punt return yards

(error)

(error)

 

punt_returns

Number of punt returns

(error)

(error)

 

punting_gross_yards

Gross punting yards

(error)

(error)

 

punting_inside_twenty

Number of punts inside the 20

(error)

(error)

(error)

 

punting_longest_yards

Longest punt (gross)

(error)

 

punting_net_yards

Net punting yards

(error)

(error)

(error)

 

punting_plays

Number of punts

(error)

 

punting_plays_blocked

Number of blocked punts

(error)

(error)

(error)

 

punting_singles

Number of single points off punts

(error)

(error)

(error)

(error)

 

punting_touchbacks

Number of punting touchbacks

(error)

(error)

(error)

 

receiving_2pt_conversions_succeeded

Number of successful receiving 2pt conversions

(error)

 

receiving_longest_yards

Longest pass reception

(error)

(error)

 

receiving_receptions

Number of pass receptions

 

receiving_targeted

Number of times the player was targeted for a pass

(error)

(error)

(error)

 

receiving_touchdowns

Number of passes caught for touchdowns

 

receiving_touchdowns_longest_yards

Longest pass caught for a touchdown

(error)

(error)

(error)

 

receiving_yards

Number of receiving yards

 

rushing_2pt_conversions_succeeded

Number of successful rushing 2pt conversions

(error)

 

rushing_gross_yards

Gross rushing yards

(error)

(error)

(error)

 

rushing_longest_yards

Longest rush

(error)

(error)

 

rushing_lost_yards

Lost rushing yards

(error)

(error)

(error)

 

rushing_net_yards

Net rushing yards

 

rushing_plays

Number of rushes

 

rushing_touchdowns

Number of rushes for touchdowns

 

rushing_touchdowns_longest_yards

Longest rush for a touchdown

(error)

(error)

(error)

 

safeties

Number of safeties

(error)

(error)

(error)

 

starter_games_lost

Number of team losses when starting

(error)

(error)

Post-Game only.

starter_games_tied

Number of team ties when starting

(error)

(error)

Post-Game only.

starter_games_won

Number of team wins when starting

(error)

(error)

Post-Game only.

total_touchdowns

Total number of touchdowns

(error)