Developer Documentation

Introduction

Thank you very much for choosing XML Sports Feeds. This manual will help you through the process of integrating the feed. If you need any help regarding integration of the feed phase contact our IT support: technical.support@xml-sportsfeeds.com . If you have any suggestions or input for improving the manual please let our IT support team know.

What's New?

Data Related

Update Date
Added European Championship and Copa America to Competitions List April 13, 2021
Added xml/fixtures, xml/live-score, and xml/post-match to the Legacy Feeds. Feb 11, 2021
Added complete Competitions List November 04, 2020
Added Medical check to probability - Transfer Rumours April 24, 2020
Update Feeds Order (from date_updated to date_created) - Transfers July 02, 2019
Update Feeds Order (from date_updated to date_created) - Transfer Rumours July 02, 2019
Added Feeds Attribute (estimated_amount) - Transfers June 21, 2019
Added Feeds Attribute (estimated_amount) - Transfer Rumours June 21, 2019
Added Feeds - Player/updates May 27, 2019
Added Feeds - Team/updates May 27, 2019
Added Feeds - Competition/updates May 27, 2019
Added Feeds - Player/career May 24, 2019
Added Suspension matches info - Suspensions May 15, 2019
Added Feeds Info - Suspensions May 15, 2019
Added Feeds - Competition/teams November 28, 2018
Added Feeds - Team/stats November 28, 2018
Added Feeds - Player/stats November 28, 2018
Added General Info - Support Mails October 12, 2018
Added General Info - Request Limitations October 12, 2018
Added General Info - Club and Player IDs / Monikers October 12, 2018
Added General Info - Localization October 12, 2018
Added General Info - Request Patterns October 12, 2018
Added General Info - The Feed Key October 12, 2018
Added General Info - Time Zones October 12, 2018
Added General Info - PHP XML Parser October 12, 2018
Added General Info - Introduction October 12, 2018
Added Feeds - Competition/disciplinary-list-team July 11, 2018
Added Feeds - Competition/attendance July 11, 2018
Added Feeds - Competition/assist-list July 11, 2018
Added Feeds - Competition/top-scorer-list July 11, 2018
Added Feeds - Competition/standing July 11, 2018
Added Glossary - live-match-status July 05, 2018
Added Glossary - status July 05, 2018
Added Page - Glossary July 05, 2018
Added Feeds - Line-up June 06, 2018
Added Feeds - Transfer-Rumours May 24, 2018
Added Feeds - Transfers May 24, 2018
Added Feeds - Suspensions May 24, 2018
Added Feeds - Injuries May 24, 2018
Added Feeds - Competition May 10, 2018
Added Feeds - Team May 10, 2018
Added Feeds - Player May 10, 2018
Added Feeds - Post-Match April 26, 2018
Added Feeds - Live Score April 26, 2018
Added Feeds - Fixtures April 26, 2018

PHP XML Parser

The PHP XML Parser - also termed the XSF Downloader - is no longer supported as of February 2013. Existing customers may still employ the PHP XML Parser, but code updates will no longer be released and future products and features will not be supported by the parser. We strongly recommend that existing customers plan a migration to using the XML feeds directly instead. If you need help with this, please contact our IT support: technical.support@xmlsportsfeeds.com

Time Zones

All dates and times are shown in CET/CEST (Rome, Paris, Madrid).

The Feed Key

The feed key is your personal key that you have to insert in every single URL you chose to use.

Competitions List

Below is the list of all competitions we cover, together with their specific unique IDs.

Use these IDs when requesting particular competition data.

Top Competitions

Name Description ID
England 1 Premier League ENG_1
Spain 1 La Liga ESP_1
Italy 1 Serie A ITA_1
Germany 1 1. Bundesliga GER_1
France 1 Ligue 1 FRA_1
Champions League UEFA Champions League INT_3
UEFA Cup 1 UEFA Europa League INT_23
European Championship European Championship INT_43
Copa America Copa America INT_10

Europe

