Xmlsoccer.com Documentation

Getting started

Ready, set, go!
This article describes the few steps its takes to get you started using the XMLSoccer.com API.

1. Sign up at xmlsoccer.com

To sign up on XMLSoccer.com, navigate here. All you need to specify is your desired username, password and a valid e-mail. No further information is needed.

2. Validate e-mail

After registering, you will receive an e-mail on the account you specified upon registration. Open the e-mail and click the "Activate link" found inside it.
A "success" page will be displayed.
This step is necessary to be able to use the API, as your personal API-key (which is essential for any methods used) is generated the instant that your e-mail is validated.

3. Find your API-key

Log into your account by clicking "log in" in the upperright corner of http://www.xmlsoccer.com. After you have logged in, access your account by clicking the "My account" tab.

You will find your API-key under "Service details". This is the API-key you will use in the future. Until you have made any subscriptions, it is only valid for the Demo-API. If and when you make any payments and becomes a full subscriber, the same API-key is good for the full API.

4. Try it out/Start developing

You are all set to try out the demo API. The demo API is not timelimited and lets you try all the functions of the full API but all data is restricted to the Scottish Premier League.

You find the demo API service here: http://www.xmlsoccer.com/FootballDataDemo.asmx

You find the full API here: http://www.xmlsoccer.com/FootballData.asmx

5. Buy subscription

When you are satisfied with the service and you feel ready to "go pro", you make a payment to subscribe to the full API. To ensure a secure and fluent buying experience, PayPal is used. You don't have to have a PayPal account as any major cards are supported by PayPal (Visa, Mastercard and others).

XMLSoccer.com automatically receives notifications of any payments you make. This means that your account is instantly upgraded to a full subscriber within seconds from PayPal confirmation - there is no manual administration delays in the process.

To begin using the full functionality, you need to change your Webservice URL's from http://www.xmlsoccer.com/FootballDataDemo.asmx to http://www.xmlsoccer.com/FootballData.asmx. As explained in step 3. your API-key is not changed and you don't have to do anything else.

Now XML-responses is not limited to the demo league anymore.
Secure payments are administrated by PayPal.

Pricelist

This page describes the current prices for access to XMLSoccer.com's pro API. XMLSoccer.com lets you try it before you buy it.

Prices

Period Amount Amount per month
1 month €10.00 €10.00
3 month €25.00 €8.33
12 month €90.00 €7.50

What do I get access to?

We follow the "all or nothing" principle. So it's a flatrate price that grants you access to all the leagues in the system in the above mentioned timeframe.

It's easy to get access and payment is handled through PayPal. Also, as soon as the payment is confirmed at PayPal, it is updated automatically at XMLSoccer.com and you are granted instant access. VAT is added automatically according to your country of residence if you live in EU. If you are a company placed in EU you need to add your VAT number under your account if you want to avoid having VAT added.

Go directly to XMLSoccer.com payment page if you are ready to subscribe.

Time interval limits

To reduce costs and keep the API as cheap, reliable and fast as possible, a number of limitations is enabled per API-key for the methods. The limits are as follows:

  • GetLiveScore: 20 seconds
  • GetLiveScoreByLeague: 20 seconds
  • GetOddsByFixtureMatchID: 3600 seconds
  • GetHistoricMatchesByLeagueAndSeason: 3600 seconds
  • GetAllTeams/GetAllTeamsByLeagueAndSeason: 3600 seconds
  • GetAllLeagues: 3600 seconds
  • All others: 300 seconds

Extended plan with no time limits is available, please contact us with your requirements. It is also possible to get a custom webservice developed for your need.

League/ID dependent*

Some of the methods, for example the GetLiveScoreByLeague, also takes the league as one of the input-parameters. All methods that does this also uses this parameter to calculate time between each call.

As an example: This means that it is perfectly legal for you to call the GetLeagueStandingsBySeason as quickly as possible as long as the league-parameter differs. This is practical when cycling through all of your leagues - just keep in mind that it must take 300 seconds before your next cycle begins (requesting data for the same leagues again).

One specific method (GetOddsByFixtureMatchID) is ID-dependent. This means that the timelimit only applies per match. (You cannot request odds information for the same match just after another call).

Demo service

To allow for flexibility when developing software, the demo league follow the same rules, but all timelimits is 5 seconds.

Input data formats

This article describes the format of various input-strings for all the methods looks like in order for the API to understand them properly. There are a number of different parameters and they should all be listed here.

API-key

The API-key is your personal key which you received upon registration and e-mail validation. It is found under "My Account" when you are logged in at https://www.xmlsoccer.com.

For more information on how to get one if you don't have on already, please go to "Getting started".

League

n some methods, it is necessary to specify what league you want data from. GetLiveScoreByLeague is an example of this.

The league parameter is a string and can either be the alphanumeric complete name, or the numeric ID: Both are valid and is understood by the API.

Examples

Both of these inputs will result in the API returning data from the English Premier League:

English Premier League 1

Obviously, the strings needs to be exact. This means that if you make a misspelling like:

English Premier League

The API will simply return nothing.

Team

In some methods, it is necessary to specify what team you want data from. GetTeam is an example of this.

The team parameter is a string and can either be the alphanumeric complete name, or the numeric ID: Both are valid and is understood by the API. In some methods the requested field is labeled "teamId" and in some others "teamName". This makes no difference: both values are still valid.

Examples

Both of these inputs will result in the API returning data from Birmingham City F.C.:

Inverness CT 1

Obviously, the strings needs to be exact. This means that if you make a misspelling like:

Brrmingham

The API will simply return nothing.

Team

In some methods, it is necessary to specify what team you want data from. GetTeam is an example of this.

The team parameter is a string and can either be the alphanumeric complete name, or the numeric ID: Both are valid and is understood by the API. In some methods the requested field is labeled "teamId" and in some others "teamName". This makes no difference: both values are still valid.

SeasonDateString

The seasonDateString parameter is the indicator of what season you are looking for. GetAllTeamsByLeagueAndSeason is an example of a method taking this input parameter. Valid inputs for seasons is the last two digits of the beggining of the season-year appended by the last two digits of the following year. NOTE - If you are using the .net dll, the input is StartYear (yyyy) - so for the 2012-2013 season, the .dll input value would be 2012.

Examples

To get the 2012-2013 season of the English Premier League, you specify:

1213

The 2008-2009 season subsequently would be:

0809

As of August 2013, it is now possible to get the current season by simply passing an empty string ("") as seasonDateString parameter. Bear in mind that as more leagues are added, we now see some leagues that do not follow the "traditional" cross-year strategy. The American "Major league" and the Swedish "Allsvenskan" is two examples of this, as they start in the beginning of the year and end in the end of the year. Despite of this, they too follow the same seasonDateString rules. So the 2013 season of the American "Major League" will need the input:

1314

StartDateString and endDateString

Many of the methods require either startDateString, endDateString or both. They use the same formats and is basically a date filter parameter for the API. The format follows "YYYY-MM-DD hh:mm" format. This means that if you would like specify the 3rd of April 2011 at 5 PM CET you input (times are CET):

2011-04-03 17:00

You don't have to specify the time, but if you do not 00:00 is defaulted:

2011-04-03

Webservice WSDL

The WSDL (WebService Description Language) is the XML-based interface description language that is used for describing the functionality offered by a web service. Each Webservice has its own WSDL, and xmlsoccer.com is no exception.

As XMLSoccer.com has two APIs (Demo and full), there are two WSDL's.

Full API WSDL

The full API WSDL can always be found here: http://www.xmlsoccer.com/FootballData.asmx?WSDL

Demo API WSDL

The Demo API WSDL can always be forund here: http://www.xmlsoccer.com/FootballDataDemo.asmx?WSDL

GetTopScorersByLeagueAndSeason Output

This article describes the following method:

The method returns a list of topscorers per league for the season requested. Only seasons from 2013-2014 and onward are compatible. Also notice that some minor leagues (and all cups) is not yet compatible with this method - most leagues is implemented.

Input parameters:

  • Api-Key
  • League
  • SeasonDateString

This method was implemented November 5th 2013.

Response

								
									<?xml version="1.0" encoding="utf-8"?>

