XML Feed Customer Documentation

XML Baseball Boxscore Feed

This feed includes boxscores for all MLB regular season and playoff games. Boxscores are not available for pre-season games.

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

Feed Information

Detail

Info

Update Interval

Periodically after the game starts, until the game is complete; Daily and when required

Atom feed keyword

/baseball/boxscores

HTTP MLB

http://xml.sportsdirectinc.com/sport/v2/baseball/MLB/boxscores/(season-name)/boxscore_MLB_(competition-id).xml

(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)

Baseball Game Info

Item

MLB

Notes

Game Duration

Duration of the game in minutes.

Weather Conditions

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

Temperature

Degrees fahrenheit; Available for 2014 season forward

Wind Direction

Available for 2014 season forward

Wind Speed

MPH; Available for 2014 season forward

Official Info

Item

MLB

Notes

Home Plate Umpire

In-Progress: May not be available for the first game of a series.

1B Umpire

In-Progress: May not be available for the first game of a series.

2B Umpire

In-Progress: May not be available for the first game of a series.

3B Umpire

In-Progress: May not be available for the first game of a series.

Batting Lineup

(warning) Included for both home and visitor teams.

Item

MLB

Notes

Batting Order

In-Progress: Available as players enter the game.

Batting Order Slot

In-Progress: Available as players enter the game.

Primary Position

In-Progress: Available as players enter the game.

Secondary Position

In-Progress: Available as players enter the game.

Batting Note (Post-Game)

(warning) Included for both home and visitor teams.

Item

MLB

Notes

note type

singled, homered, struck_out, walked, grounded_out, batted, flied_out, popped_out, etc.

hit for

player who this batter hit for

inning

inning which the note applies to

Pitching Lineup

(warning) Included for both home and visitor teams.

Item

MLB

Notes

Pitching Order

1 for starters

Pitcher Note (Post-Game)

(warning) Included for both home and visitor teams.

Item

MLB

Notes

batters-pitched-to

number of batters faced

inning

inning which the note applies to

Gaming Info

Item

MLB

Notes

Visitor Team Rotation Number

 

Home Team Rotation Number

 

Visitor Team Moneyline

 

Home Team Moneyline

 

Over/Under

 

Point Spread

 

Game Summary Data

(warning) Included for both teams.

Stat

Description

MLB

NCAABBL

Notes

hits

Total hits

 

runs

Total Runs scored

 

errors

Total errors made

 

Team Statistics

(warning) Included for both home and visitor teams.

Stat

Description

MLB

Notes

games_played

Games played (game context)

Post-Game only

games_won

Games won (game context)

Post-Game only

games_lost

Games lost (game context)

Post-Game only

 

 

Stat

Description

MLB

MiLBNCAABBL

Notes

at_bats

Times at bat

(error)

 

balks

balks

(error)

(error)

 

batting_average

Batting average

(error)

 

caught_stealing

Times caught stealing

(error)

 

complete_games

Complete games

(error)

(error)

 

double_plays

Double plays

(error)

 

doubles

Doubles

(error)

 

earned_run_average

ERA

(error)

(error)

 

earned_runs_against

Earned runs against

(error)

(error)

 

errors

Errors

(error)

 

flyball_outsFlyball outs

(error)

(error)

 
games_lostGames Lost

(error)

 
games_playedGames Played

(error)

 
games_wonGames Won

(error)

 
groundball_outsGroundball outs

(error)

 

grounded_into_double_plays

Grounded into double plays

(error)

(error)

 

hit_batters

Hit batters in a game

(error)

(error)

 

hit_by_pitch

Hits by pitch

(error)

(error)

 

hits

Hits

(error)

 

home_runs

Home runs

(error)

 

inningsInnings

(error)

(error)

 

intentional_walks

intentional walks

(error)

(error)

 

intentional_walks_against

Intentional walks against

(error)

(error)

 

left_on_base

Left on base

(error)

 

on_base_percentage

On base percentage

(error)

 

on_base_plus_slugging

On base plus slugging

(error)

 

outsOuts

(error)

(error)

 

outs_pitched

Total outs pitched

(error)

(error)

 

passed_balls

Passed balls

(error)

(error)

 

pickoffs

Pickoffs

(error)

(error)

 

pitchesPitches

(error)

(error)

 

rlisp_two_out

Runners left in scoring position, 2 out

(error)

(error)

 

runs

Runs

(error)

 

runs_batted_in

RBI

(error)

 

runs_inning_?

Runs in specific inning

(error)

 "?" denotes inning number (ex:runs_inning_1)

runs_inning_extra

Extra inning runs

(error)

 

sacrifice_flys

Sacrifice flys.

(error)

 

sacrifice_hits

Sacrifice hits.

(error)

 

saves

saves

(error)

(error)

 

shutouts

shutouts

(error)

 

slugging_percentage

Slugging percentage

(error)

 

stolen_bases

Stolen Bases

(error)

 

strikeouts

Number of strikeouts

(error)

 

team_left_on_base

Team Left on base

(error)

 

total_bases

Total bases

(error)

 

triple_playsTriple Plays

(error)

 

triples

Triples

(error)

 

two_out_left_on_base

Two out left on base

(error)

 

walks

Walks

(error)

 

whipWalks Plus Hits Per Inning Pitched

(error)

 

wild_pitches

