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
Have more questions? Submit a request

1 Comments

  • 0
    Avatar
    Michal Janoušek

    Hi, from article above it is unclear, what are detailed statistics. I guess there should be list of them instead of list of leagues. Thanks for your job. Michal

Please sign in to leave a comment.
Powered by Zendesk