<XMLSOCCER.COM>

  <Topscorer>

    <Rank>1</Rank>

    <Name>Daniel Sturridge</Name>

    <TeamName>Liverpool</TeamName>

    <Team_Id>6</Team_Id>

    <Nationality>England</Nationality>

    <Goals>8</Goals>

    <FirstScorer>4</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>1</Rank>

    <Name>Sergio Agüero</Name>

    <TeamName>Man City</TeamName>

    <Team_Id>18</Team_Id>

    <Nationality>Argentina</Nationality>

    <Goals>8</Goals>

    <FirstScorer>2</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>1</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>3</Rank>

    <Name>Robin van Persie</Name>

    <TeamName>Man United</TeamName>

    <Team_Id>17</Team_Id>

    <Nationality>Netherlands</Nationality>

    <Goals>6</Goals>

    <FirstScorer>3</FirstScorer>

    <Penalties>1</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>3</Rank>

    <Name>Aaron Ramsey</Name>

    <TeamName>Arsenal</TeamName>

    <Team_Id>9</Team_Id>

    <Nationality>Wales</Nationality>

    <Goals>6</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>3</Rank>

    <Name>Loic Remy</Name>

    <TeamName>Newcastle</TeamName>

    <Team_Id>8</Team_Id>

    <Nationality>France</Nationality>

    <Goals>6</Goals>

    <FirstScorer>2</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>3</Rank>

    <Name>Luis Suarez</Name>

    <TeamName>Liverpool</TeamName>

    <Team_Id>6</Team_Id>

    <Nationality>Uruguay</Nationality>

    <Goals>6</Goals>

    <FirstScorer>2</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>7</Rank>

    <Name>Olivier Giroud</Name>

    <TeamName>Arsenal</TeamName>

    <Team_Id>9</Team_Id>

    <Nationality>France</Nationality>

    <Goals>5</Goals>

    <FirstScorer>4</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>7</Rank>

    <Name>Yaya Touré</Name>

    <TeamName>Man City</TeamName>

    <Team_Id>18</Team_Id>

    <Nationality>Ivory_Coast</Nationality>

    <Goals>5</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>7</Rank>

    <Name>Wayne Rooney</Name>

    <TeamName>Man United</TeamName>

    <Team_Id>17</Team_Id>

    <Nationality>England</Nationality>

    <Goals>5</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>7</Rank>

    <Name>Romelu Lukaku</Name>

    <TeamName>Everton</TeamName>

    <Team_Id>20</Team_Id>

    <Nationality>Belgium</Nationality>

    <Goals>5</Goals>

    <FirstScorer>3</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>11</Rank>

    <Name>Christian Benteke</Name>

    <TeamName>Aston Villa</TeamName>

    <Team_Id>5</Team_Id>

    <Nationality>Belgium</Nationality>

    <Goals>4</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>1</Penalties>

    <MissedPenalties>2</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>11</Rank>

    <Name>Roberto Soldado</Name>

    <TeamName>Tottenham</TeamName>

    <Team_Id>21</Team_Id>

    <Nationality>Spain</Nationality>

    <Goals>4</Goals>

    <FirstScorer>3</FirstScorer>

    <Penalties>3</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>11</Rank>

    <Name> Oscar</Name>

    <TeamName>Chelsea</TeamName>

    <Team_Id>15</Team_Id>

    <Nationality>Brazil</Nationality>

    <Goals>4</Goals>

    <FirstScorer>3</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>11</Rank>

    <Name>Alvaro Negredo</Name>

    <TeamName>Man City</TeamName>

    <Team_Id>18</Team_Id>

    <Nationality>Spain</Nationality>

    <Goals>4</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>15</Rank>

    <Name>Rickie Lambert</Name>

    <TeamName>Southampton</TeamName>

    <Team_Id>41</Team_Id>

    <Nationality>England</Nationality>

    <Goals>3</Goals>

    <FirstScorer>2</FirstScorer>

    <Penalties>1</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>15</Rank>

    <Name>David Silva</Name>

    <TeamName>Man City</TeamName>

    <Team_Id>18</Team_Id>

    <Nationality>Spain</Nationality>

    <Goals>3</Goals>

    <FirstScorer>2</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>15</Rank>

    <Name>Edin Dzeko</Name>

    <TeamName>Man City</TeamName>

    <Team_Id>18</Team_Id>

    <Nationality>Bosnia_Herzegovina</Nationality>

    <Goals>3</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>15</Rank>

    <Name>Robert Brady</Name>

    <TeamName>Hull</TeamName>

    <Team_Id>22</Team_Id>

    <Nationality>Ireland</Nationality>

    <Goals>3</Goals>

    <FirstScorer>2</FirstScorer>

    <Penalties>2</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>15</Rank>

    <Name>Gylfi Sigurdsson</Name>

    <TeamName>Tottenham</TeamName>

    <Team_Id>21</Team_Id>

    <Nationality>Iceland</Nationality>

    <Goals>3</Goals>

    <FirstScorer>2</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>15</Rank>

    <Name>Eden Hazard</Name>

    <TeamName>Chelsea</TeamName>

    <Team_Id>15</Team_Id>

    <Nationality>Belgium</Nationality>

    <Goals>3</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>15</Rank>

    <Name>Jay Rodriguez</Name>

    <TeamName>Southampton</TeamName>

    <Team_Id>41</Team_Id>

    <Nationality>England</Nationality>

    <Goals>3</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Pajtim Kasami</Name>

    <TeamName>Fulham</TeamName>

    <Team_Id>4</Team_Id>

    <Nationality>Switzerland</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Ross Barkley</Name>

    <TeamName>Everton</TeamName>

    <Team_Id>20</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Danny Welbeck</Name>

    <TeamName>Man United</TeamName>

    <Team_Id>17</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Bony Wilfried</Name>

    <TeamName>Swansea</TeamName>

    <Team_Id>19</Team_Id>

    <Nationality>Ivory_Coast</Nationality>

    <Goals>2</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>1</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Gareth McAuley</Name>

    <TeamName>West Brom</TeamName>

    <Team_Id>16</Team_Id>

    <Nationality>N__Ireland</Nationality>

    <Goals>2</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Jack Wilshere</Name>

    <TeamName>Arsenal</TeamName>

    <Team_Id>9</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Samir Nasri</Name>

    <TeamName>Man City</TeamName>

    <Team_Id>18</Team_Id>

    <Nationality>France</Nationality>

    <Goals>2</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Darren Bent</Name>

    <TeamName>Fulham</TeamName>

    <Team_Id>4</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Lukas Podolski</Name>

    <TeamName>Arsenal</TeamName>

    <Team_Id>9</Team_Id>

    <Nationality>Germany</Nationality>

    <Goals>2</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Emanuele Giaccherini</Name>

    <TeamName>Sunderland</TeamName>

    <Team_Id>7</Team_Id>

    <Nationality>Italy</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Craig Gardner</Name>

    <TeamName>Sunderland</TeamName>

    <Team_Id>7</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>1</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Fraizer Campbell</Name>

    <TeamName>Cardiff</TeamName>

    <Team_Id>44</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name> Michu</Name>

    <TeamName>Swansea</TeamName>

    <Team_Id>19</Team_Id>

    <Nationality>Spain</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Ben Davies</Name>

    <TeamName>Swansea</TeamName>

    <Team_Id>19</Team_Id>

    <Nationality>Wales</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Hatem Ben Arfa</Name>

    <TeamName>Newcastle</TeamName>

    <Team_Id>8</Team_Id>

    <Nationality>France</Nationality>

    <Goals>2</Goals>

    <FirstScorer>2</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Steven Fletcher</Name>

    <TeamName>Sunderland</TeamName>

    <Team_Id>7</Team_Id>

    <Nationality>Scotland</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Dwight Gayle</Name>

    <TeamName>Crystal Palace</TeamName>

    <Team_Id>38</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>1</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Yohan Cabaye</Name>

    <TeamName>Newcastle</TeamName>

    <Team_Id>8</Team_Id>

    <Nationality>France</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Steve Sidwell</Name>

    <TeamName>Fulham</TeamName>

    <Team_Id>4</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Yoan Gouffran</Name>

    <TeamName>Newcastle</TeamName>

    <Team_Id>8</Team_Id>

    <Nationality>France</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Leighton Baines</Name>

    <TeamName>Everton</TeamName>

    <Team_Id>20</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Morgan Amalfitano</Name>

    <TeamName>West Brom</TeamName>

    <Team_Id>16</Team_Id>

    <Nationality>France</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Ravel Morrison</Name>

    <TeamName>West Ham</TeamName>

    <Team_Id>43</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Jordon Mutch</Name>

    <TeamName>Cardiff</TeamName>

    <Team_Id>44</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Steven Caulker</Name>

    <TeamName>Cardiff</TeamName>

    <Team_Id>44</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>2</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Saido Berahino</Name>

    <TeamName>West Brom</TeamName>

    <Team_Id>16</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Jonathan Howson</Name>

    <TeamName>Norwich</TeamName>

    <Team_Id>13</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>1</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Steven Gerrard</Name>

    <TeamName>Liverpool</TeamName>

    <Team_Id>6</Team_Id>

    <Nationality>England</Nationality>

    <Goals>2</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>2</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <Topscorer>

    <Rank>22</Rank>

    <Name>Adnan Januzaj</Name>

    <TeamName>Man United</TeamName>

    <Team_Id>17</Team_Id>

    <Nationality>Belgium</Nationality>

    <Goals>2</Goals>

    <FirstScorer>0</FirstScorer>

    <Penalties>0</Penalties>

    <MissedPenalties>0</MissedPenalties>

  </Topscorer>

  <AccountInformation>Data requested at xx-xx-xxxx xx:xx:xx from xxx.xxx.xxx.xxx, Username: xxxx. Your current supscription runs out on xx-xx-xxxx xx:xx:xx.</AccountInformation>