Name Description ID
Austria 1 Tipico Bundesliga AUT_1
Belgium 1 Jupiler League BEL_1
Denmark 1 Superliga DEN_1
England 2 Championship ENG_2
Germany 2 2. Bundesliga GER_2
Ireland 1 Premier Division IRL_1
Italy 2 Serie B ITA_2
Netherlands 1 Eredivisie NED_1
Norway 1 Eliteserien NOR_1
Portugal 1 Primeira Liga POR_1
Russia 1 Premier League RUS_1
Scotland 1 Premiership SCO_1
Spain 2 La Liga 2 ESP_2
Sweden 1 Allsvenskan SWE_1
Switzerland 1 Super League SUI_1
Turkey 1 Super Lig TUR_1

NORTH & CENTRAL AMERICA

Name Description ID
Mexico 1 Primera Division MEX_1
USA 1 Major League Soccer USA_1

SOUTH AMERICA

Name Description ID
Argentina 1 Superliga ARG_1
Brazil 1 Serie A BRA_1

Request Patterns

We recommend that you update every 2 minutes. A timestamp should generally be applied in every request. For bulk import load and start-up-purposes, you may employ a timestamp of 0, which will give you the maximum number of items. The standard numbers of items returned are a maximum of 1000 for Transfers and Transfer Rumours whereas Suspensions and Injuries will provide 250 items or an unlimited number of data pages of 250 items each. The maxlimit-parameter allows you to control the number of items returned, e.g. top 5 most recently updated items.

The timestamp format is the UNIX-timestamp, e.g. 1362130707 corresponding to (03/01/13 @ 3:38:27am EST or 2013-03-01 10:38:27 GMT+1), which can be obtained on most platforms and systems by calling a time-function (e.g. PHP: time(), Java: getTime(), JavaScript: getTime(), .NET:DateTime-structure). You can also get the current timestamp (on the XML Sports Feeds-server) by calling:



http://feed.xmlsportsfeeds.net/xml/get_servertime.php


The recommended pattern for requests, once you have done a bulk import, is as outlined below:


  • Recall timestamp, Tlast of last update
  • Send request to all relevant feeds with timestamp, Tlast
  • Get current time, Tnow - the time of your updates.
  • Set Tlast to Tnow.
  • Wait 2 minutes (or other selected interval) and repeat from 1.

The advantage with this approach is that you get only the delta of items, i.e. only xml-items that are new since the last request.

Localization

The XML feeds support localization in the manner of currency with automated conversion (valid only for Transfers and Transfer Rumours), language (valid for Transfers, Transfer Rumours, Injuries and Suspensions) and filtering of data per country.

You can get the current conversion rates used by the XML feeds by calling:

http://feeds.xmlsportsfeeds.net/xml/exchange-rates/


Parameter currency (default is EUR) may be any of the following: AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, EEK, EUR, GBP, HKD, HRK, HUF, IDR, INR, JPY, KRW, LTL, LVL, MXN, MYR, NOK, NZD, PHP, PLN, RON, RUB, SEK, SGD, THB, TRY, USD, ZAR


Parameter language (default is English/en - use the brief of denominator when requesting, i.e. en or da) may be any of the following:

  • - Danish/da
  • - Swedish/swe
  • - Norwegian/no
  • - German/ge
  • - Polish/po


In the near future, the following languages will be supported as well: French/fre, Dutch/du, Spanish/spa, Russian/ru, Italian/ita or Portuguese/por.


Parameter country(default is all - use the 3-letter denominator when requesting) will limit the feed to only data items concerning the specific country: ENG, DEN, GER, POL, SWE, NOR, ESP, POR, ITA, RUS, BEL, FRA, GRE, TUR, FIN, SCO, USA, BRA, ARG, NED - and more!


Localization example - requesting the Transfer Rumour-feed in Danish with currency DKK:


http://feeds.xmlsportsfeeds.net/xml/all/transferrumours/?key=¤cy=dkklanguage=da



Club and Player IDs / Monikers