Wild pitches

(error)

 

Player Statistics

(warning) Included for both home and visitor teams.

Hitter Statistics

Stat

Description

MLB

MiLB

Notes

at_bats

At Bats

(error)

 

batting_average

Batting Average

(error)

 

caught_stealing

Caught Stealing

(error)

 

doubles

Doubles

(error)

 

games_played

Games Played

(error)

Post-Game only.

games_started

Games Started

(error)

 

grounded_into_double_plays

Grounded Into Double Plays

(error)

 

hit_by_pitch

Hit By Pitches

(error)

 

hits

Hits

(error)

 

home_runs

Home Runs

(error)

 

intentional_walksIntentional walks

(error)

 Removed as of 2010

intentional_walks_against

Intentional walks against

(error)

 

left_on_base

Runners left on base

(error)

 

on_base_percentage

On Base Percentage

(error)

 

on_base_plus_slugging

OPS

(error)

 

rlisp_two_out

Runners left in scoring position, two out

(error)

 

runs

Runs

(error)

 

runs_batted_in

RBIs

(error)

 

sacrifice_flys

Sacrifice Flys

(error)

 

sacrifice_hits

Sacrifice Hits

(error)

 

slugging_percentage

Slugging Percentage

(error)

 

stolen_bases

Stolen Bases

(error)

 

strikeouts

Strikeouts

(error)

 

total_bases

Total Bases

(error)

 

triples

Triples

(error)

 

two_out_rbi

Two out, runs batted in

(error)

 

walks

Walks

(error)

 

Fielder Statistics

Stat

Description

MLB

MiLB

Notes

catcher_interferences

Catcher's Interference

(error)

 

catcher_stealers_allowed

Steals allowed by a catcher

(error)

 

catcher_stealers_caught

Stealers caught by a catcher

(error)

 

fielding_errors

Fielding Errors

(error)

 

outfield_assists

Outfield Assists

(error)

 

passed_balls

Passed Balls

(error)

 

Pitcher Statistics

Stat

Description

MLB

MiLB

Notes

balks

Number of balks.

(error)

 

batters_faced

Batters Faced

(error)

 

blown_saves

Number of Blown Saves

(error)

Post-Game only.

complete_games

Complete Games

(error)

Post-Game only.

earned_run_average

Earned Run Average

(error)

 

fielding_errors

Fielding Errors

(error)

 

fly_ball_outs

Number of Fly Balls Allowed

(error)

 

ground_ball_outs

Number of Ground Balls Allowed

(error)

 

holds

Number of Holds

(error)

Post-Game only.

inherited_runners

Inherited Runners

(error)

 

inherited_runners_scored

Inherited Runners Scored

(error)

 

losses

Number of Losses

(error)

Post-Game only.

no_decisions

Number of No-Decisions

(error)

Post-Game only.

outs_pitched

Outs Pitched

(error)

 

pickoffs

Pickoffs

(error)

 

pitcher_caught_stealing

Stolen Bases Caught Against

(error)

 

pitcher_earned_runs

Earned Runs Allowed

(error)

 

pitcher_games_played

Games Pitched

(error)

Post-Game only.

pitcher_games_started

Games Started Pitching

(error)

 

pitcher_hit_by_pitch

Hit By Pitches Allowed

(error)

 

pitcher_hits

Hits Allowed

(error)

 

pitcher_home_runs

Home Runs Allowed

(error)

 

pitcher_intentional_walks

Intentional Walks Allowed

(error)

 

pitcher_runs

Runs Allowed

(error)

 

pitcher_sacrifice_flys

Sacrifice Flys Against

(error)

Removed as of 2010

pitcher_sacrifice_hits

Sacrifice Hits Against

(error)

Removed as of 2010

pitcher_stolen_bases

Stolen Bases Successful Against

(error)

 

pitcher_strikeouts

Strikeouts

(error)

 

pitcher_walks

Walks Allowed

(error)

 

pitches_thrown

Pitches Thrown

(error)

 

quality_starts

Quality Starts

(error)

 

saves

Number of Saves

(error)

Post-Game only.

shutouts

Shutouts

(error)

Post-Game only.

starting_pitches_thrown

Total Pitches When Starting

(error)

 

strikes_thrown

Number of Strikes

(error)

 

whip

WHIP

(error)

 

wild_pitches

Wild Pitches

(error)

 

wins

Number of Wins

(error)

Post-Game only.

Game Events

Item

MLB

Notes

Sacrifice

Player, Player Role (batter), Type (Hit, Fly)

Steal

Player, Player Role (pitcher, runner, catcher), Base, Caught

Pickoff

Player, Player Role (runner, thrower), Base

Outfield Assist

Player, Player Role (runner, fielder), Base

Hit By Pitch

Player, Player Role (batter, pitcher)

Extra Base Hit

Player, Player Role (batter, pitcher), Type (2B, 3B, HR), Inning, On Base, Outs

Double Play

Player, Player Role (fielder)

Triple Play

Player, Player Role (fielder)

Intentional Walk

Player, Player Role

Passed Ball

Player, Player Role
Fielding Error

Player, Player Role, Catcher Interference

Gracenote, the Gracenote logo and logotype are either a registered trademark or a trademark of Gracenote, Inc. in the United States and/or other countries. © 2000-present. Gracenote, Inc. All rights reserved.