</XMLSOCCER.COM>								
							

GetAllOddsByFixtureMatchId Output

This is the method for returning odds. This replaces all other methods which is now Legacy (but will still be up for some time for backward compatibility).

Find the method here: https://www.xmlsoccer.com/footballdata.asmx?op=GetAllOddsByFixtureMatchId It returns all odds and all oddstypes for a specific match. Return example:

Response

								
									<?xml version="1.0" encoding="utf-8"?> <XMLSOCCER.COM>

 <OddsList>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>Bet-At-Home</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:36.607</UpdatedDate>
     <Type>Over/Under 2.5</Type>
     <HomeOdds>2.15</HomeOdds>
     <AwayOdds>1.6</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>Interwetten</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:36.7</UpdatedDate>
     <Type>Over/Under 2.5</Type>
     <HomeOdds>2</HomeOdds>
     <AwayOdds>1.6</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>BetSafe</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:36.777</UpdatedDate>
     <Type>Over/Under 2.5</Type>
     <HomeOdds>2.15</HomeOdds>
     <AwayOdds>1.62</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>Bet-At-Home</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:37.433</UpdatedDate>
     <Type>Handicap</Type>
     <HomeOdds>1.06</HomeOdds>
     <DrawOdds>7</DrawOdds>
     <AwayOdds>16.25</AwayOdds>
     <Handicap>2</Handicap>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>Bet-At-Home</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:36.963</UpdatedDate>
     <Type>Double Chance</Type>
     <HomeOdds>1.28</HomeOdds>
     <DrawOdds>1.5</DrawOdds>
     <AwayOdds>1.3</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>BetSafe</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:37.167</UpdatedDate>
     <Type>Double Chance</Type>
     <HomeOdds>1.29</HomeOdds>
     <DrawOdds>1.5</DrawOdds>
     <AwayOdds>1.29</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>Expekt</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:37.26</UpdatedDate>
     <Type>Double Chance</Type>
     <HomeOdds>1.3</HomeOdds>
     <DrawOdds>1.55</DrawOdds>
     <AwayOdds>1.28</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>BetClic</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:37.34</UpdatedDate>
     <Type>Double Chance</Type>
     <HomeOdds>1.3</HomeOdds>
     <DrawOdds>1.5</DrawOdds>
     <AwayOdds>1.28</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>888</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:36.887</UpdatedDate>
     <Type>Double Chance</Type>
     <HomeOdds>1.27</HomeOdds>
     <DrawOdds>1.52</DrawOdds>
     <AwayOdds>1.29</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>Unibet</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:37.073</UpdatedDate>
     <Type>Double Chance</Type>
     <HomeOdds>1.27</HomeOdds>
     <DrawOdds>1.52</DrawOdds>
     <AwayOdds>1.29</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>188Bet</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:37.59</UpdatedDate>
     <Type>Asian Handicap</Type>
     <HomeOdds>1.91</HomeOdds>
     <AwayOdds>1.97</AwayOdds>
     <Handicap>-0.25</Handicap>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>BetSafe</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:37.683</UpdatedDate>
     <Type>Asian Handicap</Type>
     <HomeOdds>1.61</HomeOdds>
     <AwayOdds>2.15</AwayOdds>
     <Handicap>0</Handicap>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>WilliamHill</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:37.51</UpdatedDate>
     <Type>Asian Handicap</Type>
     <HomeOdds>1.5</HomeOdds>
     <AwayOdds>2.5</AwayOdds>
     <Handicap>0</Handicap>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>5Dimes</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:36.043</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.23</HomeOdds>
     <DrawOdds>3.05</DrawOdds>
     <AwayOdds>3.47</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>Unibet</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:35.557</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.2</HomeOdds>
     <DrawOdds>3</DrawOdds>
     <AwayOdds>3.1</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>Bet365</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:35.403</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.1</HomeOdds>
     <DrawOdds>3</DrawOdds>
     <AwayOdds>3.5</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>WilliamHill</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:35.307</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.1</HomeOdds>
     <DrawOdds>3</DrawOdds>
     <AwayOdds>3.3</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>Expekt</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:35.48</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.2</HomeOdds>
     <DrawOdds>3.2</DrawOdds>
     <AwayOdds>3</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>BetSafe</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:35.653</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.25</HomeOdds>
     <DrawOdds>3</DrawOdds>
     <AwayOdds>3</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>888</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:35.76</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.2</HomeOdds>
     <DrawOdds>3</DrawOdds>
     <AwayOdds>3.1</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>Bet-At-Home</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:35.84</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.15</HomeOdds>
     <DrawOdds>2.9</DrawOdds>
     <AwayOdds>3.15</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>Interwetten</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:35.963</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.2</HomeOdds>
     <DrawOdds>3</DrawOdds>
     <AwayOdds>2.9</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>BetClic</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:36.183</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.25</HomeOdds>
     <DrawOdds>3.1</DrawOdds>
     <AwayOdds>2.9</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>188Bet</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:36.26</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.2</HomeOdds>
     <DrawOdds>3.1</DrawOdds>
     <AwayOdds>3.05</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>10Bet</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:36.37</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.15</HomeOdds>
     <DrawOdds>3.05</DrawOdds>
     <AwayOdds>3.1</AwayOdds>
   </Odds>
   <Odds>
     <FixtureMatch_Id>342827</FixtureMatch_Id>
     <Bookmaker>Sportingbet</Bookmaker>
     <UpdatedDate>2014-09-28T14:28:36.497</UpdatedDate>
     <Type>1X2</Type>
     <HomeOdds>2.15</HomeOdds>
     <DrawOdds>3.1</DrawOdds>
     <AwayOdds>3.05</AwayOdds>
   </Odds>
 </OddsList>
 <AccountInformation>Data requested at 10/24/2014 8:38:49 PM from x.x.x.x, Username: xxx. Your current supscription runs out on 11/13/2020 11:01:25 AM.</AccountInformation>								
							