The club-id or club-moniker is generally constructed by using the short English name of the club, replacing any blanks with a hyphen, and removing any leading or trailing FC, AC, City, etc. The parameters are case-insensitive but we recommend using capital letters to represent the monikers. Examples of monikers inclube:


BAYERN-MUNICH, BARCELONA, REAL-MADRID, NORWICH, TOTTENHAM, TORINO, REIMS


There are exceptions, however, such as:


MANCHESTER-CITY, FC-COPENHAGEN, AC-MILAN, BROENDBY-IF


To extract a complete list of club-monikers (primary competition clubs only) please use:


http://feeds.xmlsportsfeeds.net/xml/get_clubs.php


The player-id or player-moniker is constructed in the same manner: replace blanks with hyphens, convert localized letters to international ones, and remove initials or middle names. Players from South America will generally be known by their short name - with exceptions. Examples of monikers:


CLAUDEMIR, JESPER-CHRISTIANSEN, RIO-FERDINAND, LIONEL-MESSI

Request Limitations

Please note that number of accepted request is limited only to 50 different requests within a 5 minute range. This is a precaution set to avoid request flooding that is harmful for the repository.

Also no same request can be sent several times within a 5 minutes interval.


Example: Client 1 sends several request for injuries (1x for Norway, 1x for England, 1x for Denmark) This is allowable and will be accepted. Even though they belong to under Injury feeds they are still considered as different request. But, if in the 5 minute range client 1 sends another injury request for Denmark, then that time the request will be prevented and considered as redundant request.

Support Mails

If you have any comments or suggestions regarding our data or manual,
please feel free to contact us on the following support mails:

technical.support@xmlsportsfeeds.com - For Manual/tech/feed related issues/questions.

content.support@xmlsportsfeeds.com - For content related issues/questions.

GET /xml/fixtures

Contains the list of matches and result with the kickoff and match details.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/fixtures

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
competition_id No string   ENG_1
season_id No string current season 2017/2018
stage_id No string   MAIN
match_id No integer   1234567
match_name No string   Arsenal-Leicester
team_id No string   ARSENAL
home_team_id No string   ARSENAL
away_team_id No string   LEICESTER
match_date No YYYY-MM-DD date today 2017-08-11
match_status No string   finished
result No home score-away score 3-0
stadium_id No string   Emirates-Stadium
referee_id No string Mike-Dean
round No string   1
page No integer 1 3
country_id No string   ENG
last_update No timestamp 1234567890

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/fixtures?key=YOUR-KEY-HERE&competition_id=ENG_1

Example Response

GET /xml/live-score

Contains the detail of ongoing match such as scores, events and statistics.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/live-score

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
competition_id No string   ENG_1
season_id No string current season 2017/2018
stage_id No string   MAIN
round No string   1
match_id No integer   1234567
match_name No string   Arsenal-Leicester
match_status No string   finished
home_team_id No string   ARSENAL
away_team_id No string   LEICESTER
stadium_id No string Emirates-Stadium
referee_id No string   Mike-Dean
team_id No string ARSENAL
country_id No string   ENG

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/live-score?key=YOUR-KEY-HERE

Example Response

Reveal All

GET /xml/post-match

Contains the details happened during the match such as scores, events and statistics.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/post-match

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
competition_id No string   Hj3%3sI
season_id No string current season 2017/2018
stage_id No string   MAIN
round No string   1
match_id No integer   1234567
match_name No string   Arsenal-Leicester
match_date No YYYY-MM-DD date today 2017-08-11
home_team_id No string   ARSENAL
away_team_id No string   LEICESTER
stadium_id No string   Emirates-Stadium
referee_id No string Mike-Dean
team_id No string   ARSENAL
page No integer 1 3
country_id No string   ENG
last_update No timestamp 1234567890

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/post-match?key=YOUR-KEY-HERE

Example Response

Reveal All

GET /xml/player

Contains the general information about the player such as birth date, position, shirt number, country and current team and player stats.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/player

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
player_id Yes string ROMELU-LUKAKU
season_id No year current season 2017/2018
team_id No string MANCHESTER-UNITED

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/player/ROMELU-LUKAKU?key=YOUR-KEY-HERE

