XML Feed Customer Documentation

XML Soccer Boxscore Feed

This feed includes boxscores for all regular season and playoff games.

This feed will update for all leagues (except MLS) when games are 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)

Soccer Game Info

Item

MLS

BUND

LIG1

PREM

LIGA

ITA

CL

EURO

ERELIGAMX

Notes

Group

(error)

(error)

(error)

(error)

(error)

(error)

(error)

(error)

During "Group Stage" competition-type games.

Official Info

Item

MLS

BUND

LIG1

PREM

LIGA

ITA

CL

EURO

ERELIGAMX

Notes

Referee

(error)

 

Gaming Info

Item

MLS

BUND

LIG1

PREM

LIGA

ITA

CL

EURO

ERELIGAMX

Notes

Home odds

Decimal format.

Away odds

Decimal format.

Draw odds

Decimal format.

(warning) Included for both teams.

Stat

Description

MLS

BUND

LIG1

PREM

LIGA

ITA

CL

EURO

ERELIGAMX

Notes

goals

Total goals scored

 

Substitutions

(warning) Included for both home and visitor teams.

Item

MLS

BUND

LIG1

PREM

LIGA

ITA

CL

EURO

ERELIGAMX

Notes

Player

 

Substitution type

on/off

Half

 

Minute

 

Goals

(warning) Included for both home and visitor teams.

Item

MLS

BUND

LIG1

PREM

LIGA

ITA

CL

EURO

ERELIGAMX

Notes

Player

 

Goal type

Goal/Goal (pen)/Goal (og)

Half

 

Minute

 

Cards

(warning) Included for both home and visitor teams.

Item

MLS

BUND

LIG1

PREM

LIGA

ITA

CL

EURO

ERELIGAMX

Notes

Player

 

Card Type

yellow/red

Half

 

Minute

 

Team Stats

(warning) Included for both home and visitor teams.

Stat

Description

MLS

BUND

LIG1

PREM

LIGA

ITA

CL

EUROERELIGAMX

Notes

cornersNumber of corners taken

 
form_last_10Ex: WWWDWLDLWL

 
foulsNumber of fouls committed

 

games_clean

Clean games (no goals allowed)

 

games_lost

Games lost

 

games_played

Games played

 

games_scored_first

Games when the team scored first

 

games_tied

Games tied

 

games_won

Games won

 

goals

Goals

 

goals_half_1

1st half goals

 

goals_half_2

2nd half goals

 

goals_penalty

Penalty kick goals

 

offsidesNumber of times going offside

 
savesNumber of saves

 
shotsNumber of shots

 
shots_on_goalNumber of shots on goal

 
time_of_possession_percentagePercentage of time the team possessed the ball

 

Player Stats

(warning) Included for both home and visitor teams.

(warning) These stats are available in overall, home, and away forms.

Stat

Description

MLS

BUND

LIG1

PREM

LIGA

ITA

CL

EUROERELIGAMX

Notes

assistsAssists

 

discipline_points

Discipline points

 

fouls_committedNumber of fouls committed

 
fouls_drawnNumber of fouls drawn

 

goals

Goals

 

goals_half_1

1st half goals

 

goals_half_2

2nd half goals

 

goals_penalty

Penalty kick goals

 

goals_scored_first

First scorer of the game

 

offsidesNumber of times the player went offside

 

own_goals

Own-goals

 

red_cards

Red cards

 

savesNumber of saves

 
shotsNumber of shots taken

 
shots_on_goalNumber of shots on goal

 

yellow_cards

Yellow cards