GetPlayers output

This section describes the two methods that are used to retrieve either a specific player data or a list of players for a specific team.

GetPlayersByTeam

Request data using either the numeric ID of the team or the name (string) of the team - similar to other methods.

GetPlayerById

Use numeric ID of the specific player you want to retrieve data from.

Response

								
									
<Player>
 	<Id>1422</Id>
 	<Name>Ryan Bertrand </Name>
 	<Height>1.78</Height>
 	<Weight>63.49</Weight>
 	<Nationality>England</Nationality>
 	<Position>Defender</Position>
 	<Team_Id>15</Team_Id>
 	<PlayerNumber>23</PlayerNumber>
 	<DateOfBirth>1989-08-05T00:00:00-07:00</DateOfBirth>
 	<DateOfSigning>2006-07-01T00:00:00-07:00</DateOfSigning>
 	<Signing>Trainee</Signing>
</Player>								
							

The PlayerDetails for livescore data is not mapped to these ID's right now. A solution is being worked on -- until then, use these methods for squad details only.

GetAllGroupsByLeagueAndSeason Output

This method returns all groups by league and season.

Response

								
									<XMLSOCCER.COM>

<Group>
   <Name>Group A</Name>
   <Season>1415</Season>
   <League_Id>43</League_Id>
 </Group>
 <Group>
   <Id>2</Id>
   <Name>Group B</Name>
   <Season>1415</Season>
   <League_Id>43</League_Id>
 </Group>
 <Group>
   <Id>3</Id>
   <Name>Group C</Name>
   <Season>1415</Season>
   <League_Id>43</League_Id>
 </Group>
 <Group>
   <Id>4</Id>
   <Name>Group D</Name>
   <Season>1415</Season>
   <League_Id>43</League_Id>
 </Group>
 <Group>
   <Id>5</Id>
   <Name>Group E</Name>
   <Season>1415</Season>
   <League_Id>43</League_Id>
 </Group>
 <Group>
   <Id>6</Id>
   <Name>Group F</Name>
   <Season>1415</Season>
   <League_Id>43</League_Id>
 </Group>
 <Group>
   <Id>7</Id>
   <Name>Group G</Name>
   <Season>1415</Season>
   <League_Id>43</League_Id>
 </Group>
 <Group>
   <Id>10</Id>
   <Name>Group H</Name>
   <Season>1415</Season>
   <League_Id>43</League_Id>
 </Group>
 <AccountInformation>Data requested at 5/24/2014 12:01:33 AM from zz.zz.zz, Username: Espectro. Your current supscription runs out on 11/13/2020 11:01:25 AM.</AccountInformation>								
							

GetCupStandingsByGroupId output

This method returns all CupStandings by Group ID. The resultset is similar to leaguestandings except an added Group and Group_Id property.