Example Response

Reveal All

GET /xml/player/player_id/stats

Contains the stats of the requested player.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/player/player_id/stats

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
season_id No string current season 2018/2019

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/player/ROMELU-LUKAKU/stats?key=YOUR-KEY-HERE

Example Response

Reveal All

GET /xml/player/player_id/career

Contains the career of the requested player.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/player/player_id/career

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
season_id No string current season 2018/2019

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/player/CRISTIANO-RONALDO/career?key=YOUR-KEY-HERE

Example Response

Reveal All

GET /xml/player/updates

Contains the latest update of the player.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/player/updates

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
last_update No string current date 2018-01-01

Response Information

Attribute Values Definition
type profile = profile update
career = career update
The type of updates. typically if the value is profile. the update will be on profile data. the base endpoint.
player_id n/a The id of the player.
player_name n/a The name of the player

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/player/updates?key=YOUR-KEY-HERE

Example Response

Reveal All

GET /xml/team

Contains the information about the team such as country, website, stadium, team average and squad list etc.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/team

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
team No string   ARSENAL
season_id No string current season 2017/2018
competition_id No string   ENG_1

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/team/ARSENAL?key=YOUR-KEY-HERE

Example Response

Reveal All

GET /xml/team/team_id/stats

Contains the stats of the requested team.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/team/team_id/stats

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
season_id No string current season 2018/2019

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/team/ARSENAL/stats?key=YOUR-KEY-HERE

Example Response

GET /xml/player/updates

Contains the latest update of the requested player.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/player/updates

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
last_update No string current date 2018-01-01

Response Information

Attribute Definition
type The type of updates. typically if the value is profile. the update will be on profile data. the base endpoint.
team_id The id of the team.
team_name The name of the team

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/team/updates?key=YOUR-KEY-HERE

Example Response

Reveal All

GET /xml/competition

Contains the information about the competition such as competition structure, standings, top scorer, assist, attendance list of participating teams.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/competition

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
competition_id No string   ENG_1
season_id No string current season 2017/2018

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/competition/ENG_1?key=YOUR-KEY-HERE

Example Response

Reveal All

GET /xml/competition/competition_id/teams

Contains the participating team of the requested league/competition.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/competition/competition_id/teams

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
season_id No string current season 2018/2019

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/competition/ENG_1/teams?key=YOUR-KEY-HERE

Example Response

GET /xml/competition/competition_id/standing

Contains the standing of the participating teams from the given competition.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/competition/competition_id/standing

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
season_id No string current season 2017/2018
home_away No integer
Options:
1 = Home
2 = Away
3 = Overall
3 = Overall 3

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/competition/ENG_1/standing?key=YOUR-KEY-HERE

Example Response

Reveal All

GET /xml/competition/competition_id/top-scorer-list

Contains the ranking of top scoring players on the given competition id.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/competition/competition_id/top-scorer-list

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
season_id No string current season 2017/2018

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/competition/ENG_1/top-scorer-list?key=YOUR-KEY-HERE&season-id=2017/2018

Example Response

Reveal All

GET /xml/competition/competition_id/assist-list

Contains the ranking of top assisting players on the given competition id.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/competition/competition_id/assist-list

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
season_id No string current season 2017/2018

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/competition/ENG_1/assist-list?key=YOUR-KEY-HERE&season-id=2017/2018

Example Response

Reveal All

GET /xml/competition/competition_id/attendance

Contains the ranking of most spectated teams on the given competition

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/competition/competition_id/attendance

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
season_id No string current season 2017/2018

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/competition/ENG_1/disciplinary-list-team?key=YOUR-KEY-HERE&season-id=2017/2018

Example Response

Reveal All

GET /xml/competition/updates

Contains the latest update of the requested competition.

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/competition/updates

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
last_update No string current date 2018-01-01

Response Information

Attribute Definition
type The type of updates. typically if the value is profile. the update will be on profile data. the base endpoint.
competition_id The id of the competition.
competition_name The name of the competition

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/competition/updates?key=YOUR-KEY-HERE