Response

								
									<XMLSOCCER.COM>
 <TeamCupStanding xmlns="http://xmlsoccer.com/TeamCupStanding">
   <Team>Netherlands</Team>
   <Team_Id>321</Team_Id>
   <Played>0</Played>
   <PlayedAtHome>0</PlayedAtHome>
   <PlayedAway>0</PlayedAway>
   <Won>0</Won>
   <Draw>0</Draw>
   <Lost>0</Lost>
   <Goals_For>0</Goals_For>
   <Goals_Against>0</Goals_Against>
   <Goal_Difference>0</Goal_Difference>
   <Points>0</Points>
   <Group>Group B</Group>
   <Group_Id>2</Group_Id>
 </TeamCupStanding>
 <TeamCupStanding xmlns="http://xmlsoccer.com/TeamCupStanding">
   <Team>Spain</Team>
   <Team_Id>325</Team_Id>
   <Played>0</Played>
   <PlayedAtHome>0</PlayedAtHome>
   <PlayedAway>0</PlayedAway>
   <Won>0</Won>
   <Draw>0</Draw>
   <Lost>0</Lost>
   <Goals_For>0</Goals_For>
   <Goals_Against>0</Goals_Against>
   <Goal_Difference>0</Goal_Difference>
   <Points>0</Points>
   <Group>Group B</Group>
   <Group_Id>2</Group_Id>
 </TeamCupStanding>
 <TeamCupStanding xmlns="http://xmlsoccer.com/TeamCupStanding">
   <Team>Chile</Team>
   <Team_Id>959</Team_Id>
   <Played>0</Played>
   <PlayedAtHome>0</PlayedAtHome>
   <PlayedAway>0</PlayedAway>
   <Won>0</Won>
   <Draw>0</Draw>
   <Lost>0</Lost>
   <Goals_For>0</Goals_For>
   <Goals_Against>0</Goals_Against>
   <Goal_Difference>0</Goal_Difference>
   <Points>0</Points>
   <Group>Group B</Group>
   <Group_Id>2</Group_Id>
 </TeamCupStanding>
 <TeamCupStanding xmlns="http://xmlsoccer.com/TeamCupStanding">
   <Team>Australia</Team>
   <Team_Id>960</Team_Id>
   <Played>0</Played>
   <PlayedAtHome>0</PlayedAtHome>
   <PlayedAway>0</PlayedAway>
   <Won>0</Won>
   <Draw>0</Draw>
   <Lost>0</Lost>
   <Goals_For>0</Goals_For>
   <Goals_Against>0</Goals_Against>
   <Goal_Difference>0</Goal_Difference>
   <Points>0</Points>
   <Group>Group B</Group>
   <Group_Id>2</Group_Id>
 </TeamCupStanding>
 <AccountInformation>Data requested at 5/23/2014 11:54:27 PM from x.x.x.x, Username: Espectro. Your current supscription runs out on 11/13/2020 11:01:25 AM.</AccountInformation>								
							

GetLeagueStandingsBySeason Output

This method (GetLeagueStandingsBySeason ) returns the current or previous league standing depending on input parameters. Beware that for future cups (starting in 2014 and later), group standings is now supported (Leaguestandings for cups doesn't make any sense). The method is called "GetCupStandingsByGroupId" and is only available as a paying client since the demo league does not contain any groups (it is not a cup).

Input parameters

The following parameter values were used for this resultset:

  • league: Scottish Premier League
  • seasonDateString: 2014

Response

								
									<XMLSOCCER.COM>
  <TeamLeagueStanding>
    <Team>Man United</Team>
    <Team_Id>17</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>23</Won>
    <Draw>2</Draw>
    <Lost>3</Lost>
    <NumberOfShots>599</NumberOfShots>
    <YellowCards>43</YellowCards>
    <RedCards>0</RedCards>
    <Goals_For>68</Goals_For>
    <Goals_Against>31</Goals_Against>
    <Goal_Difference>37</Goal_Difference>
    <Points>71</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Man City</Team>
    <Team_Id>18</Team_Id>
    <Played>27</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>13</PlayedAway>
    <Won>16</Won>
    <Draw>8</Draw>
    <Lost>3</Lost>
    <NumberOfShots>677</NumberOfShots>
    <YellowCards>45</YellowCards>
    <RedCards>3</RedCards>
    <Goals_For>50</Goals_For>
    <Goals_Against>24</Goals_Against>
    <Goal_Difference>26</Goal_Difference>
    <Points>56</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Chelsea</Team>
    <Team_Id>15</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>15</Won>
    <Draw>7</Draw>
    <Lost>6</Lost>
    <NumberOfShots>625</NumberOfShots>
    <YellowCards>39</YellowCards>
    <RedCards>2</RedCards>
    <Goals_For>56</Goals_For>
    <Goals_Against>30</Goals_Against>
    <Goal_Difference>26</Goal_Difference>
    <Points>52</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Tottenham</Team>
    <Team_Id>21</Team_Id>
    <Played>27</Played>
    <PlayedAtHome>13</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>15</Won>
    <Draw>6</Draw>
    <Lost>6</Lost>
    <NumberOfShots>704</NumberOfShots>
    <YellowCards>33</YellowCards>
    <RedCards>2</RedCards>
    <Goals_For>47</Goals_For>
    <Goals_Against>32</Goals_Against>
    <Goal_Difference>15</Goal_Difference>
    <Points>51</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Arsenal</Team>
    <Team_Id>9</Team_Id>
    <Played>27</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>13</PlayedAway>
    <Won>13</Won>
    <Draw>8</Draw>
    <Lost>6</Lost>
    <NumberOfShots>627</NumberOfShots>
    <YellowCards>27</YellowCards>
    <RedCards>3</RedCards>
    <Goals_For>52</Goals_For>
    <Goals_Against>30</Goals_Against>
    <Goal_Difference>22</Goal_Difference>
    <Points>47</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Everton</Team>
    <Team_Id>20</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>11</Won>
    <Draw>12</Draw>
    <Lost>5</Lost>
    <NumberOfShots>643</NumberOfShots>
    <YellowCards>39</YellowCards>
    <RedCards>2</RedCards>
    <Goals_For>44</Goals_For>
    <Goals_Against>35</Goals_Against>
    <Goal_Difference>9</Goal_Difference>
    <Points>45</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Liverpool</Team>
    <Team_Id>6</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>11</Won>
    <Draw>9</Draw>
    <Lost>8</Lost>
    <NumberOfShots>750</NumberOfShots>
    <YellowCards>38</YellowCards>
    <RedCards>2</RedCards>
    <Goals_For>53</Goals_For>
    <Goals_Against>34</Goals_Against>
    <Goal_Difference>19</Goal_Difference>
    <Points>42</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Swansea</Team>
    <Team_Id>19</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>10</Won>
    <Draw>10</Draw>
    <Lost>8</Lost>
    <NumberOfShots>541</NumberOfShots>
    <YellowCards>44</YellowCards>
    <RedCards>2</RedCards>
    <Goals_For>39</Goals_For>
    <Goals_Against>34</Goals_Against>
    <Goal_Difference>5</Goal_Difference>
    <Points>40</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>West Brom</Team>
    <Team_Id>16</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>12</Won>
    <Draw>4</Draw>
    <Lost>12</Lost>
    <NumberOfShots>493</NumberOfShots>
    <YellowCards>46</YellowCards>
    <RedCards>2</RedCards>
    <Goals_For>38</Goals_For>
    <Goals_Against>37</Goals_Against>
    <Goal_Difference>1</Goal_Difference>
    <Points>40</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Fulham</Team>
    <Team_Id>4</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>8</Won>
    <Draw>9</Draw>
    <Lost>11</Lost>
    <NumberOfShots>516</NumberOfShots>
    <YellowCards>30</YellowCards>
    <RedCards>1</RedCards>
    <Goals_For>39</Goals_For>
    <Goals_Against>44</Goals_Against>
    <Goal_Difference>-5</Goal_Difference>
    <Points>33</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Stoke</Team>
    <Team_Id>14</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>7</Won>
    <Draw>12</Draw>
    <Lost>9</Lost>
    <NumberOfShots>354</NumberOfShots>
    <YellowCards>55</YellowCards>
    <RedCards>3</RedCards>
    <Goals_For>26</Goals_For>
    <Goals_Against>33</Goals_Against>
    <Goal_Difference>-7</Goal_Difference>
    <Points>33</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>West Ham</Team>
    <Team_Id>43</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>9</Won>
    <Draw>6</Draw>
    <Lost>13</Lost>
    <NumberOfShots>477</NumberOfShots>
    <YellowCards>49</YellowCards>
    <RedCards>1</RedCards>
    <Goals_For>32</Goals_For>
    <Goals_Against>41</Goals_Against>
    <Goal_Difference>-9</Goal_Difference>
    <Points>33</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Norwich</Team>
    <Team_Id>13</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>7</Won>
    <Draw>11</Draw>
    <Lost>10</Lost>
    <NumberOfShots>429</NumberOfShots>
    <YellowCards>34</YellowCards>
    <RedCards>0</RedCards>
    <Goals_For>27</Goals_For>
    <Goals_Against>45</Goals_Against>
    <Goal_Difference>-18</Goal_Difference>
    <Points>32</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Sunderland</Team>
    <Team_Id>7</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>7</Won>
    <Draw>9</Draw>
    <Lost>12</Lost>
    <NumberOfShots>445</NumberOfShots>
    <YellowCards>42</YellowCards>
    <RedCards>0</RedCards>
    <Goals_For>31</Goals_For>
    <Goals_Against>38</Goals_Against>
    <Goal_Difference>-7</Goal_Difference>
    <Points>30</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Newcastle</Team>
    <Team_Id>8</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>8</Won>
    <Draw>6</Draw>
    <Lost>14</Lost>
    <NumberOfShots>544</NumberOfShots>
    <YellowCards>51</YellowCards>
    <RedCards>2</RedCards>
    <Goals_For>38</Goals_For>
    <Goals_Against>49</Goals_Against>
    <Goal_Difference>-11</Goal_Difference>
    <Points>30</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Southampton</Team>
    <Team_Id>41</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>6</Won>
    <Draw>9</Draw>
    <Lost>13</Lost>
    <NumberOfShots>494</NumberOfShots>
    <YellowCards>30</YellowCards>
    <RedCards>0</RedCards>
    <Goals_For>39</Goals_For>
    <Goals_Against>51</Goals_Against>
    <Goal_Difference>-12</Goal_Difference>
    <Points>27</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Wigan</Team>
    <Team_Id>12</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>6</Won>
    <Draw>6</Draw>
    <Lost>16</Lost>
    <NumberOfShots>484</NumberOfShots>
    <YellowCards>45</YellowCards>
    <RedCards>2</RedCards>
    <Goals_For>33</Goals_For>
    <Goals_Against>55</Goals_Against>
    <Goal_Difference>-22</Goal_Difference>
    <Points>24</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Aston Villa</Team>
    <Team_Id>5</Team_Id>
    <Played>27</Played>
    <PlayedAtHome>13</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>5</Won>
    <Draw>9</Draw>
    <Lost>13</Lost>
    <NumberOfShots>414</NumberOfShots>
    <YellowCards>57</YellowCards>
    <RedCards>2</RedCards>
    <Goals_For>26</Goals_For>
    <Goals_Against>52</Goals_Against>
    <Goal_Difference>-26</Goal_Difference>
    <Points>24</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>Reading</Team>
    <Team_Id>39</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>5</Won>
    <Draw>8</Draw>
    <Lost>15</Lost>
    <NumberOfShots>348</NumberOfShots>
    <YellowCards>32</YellowCards>
    <RedCards>1</RedCards>
    <Goals_For>34</Goals_For>
    <Goals_Against>54</Goals_Against>
    <Goal_Difference>-20</Goal_Difference>
    <Points>23</Points>
  </TeamLeagueStanding>
  <TeamLeagueStanding>
    <Team>QPR</Team>
    <Team_Id>10</Team_Id>
    <Played>28</Played>
    <PlayedAtHome>14</PlayedAtHome>
    <PlayedAway>14</PlayedAway>
    <Won>3</Won>
    <Draw>11</Draw>
    <Lost>14</Lost>
    <NumberOfShots>499</NumberOfShots>
    <YellowCards>39</YellowCards>
    <RedCards>2</RedCards>
    <Goals_For>21</Goals_For>
    <Goals_Against>44</Goals_Against>
    <Goal_Difference>-23</Goal_Difference>
    <Points>20</Points>
  </TeamLeagueStanding>
  <AccountInformation>Data requested at 03-03-2013 12:03:55 from XX.XX.XX.XX, Username: Espectro. Your current supscription runs out on XX-XX-XXXX 11:01:25.</AccountInformation>
</XMLSOCCER.COM>								
							

GetAllTeamsByLeagueAndSeason output

GetAllLeagues output

Fixturematches output

Historical Matches output

Bookmakers and Odds

List of bookmakers

  • 10Bet
  • 12Bet
  • 188Bet
  • 5Dimes
  • 888
  • BestBet
  • Bet365
  • Bet-At-Home
  • BetBoo
  • BetClic
  • Betfred
  • BetSafe
  • BetVictor
  • Betway
  • BetWin
  • Blue Square
  • BWin
  • CanBet
  • ComeOn
  • Coral
  • DafaBet
  • Doxxbet
  • Expekt
  • FortunaWin
  • Interwetten
  • Ladbrokes
  • Mybet
  • NordicBet
  • Paddy Power
  • Pinnacle
  • Skybet
  • Sportingbet
  • Tipico
  • Unibet
  • WilliamHill

Type of odds

  • Handicap
  • Over/Under 2.5
  • Double Chance
  • Asian Handicap
  • 1X2

For more information regarding how data is structured in XML, you need to go under the section "Requests and Responses".

Matches (Fixture matches, Livescore & Historical matches)

This article will try to give an overview of the data returned when requesting for football matches.

Two types of match responses

First of all, there are two types of match objects returned by the service.

  • Historicalmatch
  • Fixturematch / Livescore

This is due to how xmlsoccer.com was developed in the first place and how it have evolved since. Fixtures and Livescores follow the same resultset, but you need to use the Livescore method when following the match due to more aggressive caching rules for Fixtures.

Games that haven't been played yet is only available using "GetFixtures..." methods.

Games played earlier than the summer of 2012 is only available using the methods "GetHistoricalMatches..." while games played after the summer of 2012, they are available in both "GetFixtures..." and "GetHistoricalMatches..." methods.

Mapping between Livescore+fixture and Historical matches

A good rule of thumb is to use the GetFixtures while requesting data for future matches, and use GetHistoricalMatches when requesting, well, historical matches. The resultset of GetHistoricalMatches have a "Futurematch_Id" field which is used to map between the "ID" field from GetFixtures. When requesting a match through a "GetHistoricalMatches..."-method, you will get the full dataset.

Fixtures/Livescore

  • ID
  • Datetime
  • Time
  • League
  • (Cup Id)
  • Hometeam
    • ID
    • Name
    • Goals
    • Substitutions (names and times)
    • Goalscorers (names and times)
    • Cards (names and times)
    • Lineups prior match
  • Awayteam
    • ID
    • Name
    • Goals
    • Substitutions (names and times)
    • Goalscorers (names and times)
    • Cards (names and times)
    • Lineups prior match

The following data is available for most leagues that are specified "detailed statistics" on http://www.xmlsoccer.com/WebLeagues.aspx:

Detailed statistics (Added about 1 day after final whistle)

As of April 2015, the detailed statistics are:

  • English Premier League
  • English League Championship
  • English League 1
  • English League 2
  • Scottish Premier League
  • Bundesliga
  • La Liga
  • Serie A
  • Ligue 1

The extra detailed data is as follow:

  • Hometeam
    • Shots
    • Shots on target
    • Corners
    • Fouls
  • AwayTeam
    • Shots
    • Shots on target
    • Corners
    • Fouls

Teams

XMLSoccer holds some basic information regarding each team. They are as follows:

  • Name
  • Team ID (local numerical xmlsoccer.com ID)
  • Country
  • Official Website URL
  • Wikipedia URL
  • Name of stadium

XMLSoccer.com does not, due to copyrights, hold logos for teams. You need to get it elsewhere, and in most (major) leagues, you need the consent from the team to use it on your project.