Example Response

Reveal All

GET /xml/competition/competition_id/disciplinary-list-team

Contains the ranking of teams that has the most disciplinary cards on the given competition id

Domain URL

https://football.xmlsportsfeeds.net/v2

End point

/xml/competition/competition_id/disciplinary-list-team

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Required Accepted Values Default Value Example
key Yes string   Hj3%3sI
season_id No string current season 2017/2018

Example Request

GET https://football.xmlsportsfeeds.net/v2/xml/competition/ENG_1/disciplinary-list-team?key=YOUR-KEY-HERE&season-id=2017/2018

Example Response

Reveal All

GET /xml/injuries

The injury score feed contains all injuries that are live and historical injuries.

Domain URL

http://feeds.xmlsportsfeeds.net/xml/all/injuries/?key=YOUR-KEY-HERE

End point

/xml/injuries

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters


Name Description Default Value Required
key your personal feed key   Yes
competition Unique id of the competition. e.g DEN_1, ENG_1 all No
status 3 options:
live = all injuries that are live,
historical = all injuries that are historical,
all = all live and historical injuries
all No
language select the preferred language en No
timestamp request only updates after a specific time of the day (timestamp) - No
country Only injuries from competitions in the specific country all No
player Only injuries for specific player. Parameter must be a string and a valid player-moniker. Use hyphen instead of blanks in player name all No
club Only injuries for specific club. Parameter must be a string and a valid club-moniker. Use hyphen instead of blanks in club name. all No
maxlimit Maximum number of items. Must be an integer between 1 and 1500. 250 No
del Options:
yes = all deleted injury data
no = all existing injury data
all = all deleted and existing injury data
no No

Example Request

GET http://feeds.xmlsportsfeeds.net/xml/all/injuries/?key=YOUR-KEY-HERE

Example Response

Reveal All

GET /xml/suspensions

The suspension feed contains all suspensions that are live and historical.

Domain URL

http://feeds.xmlsportsfeeds.net/xml/all/suspensions/?key=YOUR-KEY-HERE

End point

/xml/suspensions

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters


Name Description Default Value Required
key your personal feed key - Yes
status 3 options:
live = all suspensions that are live,
historical = all suspensions that are historical,
all = all live and historical suspensions
all No
language select the preferred language en No
timestamp request only updates after a specific time of the day (timestamp) - No
country Only suspensions from competitions in the specific country. all No
player Only suspensions for a specific player. Parameter must be a string and a valid player-moniker. Use hyphen instead of blanks in player name. all No
club Only suspensions for a specific club. Parameter must be a string and a valid club-moniker. Use hyphen instead of blanks in club name. all No
maxlimit Maximum number of items. Must be an integer between 1 and 1500. 250 No
del Options:
yes = all deleted injury data
no = all existing injury data
all = all deleted and existing injury data
no No
comp Filter by competition ID all No

Example Request

GET http://feeds.xmlsportsfeeds.net/xml/all/suspensions/?key=YOUR-KEY-HERE

NOTE

If there is no matches yet attached on the Matches element.
The Match element will only contain status attribute with a value of "pending".
Example: <Match status="pending"/>

Example Response

Reveal All

GET /xml/transfers

The transfer feed contains all transfers that are live and historical.

Domain URL

http://feeds.xmlsportsfeeds.net/xml/all/transfers/?key=YOUR-KEY-HERE

End point

/xml/transfers

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Description Default Value Required
key your personal feed key - Yes
language select the preferred language en No
currency select the preferred currency EUR No
timestamp request only updates after a specific time of the day (timestamp) - No
country Only transfers from competitions in the specific country; i.e. transfers to and from. all No
player Only transfers for a specific player. Parameter must be a string and a valid player-moniker. Use hyphen instead of blanks in player name. all No
club Only transfers for a specific club. Parameter must be a string and a valid club-moniker. Use hyphen instead of blanks in club name. all No
maxlimit Maximum number of items. Must be an integer between 1 and 1500. 1000 No
del Options:
yes = all deleted injury data
no = all existing injury data
all = all deleted and existing injury data
no No

Example Request

GET http://feeds.xmlsportsfeeds.net/xml/all/transfers/?key=YOUR-KEY-HERE

Response Information

Attribute Definition
player_id Player id moniker of the player
player_name Name of the player
player_country_id Country code of player
sport_id Sport id
amount Amount of the transfer
currency Currency of the amount
type Type of transfer
date_from Contract from
date_to Contract until
club_from_id Club from id moniker of the player
club_from_name Club from name of the player
club_to_id Club to name of the player
club_to_name Club to name of the player
last_update Last updated date of the transfer
competition_id_from Competition of the club from
competition_id_to Competition of the club to
timestamp Timestamp of the transfer
date_created DateTime created of the transfer
deleted Transfer if deleted
estimated_amount new if the amount is estimated or official

Example Response

GET /xml/transfer-rumours

The transfer rumour feed contains all transfer rumours that are live and historical.

Domain URL

http://feeds.xmlsportsfeeds.net/xml/all/transferrumours/?key=YOUR-KEY-HERE

End point

/xml/transfer-rumours

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Description Default Value Required
key your personal feed key - Yes
language select the preferred language en No
currency select the preferred currency EUR No
timestamp request only updates after a specific time of the day (timestamp) - No
country Only transfer rumours from competitions in the specific country; i.e. transfer rumours to and from. all No
player Only transfer rumours for a specific player. Parameter must be a string and a valid player-moniker. Use hyphen instead of blanks in player name. all No
club Only transfer rumours for a specific club. Parameter must be a string and a valid club-moniker. Use hyphen instead of blanks in club name. all No
maxlimit Maximum number of items. Must be an integer between 1 and 1500. 1000 No
del Options:
yes = all deleted injury data
no = all existing injury data
all = all deleted and existing injury data
no No

Example Request

GET http://feeds.xmlsportsfeeds.net/xml/all/transferrumours/?key=YOUR-KEY-HERE

Response Information

Attribute Definition
player_id Player id moniker of the player
player_name Name of the player
player_country_id Country code of player
sport_id Sport id
amount Amount of the rumor
currency Currency of the amount
probability Rumor probabilty (High, Medium, Low, Medical checknew)
type Type of rumor
club_from_id Club from id moniker of the player
club_from_name Club from name of the player
club_to_id Club to name of the player
club_to_name Club to name of the player
last_update Last updated date of the transfer
competition_id_from Competition of the club from
competition_id_to Competition of the club to
timestamp Timestamp of the transfer
date_created DateTime created of the transfer
deleted Transfer if deleted
source_name Source name of the rumor
source_url Actual Source url of the rumor
estimated_amount new if the amount is estimated or official

Example Response

GET /xml/line-up

The lineup feed contains all lineups, expected and official.

Domain URL

http://feeds.xmlsportsfeeds.net/xml/get_lineups.php?key=YOUR-KEY-HERE&language=en×tamp=0

End point

/xml/line-up

Resource Information

Response formats Yes
Requires authentication? Yes
Rate limited?

Parameters

Name Description Default Value Required
key your personal feed key   Yes
type Get the type of lineup to download
(expected_lineup, official_lineup)
all No
country Only lineups from competitions in the specific country all No
match Specific match lineups all No
maxlimit Maximum number of items. Must be an integer between 1 and 1500. 5 No
comp Lineups on a specific competition all No
timestamp Select matches from the timestamp issued 0 No

Example Request

GET http://feeds.xmlsportsfeeds.net/xml/all/lineups/?key=YOUR-KEY-HERE&language=en×tamp=0

Example Response

Reveal All

status

notstarted
inprogress
finished

live_match_status

upcoming (60 min before kick off)
1st_half (0-45+)
halftime
2nd_half (45-90+)
fulltime
extra_time (90-120+)
fulltime_after_extra_time
penalties
fulltime_after_penalties

home_away

1 (Home)
2 (Away)
3 (Overall)