Statorium Sports API documentation
Statorium API documentation provides you with all necessary information required to work with the API, with details about the functions, classes, return types, supported by comments and examples.
Identification
To get access to API data available in Statorium service you need to use API token. Please contact our support team to receive API token for required League data.
Getting started
How to Start
As soon as you purchase access to chosen League and receive API token from our team you can make requests to Statorium API. An API Token is a credential that is used by an application to access an API.
So to authorize a request to our API, please add provided by us parameter to your request.
An example of a request: https://api.statorium.com/api/v1/leagues/?apikey=123_test_token_123
Please pay your attention that specified apikey is an example. When you create your API request please use the apikey that you received once API subscription purchased.
HTTP Request format
Generally HTTP request composed of several parts: https://api.statorium.com/api/v1/ is the main part of the request link.
Then there should be the name of the entity in the plural e.g (leagues, matches, players, teams etc).
Then there should be the ID of the element (is not always used).
Then there should be question mark and parameters.
Parameters can be required (like apikey) and optional.
Required parameter has to be used in each HTTP request.
Example of HTTP Request: https://api.statorium.com/api/v1/teams/8/?season_id=1&apikey=123_test_token_123
Here season_id - is optional parameter.
Example of HTTP Request: https://api.statorium.com/api/v1/rounds/?season_id=1&apikey=123_test_token_123
Here season_id - is required parameter, as Round list can be presented of some Season only.
Data sheet
Below you will find definitions and statuses used in Statorium API
| Name | Description |
|---|---|
| gmtUpdated | The time point, when data (JSON response) formed on Server (seconds after Unix time January 1,1970) |
| null | Undefined value |
| false | No value |
| status ID 0 | Fixture (a match arranged to take place on a particular date) |
| status ID 1 | Played match |
| status ID -1 | Live match |
| status ID 2 | Postponed match |
| status ID 3 | Cancelled match |
| matchdayType 0 | Round Robin competition |
| matchdayPlayoff 0 | Ordinary Round |
| matchdayPlayoff 1 | Playoff Round |
| Penalty Shootout | Score mentioned in this attribute signifies score on penalties |
Statorium API offers the following set of Player event stats:
Football:
| ID | Event name |
|---|---|
| 1 | Goal (from field) |
| 2 | Assist |
| 3 | Own goal |
| 4 | Penalty goal |
| 5 | Yellow card |
| 6 | Second yellow |
| 7 | Red card |
| 8 | Missed penalty |
| 13 | Goals (Goals = penalty goal + goal (from field)) |
| 20 | Penalty shootout missed |
| 21 | Penalty shootout scored |
Basketball:
| ID | Event name |
|---|---|
| 23 | 1 point |
| 24 | 2 points |
| 25 | 3 points |
Match (team level) events:
Football:
| ID | Event name |
|---|---|
| 9 | Total shots |
| 10 | Fouls |
| 11 | Possession |
| 12 | Corners |
| 14 | Offsides |
| 15 | Shots off target |
| 16 | Shots on target |
Basketball:
| ID | Event name |
|---|---|
| 26 | Rebounds |
| 27 | Assists |
| 28 | Fouls |
Endpoints
Leagues
A request on Leagues endpoint returns all Leagues list you have permission to.
The Leagues Endpoint includes such information as ID, Name.
Get all Leagues available for your subscription.
Example of HTTP Request: https://api.statorium.com/api/v1/leagues/?apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| id | The id of the League (integer) |
| name | The name of the League (string) |
Example of Response: hide code
{
"gmtUpdated": 1565781894,
"leagues": [
{
"id": "3",
"name": "Bundesliga (Germany)"
},
{
"id": "2",
"name": "La Liga (Spain)"
},
{
"id": "4",
"name": "Ligue 1 (France)"
},
{
"id": "1",
"name": "Premier League (England)"
},
{
"id": "5",
"name": "Serie A (Italy)"
},
{
"id": "6",
"name": "UEFA Champions League (Europe)"
},
{
"id": "7",
"name": "UEFA Europa League (Europe)"
}
]
}
Get League by ID
Example of HTTP Request: https://api.statorium.com/api/v1/leagues/1/?apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| id | The id of the League (integer) |
| name | The name of the League (string) |
| logo | Path to the logo file |
| seasonID | The id of the Season |
| seasonName | The name of the Season |
Example of Response: hide code
{
"gmtUpdated": 1565781819,
"league": {
"id": "1",
"name": "Premier League (England)",
"logo": "http://api.statorium.com/media/bearleague/bl15562691252122.png",
"seasons": [
{
"seasonID": "1",
"seasonName": "2018/2019"
},
{
"seasonID": "24",
"seasonName": "2019/2020"
}
]
}
}
Seasons
A request on Season endpoint returns all information about the Season which id is used in request: Name, Groups, Participants and Standings legend.
Example of HTTP Request: https://api.statorium.com/api/v1/seasons/1/?apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| seasonID | The id of the Season (integer) |
| leagueID | The id of the League (integer) |
| seasonName | The name of the Season (string) |
| fullName | Season full name |
| stages | The information about the Stages in the Season (Competition phases, e.g Champions League includes Classification, then PlayOff, then Group stage etc ) |
| groups | The information about the Groups in the Season |
| particiopantID | The id of the Participant in the database assigned to this Season (integer) |
| legends | The information about the Standings legend |
| place | The place number |
| color | The color code to highlight chosen Places (Hex Code) |
| s_legend | The Standings legend name |
| points | The information about the number of points for win, draw, lost |
| rankingOptions | The information about the method of ranking teams with an equal number of points |
| periods | The information about the Game Stages in the Season (First half, second half, extra time, penalty shootout and etc.) |
Example of Response: hide code
{
"gmtUpdated": 1730481331,
"season": {
"seasonID": 1,
"leagueID": "1",
"seasonName": "2018-19",
"fullName": "ENGLAND: Premier League 2018-19",
"stages": false,
"groups": [],
"participants": [
{
"participantID": "1"
},
{
"participantID": "2"
},
{
"participantID": "3"
},
{
"participantID": "4"
},
{
"participantID": "5"
},
{
"participantID": "6"
},
{
"participantID": "7"
},
{
"participantID": "8"
},
{
"participantID": "9"
},
{
"participantID": "10"
},
{
"participantID": "11"
},
{
"participantID": "12"
},
{
"participantID": "13"
},
{
"participantID": "14"
},
{
"participantID": "15"
},
{
"participantID": "16"
},
{
"participantID": "17"
},
{
"participantID": "18"
},
{
"participantID": "19"
},
{
"participantID": "20"
}
],
"legends": [
{
"place": "5",
"color": "#0000CC",
"s_legend": "Europa League group stage"
},
{
"place": "18-20",
"color": "#FF0000",
"s_legend": "Relegation to EFL Championship"
},
{
"place": "1-4",
"color": "#003300",
"s_legend": "Champions League group stage"
}
],
"points": {
"homeWin": "3.00",
"homeLost": "0.00",
"homeDraw": "1.00",
"isExtra": "0",
"extraWin": "0.00",
"extraLost": "0.00",
"awayWin": "3.00",
"awayDraw": "1.00",
"awayLost": "0.00"
},
"rankingOptions": {
"equalPts": "0",
"spanish": "0"
},
"periods": []
}
}
Standings
A request on Standings endpoint returns Season table with all the available team level stats. Stats are provided inside the "options" attribute.
Example of HTTP Request: https://api.statorium.com/api/v1/standings/1?apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| seasonID | The id of the Season (integer) |
| leagueID | The id of the League (integer) |
| seasonName | The name of the Season (string) |
| fullName | Season full name |
| stages | The information about the Stages in the Season (Competition phases, e.g Champions League includes Classification, then PlayOff, then Group stage etc ) |
| groups | The information about the Groups in the Season |
| standings | The information about the Standings teams |
| teamID | The id of the Team (integer) |
| teamName | The name of the Team (string) |
| options | The information about: Played matches. Win home, Win away, Draw home, Draw away, Lost home, Lost away, Points won home, Points won away, Points draw home, Points draw away, Points lost home, Points lost away, Home bonus points. Away bonus points, Goals scores, Goals conceeded, Team ID, Win, Draw, Lost, Goals Differential (two numbers), Goal difference (one number), Points, Bonus points, Win Percent, Points gained home. Points gained away, Additional time won, Additional time lost. |
| ordering | The information about ordering team place (integer) |
| teamShortName | The short name of the Team (string) |
| teamMiddleName | The middle name of the Team (string) |
| logo | Team logo (250x250px, transparent PNG) |
| color | Color code (Hex Code) to highlight the current place in table |
| translations | Translations available for team name (Premium package) |
Example of Response: hide code
{
"gmtUpdated": 1606226266,
"season": {
"seasonID": 1,
"leagueID": "1",
"seasonName": "2018-19",
"fullName": "ENGLAND: Premier League 2018-19",
"stages": false,
"groups": [],
"standings": [
{
"teamID": "4",
"teamName": "Manchester City",
"options": "{\"played_chk\":\"38\",\"winhome_chk\":\"18\",\"winaway_chk\":\"14\",\"drawhome_chk\":\"0\",\"drawaway_chk\":\"2\",\"losthome_chk\":\"1\",\"lostaway_chk\":\"3\",\"home_win_pts\":\"18\",\"away_win_pts\":\"14\",\"home_draw_pts\":\"0\",\"away_draw_pts\":\"2\",\"home_loose_pts\":\"1\",\"away_loose_pts\":\"3\",\"home_bonus\":\"0.00\",\"away_bonus\":\"0.00\",\"goalscore_chk\":\"95\",\"goalconc_chk\":\"23\",\"home_points\":\"0.00\",\"away_points\":\"0.00\",\"id\":\"4\",\"win_chk\":32,\"draw_chk\":2,\"lost_chk\":4,\"diff_chk\":\"95 - 23\",\"gd_chk\":72,\"point_chk\":98,\"bonuspts_chk\":0,\"percent_chk\":\"0.868\",\"pointshome_chk\":54,\"pointsaway_chk\":44,\"otwin_chk\":0,\"otlost_chk\":0}",
"ordering": "1",
"teamShortName": "MCI",
"teamMiddleName": "Man City",
"logo": "https://api.statorium.com/media/bearleague/bl15524863261959.png",
"color": "#003300",
"translations": {
"ar": {
"name": "مانشستر سيتي"
},
"zh": {
"name": "曼城",
"middle_name": "曼城"
},
"gr": {
"name": "Μάντσεστερ Σίτι",
"middle_name": "Μάντσεστερ Σίτι"
}
}
},
{
"teamID": "20",
"teamName": "Huddersfield Town AFC",
"options": "{\"played_chk\":\"38\",\"winhome_chk\":\"2\",\"winaway_chk\":\"1\",\"drawhome_chk\":\"3\",\"drawaway_chk\":\"4\",\"losthome_chk\":\"14\",\"lostaway_chk\":\"14\",\"home_win_pts\":\"2\",\"away_win_pts\":\"1\",\"home_draw_pts\":\"3\",\"away_draw_pts\":\"4\",\"home_loose_pts\":\"14\",\"away_loose_pts\":\"14\",\"home_bonus\":\"0.00\",\"away_bonus\":\"0.00\",\"goalscore_chk\":\"22\",\"goalconc_chk\":\"76\",\"home_points\":\"0.00\",\"away_points\":\"0.00\",\"id\":\"20\",\"win_chk\":3,\"draw_chk\":7,\"lost_chk\":28,\"diff_chk\":\"22 - 76\",\"gd_chk\":-54,\"point_chk\":16,\"bonuspts_chk\":0,\"percent_chk\":\"0.171\",\"pointshome_chk\":9,\"pointsaway_chk\":7,\"otwin_chk\":0,\"otlost_chk\":0}",
"ordering": "20",
"teamShortName": "HUD",
"teamMiddleName": "Huddersfield Town",
"logo": "https://api.statorium.com/media/bearleague/bl15524863261959.png",
"color": "#FF0000",
"translations": {
"ar": {
"name": "هدرسفيلد تاون"
},
"gr": {
"name": "Χάντερσφιλντ Τάουν"
}
}
}
]
}
}
Rounds
A request on Rounds endpoint returns all information about the Rounds of the Season which id is used in request: Name, Date, Type of Matchday, details of matches.
Example of HTTP Request: https://api.statorium.com/api/v1/rounds/?season_id=1&apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| seasonID | The id of the Season (integer) |
| matchdays | An object containing details about Rounds |
| matchdayID | The id of the Matchday (integer) |
| matchdayName | The name of the Matchday (string) |
| matchdayPlayoff | Entry if Matchday is playoff or not |
| matchdayType | Type of Matchday Check Data sheet for details |
| matchdayStart | The information about the Start of Matchday |
| matchdayEnd | The information about the End of Matchday |
Example of Response: hide code
{
"gmtUpdated": 1567089928,
"season": {
"seasonID": "1"
},
"matchdays": [
{
"matchdayID": "1",
"matchdayName": "MatchDay 1",
"matchdayPlayoff": "0",
"matchdayType": "0",
"matchdayStart": null,
"matchdayEnd": null
},
{
"matchdayID": "2",
"matchdayName": "MatchDay 2",
"matchdayPlayoff": "0",
"matchdayType": "0",
"matchdayStart": null,
"matchdayEnd": null
}
]
}
Get Round by ID
Example of HTTP Request: https://api.statorium.com/api/v1/rounds/1/?apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| seasonID | The id of the Season in the database (Integer) |
| matchdays | an object containing details about Rounds |
| matchdayID | The id of the Matchday (Integer) |
| matchdayName | The name of the Matchday (string) |
| matchdayPlayoff | Entry if Matchday is playoff or not |
| matchdayType | Type of Matchday (link to Data sheet) |
| matchdayStart | The information about the Start of Matchday (format yyyy-mm-dd) |
| matchdayEnd | The information about the End of Matchday (format yyyy-mm-dd) |
| matches | An object containing match details |
| matchID | The id of the Match (Integer) |
| matchStatus | an object containing details about Match status |
| statusID | Match status id |
| matchDate | an object containing details about Date of the Match |
| matchTime | an object containing details about Time of the Match |
| participantID | The id of the Participant in the database assigned to this Season (Integer) |
| matchVenue | an object containing details about Venue of the Match |
| venueID | The id of the Venue (Integer) |
| homeParticipant | an object containing details about Home participant of the Match |
| awayParticipant | an object containing details about Away participant of the Match |
| participantID | The id of the Participant (Integer) |
| score | an object containing details about Team score |
| participantName | an object containing the name of the participant actually |
| translations | Translations available for team name (Premium package) |
Example of Response: hide code
{
"gmtUpdated": 1567090410,
"matchdays": {
"matchdayID": "1",
"matchdayName": "MatchDay 1",
"matchdayPlayoff": "0",
"matchdayType": "0",
"matchdayStart": null,
"matchdayEnd": null,
"matches": [
{
"matchID": "1",
"matchStatus": {
"statusID": "1"
},
"matchDate": "2018-08-10",
"matchTime": "19:00",
"matchVenue": {
"venueID": "12"
},
"homeParticipant": {
"participantID": "7",
"score": "2",
"participantName": "Manchester United",
"translations": null
},
"awayParticipant": {
"participantID": "14",
"score": "1",
"participantName": "Leicester City",
"translations": null
}
},
{
"matchID": "2",
"matchStatus": {
"statusID": "1"
},
"matchDate": "2018-08-11",
"matchTime": "11:30",
"matchVenue": {
"venueID": "17"
},
"homeParticipant": {
"participantID": "10",
"score": "1",
"participantName": "Newcastle United FC",
"translations": null
},
"awayParticipant": {
"participantID": "2",
"score": "2",
"participantName": "Tottenham Hotspur FC",
"translations": null
}
},
{
"matchID": "3",
"matchStatus": {
"statusID": "1"
},
"matchDate": "2018-08-11",
"matchTime": "14:00",
"matchVenue": {
"venueID": "2"
},
"homeParticipant": {
"participantID": "16",
"score": "2",
"participantName": "AFC Bournemouth",
"translations": null
},
"awayParticipant": {
"participantID": "18",
"score": "0",
"participantName": "Cardiff City FC",
"translations": null
}
}
]
},
"season": {
"seasonID": "1"
}
}
Matches
A request on Matches endpoint returns all Matches information grouped by Rounds of the Season which id is used in request:
Example of HTTP Request: https://api.statorium.com/api/v1/matches/?season_id=1&apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| calendar | An object containing details about Matches |
| leagueID | The id of the League (integer) |
| seasonID | The id of the Season (integer) |
| seasonName | The name of the Season (string) |
| fullName | The full name of the Season (string) |
| stages | The information about the Stages in the Season (Competition phases, e.g Champions League includes Classification, then PlayOff, then Group stage etc ) |
| matchdays | An object containing details about Rounds |
| matchdayID | The id of the Matchday (integer) |
| matchdayName | The name of the Matchday (string) |
| matchdayPlayoff | Entry if Matchday is playoff or not |
| matchdayType | The information about the Stages in the Season (link to data sheet) |
| matchdayStart | The information about the Start of Matchday (format yyyy-mm-dd) |
| matchdayEnd | The information about the End of Matchday (format yyyy-mm-dd) |
| matches | An object containing Match details |
| matchID | The id of the Match in the database (integer) |
| matchStatus | An object containing details about Match status |
| statusID | The id of match status (integer) (link to Data sheet) |
| is Extra | The Entry if match contains Extra time/Overtime or not |
| home_score | an object containing details about Home score |
| away_score | an object containing details about Away score |
| matchDate | Date of the Match (format yyyy-mm-dd) |
| matchTime | Time of the Match (24h format) |
| matchVenue | An object containing details about Venue of the Match |
| venueID | The id of the Venue (integer) |
| homeParticipant | An object containing details about Home team of the Match |
| awayParticipant | An object containing details about Away team of the Match |
| participantID | The id of the Participant (integer) |
| score | An object containing details about Team score |
| stage | an object containing details about stage |
| stageID | The id of the Stage in the database (Integer) |
| stageName | The name of the Stage (string) including Penalty Shootout |
Example of Response: hide code
{
"gmtUpdated": 1567164111,
"calendar": {
"seasonID": 1,
"leagueID": "1",
"seasonName": "2018/2019",
"fullName": "Premier League (England) 2018/2019",
"stages": false,
"matchdays": [
{
"matchdayID": "1",
"matchdayName": "MatchDay 1",
"matchdayPlayoff": "0",
"matchdayType": "0",
"matchdayStart": null,
"matchdayEnd": null,
"matches": [
{
"matchID": "1",
"matchStatus": {
"statusID": "1"
},
"matchDate": "2018-08-10",
"matchTime": "19:00",
"matchVenue": {
"venueID": "12"
},
"homeParticipant": {
"participantID": "7",
"score": "2"
},
"awayParticipant": {
"participantID": "14",
"score": "1"
}
},
{
"matchID": "2",
"matchStatus": {
"statusID": "1"
},
"matchDate": "2018-08-11",
"matchTime": "11:30",
"matchVenue": {
"venueID": "17"
},
"homeParticipant": {
"participantID": "10",
"score": "1"
},
"awayParticipant": {
"participantID": "2",
"score": "2"
}
},
{
"matchID": "3",
"matchStatus": {
"statusID": "1"
},
"matchDate": "2018-08-11",
"matchTime": "14:00",
"matchVenue": {
"venueID": "2"
},
"homeParticipant": {
"participantID": "16",
"score": "2"
},
"awayParticipant": {
"participantID": "18",
"score": "0"
}
}
]
}
]
}
}
Get Match by ID
Example of HTTP Request: https://api.statorium.com/api/v1/matches/{matchID}/?apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| match | an object containing details about the Match |
| matchID | The id of the Match in the database (Integer) |
| matchdayID | The id of the Matchday in the database (Integer) |
| matchStatus | an object containing details about Match status (link to Data sheet) |
| statusID | The id of match status (integer) (link to Data sheet) |
| is Extra | The Entry if match contains Extra time/Overtime or not |
| home_score | an object containing details about Home score |
| away_score | an object containing details about Away score |
| matchDate | an object containing details about Date of the Match |
| matchTime | an object containing details about Time of the Match |
| matchVenue | an object containing details about Venue of the Match |
| venueID | The id of the Venue in the database (Integer) |
| venueName | an object containing the name of the Venue actually |
| participantName | an object containing the name of the participant actually |
| score | an object containing details about Match score |
| squad | an object containing details about line up |
| lineup | an object containing Players for starting line up |
| playerID | The id of the Player in the database (Integer) |
| additionalInfo | An object containing additional info about element |
| birthdate | The Birthdate of Player (format yyyy/dd/mm) |
| height | The Height of Player |
| weight | The Weight of Player |
| position | Player position; 1-Goalkeeper 2-Defender 3-Midfielder 4-Attacker |
| bench | an object containing Player who are named on the bench |
| subs | an object containing details about occurred substitutes |
| playerIN | The id of the Player who came off the bench (Integer) |
| playerOUT | The id of the Player who was substituted (Integer) |
| minute | an object containing minute when substitute or event occurred |
| events | an object containing details about match events |
| rowId | The id of the row (used for Live match in order to follow what Event is already uploaded, and what is new) |
| eventId | The id of the Event in the database (Integer) |
| eventName | The name of the Event (string) |
| awayParticipant | an object containing details about Away participant of the Match |
| participantID | The id of the Participant in the database (Integer) |
| teamStats | an object containing details about Team statistics |
| teamStatID | The id of the Team stat item in the database (Integer) |
| teamStatName | The name of the Team statistic figures (string) |
| count | The value of Team statistic figure |
| additionalInfo | an object containing additional details about Match |
| attendance | The value of Match attendance |
| referee | an object containing Match Referee info |
| referee_assitant | an object containing Match Referee assistant info |
| fourth_official | an object containing Fourth official referee |
| matchDuration | an object containing match duration in unites of minutes |
| stage | an object containing details about stage |
| stageID | The id of the Stage in the database (Integer) |
| stageName | The name of the Stage (string) |
Example of Response: hide code
{
"gmtUpdated":1624128448,
"match":{
"matchID":"24427",
"matchdayID":"2616",
"matchStatus":{
"statusID":"1"
},
"extraTime":{
"is_extra":"0",
"home_score":"0",
"away_score":"0"
},
"matchDate":"2021-06-02",
"matchTime":"19:00",
"matchVenue":{
"venueID":"40",
"venueName":"Estadi Montilivi"
},
"homeParticipant":{
"participantID":"26",
"score":"3",
"participantName":"Girona FC",
"squad":{
"lineup":[
{
"playerID":"707",
"additionalInfo":{
"birthdate":"1993-08-23",
"height":"173 cm",
"weight":"68 kg",
"position":"3"
}
},
{
"playerID":"746",
"additionalInfo":{
"birthdate":"1991-04-30",
"height":"190 cm",
"weight":"80 kg",
"position":"2"
}
},
{
"playerID":"981",
"additionalInfo":{
"birthdate":"1994-12-18",
"height":"188 cm",
"weight":"78 kg",
"position":"3"
}
},
{
"playerID":"5683",
"additionalInfo":{
"birthdate":"1994-03-20",
"height":"184 cm",
"weight":"80 kg",
"position":"4"
}
},
{
"playerID":"8530",
"additionalInfo":{
"birthdate":"1988-01-20",
"height":"187 cm",
"weight":"85 kg",
"position":"1"
}
},
{
"playerID":"8531",
"additionalInfo":{
"birthdate":"1998-11-09",
"height":"191 cm",
"weight":"76 kg",
"position":"2"
}
},
{
"playerID":"8756",
"additionalInfo":{
"birthdate":"1993-10-23",
"height":"175 cm",
"weight":"75 kg",
"position":"4"
}
},
{
"playerID":"8922",
"additionalInfo":{
"birthdate":"1997-02-26",
"height":"174 cm",
"weight":"66 kg",
"position":"2"
}
},
{
"playerID":"15107",
"additionalInfo":{
"birthdate":"1999-09-13",
"height":"173 cm",
"weight":"68 kg",
"position":"3"
}
},
{
"playerID":"18585",
"additionalInfo":{
"birthdate":"2002-06-03",
"height":"168 cm",
"weight":"60 kg",
"position":"2"
}
},
{
"playerID":"20437",
"additionalInfo":{
"birthdate":"2003-04-25",
"height":"",
"weight":"",
"position":"2"
}
}
],
"bench":[
{
"playerID":"651",
"additionalInfo":{
"birthdate":"1999-08-30",
"height":"185 cm",
"weight":"73 kg",
"position":"2"
}
},
{
"playerID":"711",
"additionalInfo":{
"birthdate":"1988-05-19",
"height":"182 cm",
"weight":"76 kg",
"position":"4"
}
},
{
"playerID":"742",
"additionalInfo":{
"birthdate":"1996-03-26",
"height":"194 cm",
"weight":"83 kg",
"position":"2"
}
},
{
"playerID":"747",
"additionalInfo":{
"birthdate":"1998-05-11",
"height":"168 cm",
"weight":"63 kg",
"position":"3"
}
},
{
"playerID":"765",
"additionalInfo":{
"birthdate":"1993-12-30",
"height":"174 cm",
"weight":"69 kg",
"position":"3"
}
},
{
"playerID":"1032",
"additionalInfo":{
"birthdate":"1990-06-10",
"height":"185 cm",
"weight":"85 kg",
"position":"1"
}
},
{
"playerID":"3756",
"additionalInfo":{
"birthdate":"1989-03-08",
"height":"193 cm",
"weight":"88 kg",
"position":"3"
}
},
{
"playerID":"8701",
"additionalInfo":{
"birthdate":"1991-07-07",
"height":"174 cm",
"weight":"72 kg",
"position":"4"
}
},
{
"playerID":"15105",
"additionalInfo":{
"birthdate":"1998-02-10",
"height":"174 cm",
"weight":"70 kg",
"position":"2"
}
},
{
"playerID":"15108",
"additionalInfo":{
"birthdate":"1995-10-10",
"height":"180 cm",
"weight":"78 kg",
"position":"4"
}
},
{
"playerID":"20942",
"additionalInfo":{
"birthdate":"2000-11-27",
"height":"183 cm",
"weight":"75 kg",
"position":"3"
}
},
{
"playerID":"21732",
"additionalInfo":{
"birthdate":"1997-03-18",
"height":"173 cm",
"weight":"70 kg",
"position":"3"
}
}
],
"subs":[
{
"playerIN":"15108",
"playerOUT":"981",
"minute":"64"
},
{
"playerIN":"20942",
"playerOUT":"8756",
"minute":"80"
},
{
"playerIN":"21732",
"playerOUT":"707",
"minute":"80"
},
{
"playerIN":"3756",
"playerOUT":"5683",
"minute":"88"
}
]
},
"events":[
{
"rowId":"1037472",
"eventId":"1",
"eventName":"Goal",
"playerID":"8756",
"minute":"3",
"stageID":"0",
"assist":[
{
"rowId":"1037473",
"eventId":"2",
"eventName":"Assist",
"playerID":"981",
"minute":"3"
}
]
},
{
"rowId":"1037474",
"eventId":"1",
"eventName":"Goal",
"playerID":"18585",
"minute":"5",
"stageID":"0",
"assist":[
{
"rowId":"1037475",
"eventId":"2",
"eventName":"Assist",
"playerID":"5683",
"minute":"5"
}
]
},
{
"rowId":"1037478",
"eventId":"5",
"eventName":"Yellow card",
"playerID":"746",
"minute":"53",
"stageID":"0"
},
{
"rowId":"1037479",
"eventId":"5",
"eventName":"Yellow card",
"playerID":"8922",
"minute":"54",
"stageID":"0"
},
{
"rowId":"1037480",
"eventId":"1",
"eventName":"Goal",
"playerID":"5683",
"minute":"65",
"stageID":"0",
"assist":[
{
"rowId":"1037481",
"eventId":"2",
"eventName":"Assist",
"playerID":"8756",
"minute":"65"
}
]
}
],
"teamStats":[
{
"rowId":"1037510",
"teamStatID":"11",
"teamStatName":"Possession",
"count":"48"
},
{
"rowId":"1037512",
"teamStatID":"9",
"teamStatName":"Total shots",
"count":"6"
},
{
"rowId":"1037514",
"teamStatID":"16",
"teamStatName":"Shots on target",
"count":"6"
},
{
"rowId":"1037516",
"teamStatID":"12",
"teamStatName":"Corners",
"count":"4"
},
{
"rowId":"1037519",
"teamStatID":"10",
"teamStatName":"Fouls",
"count":"14"
}
]
},
"awayParticipant":{
"participantID":"350",
"score":"0",
"participantName":"UD Almería",
"squad":{
"lineup":[
{
"playerID":"679",
"additionalInfo":{
"birthdate":"1999-03-02",
"height":"186 cm",
"weight":"78 kg",
"position":"2"
}
},
{
"playerID":"826",
"additionalInfo":{
"birthdate":"1997-12-16",
"height":"175 cm",
"weight":"70 kg",
"position":"2"
}
},
{
"playerID":"1101",
"additionalInfo":{
"birthdate":"1999-01-12",
"height":"178 cm",
"weight":"75 kg",
"position":"3"
}
},
{
"playerID":"4338",
"additionalInfo":{
"birthdate":"1996-02-16",
"height":"178 cm",
"weight":"69 kg",
"position":"4"
}
},
{
"playerID":"5836",
"additionalInfo":{
"birthdate":"1997-02-02",
"height":"192 cm",
"weight":"75 kg",
"position":"4"
}
},
{
"playerID":"5986",
"additionalInfo":{
"birthdate":"1997-03-09",
"height":"172 cm",
"weight":"66 kg",
"position":"3"
}
},
{
"playerID":"8598",
"additionalInfo":{
"birthdate":"1995-12-19",
"height":"189 cm",
"weight":"77 kg",
"position":"2"
}
},
{
"playerID":"8604",
"additionalInfo":{
"birthdate":"1992-01-01",
"height":"172 cm",
"weight":"63 kg",
"position":"2"
}
},
{
"playerID":"8607",
"additionalInfo":{
"birthdate":"1992-03-30",
"height":"179 cm",
"weight":"74 kg",
"position":"3"
}
},
{
"playerID":"9059",
"additionalInfo":{
"birthdate":"2001-02-27",
"height":"180 cm",
"weight":"68 kg",
"position":"4"
}
},
{
"playerID":"9304",
"additionalInfo":{
"birthdate":"1990-03-31",
"height":"194 cm",
"weight":"80 kg",
"position":"1"
}
}
],
"bench":[
{
"playerID":"3689"
},
{
"playerID":"4167"
},
{
"playerID":"5217"
},
{
"playerID":"6228"
},
{
"playerID":"8564"
},
{
"playerID":"8597"
},
{
"playerID":"8606"
},
{
"playerID":"8613"
},
{
"playerID":"8858"
},
{
"playerID":"9413"
},
{
"playerID":"10567"
},
{
"playerID":"19993"
}
],
"subs":[
{
"playerIN":"10567",
"playerOUT":"8598",
"minute":"46"
},
{
"playerIN":"8564",
"playerOUT":"5986",
"minute":"46"
},
{
"playerIN":"8613",
"playerOUT":"4338",
"minute":"64"
},
{
"playerIN":"4167",
"playerOUT":"9059",
"minute":"75"
}
]
},
"events":[
{
"rowId":"1037476",
"eventId":"5",
"eventName":"Yellow card",
"playerID":"8604",
"minute":"27",
"stageID":"0"
},
{
"rowId":"1037477",
"eventId":"5",
"eventName":"Yellow card",
"playerID":"9059",
"minute":"30",
"stageID":"0"
},
{
"rowId":"1037482",
"eventId":"5",
"eventName":"Yellow card",
"playerID":"9304",
"minute":"85",
"stageID":"0"
}
],
"teamStats":[
{
"rowId":"1037511",
"teamStatID":"11",
"teamStatName":"Possession",
"count":"52"
},
{
"rowId":"1037513",
"teamStatID":"9",
"teamStatName":"Total shots",
"count":"1"
},
{
"rowId":"1037515",
"teamStatID":"15",
"teamStatName":"Shots off target",
"count":"1"
},
{
"rowId":"1037517",
"teamStatID":"12",
"teamStatName":"Corners",
"count":"2"
},
{
"rowId":"1037518",
"teamStatID":"14",
"teamStatName":"Offsides",
"count":"3"
},
{
"rowId":"1037520",
"teamStatID":"10",
"teamStatName":"Fouls",
"count":"17"
}
]
},
"matchDuration":90,
"additionalInfo":{
"attendance":"",
"referee":"0",
"referee_assitant":"0",
"fourth_official":"0"
}
}
}
Get Match schedule with undefined teams
Some selected tournaments publish schedule without the defined teams when competition starts. (i.e. it is common thing for FIFA World Cup elimination stages).
In order to get available Season schedule without Team names put the parameter with the required Season id &season_id=in the Request
and the parameter &withoutTeams=true
Example of HTTP Request: https://api.statorium.com/api/v1/matches/?apikey=123_test_token_123&season_id=33&withoutTeams=true
Participant id for undefined Team is -1
Included attributes:
| Name | Description |
|---|---|
| calendar | An object containing details about Matches |
| leagueID | The id of the League (integer) |
| seasonID | The id of the Season (integer) |
| seasonName | The name of the Season (string) |
| fullName | The full name of the Season (string) |
| stages | The information about the Stages in the Season (Competition phases, e.g Champions League includes Classification, then PlayOff, then Group stage etc ) |
| matchdays | An object containing details about Rounds |
| matchdayID | The id of the Matchday (integer) |
| matchdayName | The name of the Matchday (string) |
| matchdayPlayoff | Entry if Matchday is playoff or not |
| matchdayType | The information about the Stages in the Season (link to data sheet) |
| matchdayStart | The information about the Start of Matchday (format yyyy-mm-dd) |
| matchdayEnd | The information about the End of Matchday (format yyyy-mm-dd) |
| matches | An object containing Match details |
| matchID | The id of the Match in the database (integer) |
| matchStatus | An object containing details about Match status |
| statusID | The id of match status (integer) (link to Data sheet) |
| is Extra | The Entry if match contains Extra time/Overtime or not |
| home_score | an object containing details about Home score |
| away_score | an object containing details about Away score |
| matchDate | Date of the Match (format yyyy-mm-dd) |
| matchTime | Time of the Match (24h format) |
| matchVenue | An object containing details about Venue of the Match |
| venueID | The id of the Venue (integer) |
| homeParticipant | An object containing details about Home team of the Match |
| awayParticipant | An object containing details about Away team of the Match |
| participantID | The id of the Participant (integer) |
| participantName | The name of the participant |
| score | An object containing details about Team score |
| stage | an object containing details about stage |
| stageID | The id of the Stage in the database (Integer) |
| stageName | The name of the Stage (string) including Penalty Shootout |
Example of Response: hide code
{
"gmtUpdated": 1567164111,
"calendar": {
"seasonID": 1,
"leagueID": "1",
"seasonName": "2023/2024",
"fullName": "Premier League (England) 2023/2024",
"stages": false,
"matchdays": [
{
"matchdayID": "1",
"matchdayName": "MatchDay 1",
"matchdayPlayoff": "0",
"matchdayType": "0",
"matchdayStart": null,
"matchdayEnd": null,
"matches": [
{
"matchID": "1",
"matchStatus": {
"statusID": "0"
},
"matchDate": "2023-08-10",
"matchTime": "19:00",
"matchVenue": {
"venueID": "12"
},
"homeParticipant": {
"participantID": "-1",
"participantName": "Team name"
"score": "0"
},
"awayParticipant": {
"participantID": "14",
"score": "0"
}
},
{
"matchID": "2",
"matchStatus": {
"statusID": "0"
},
"matchDate": "2023-08-11",
"matchTime": "11:30",
"matchVenue": {
"venueID": "17"
},
"homeParticipant": {
"participantID": "-1",
"participantName": "null"
"score": "0"
},
"awayParticipant": {
"participantID": "-1",
"participantName": "Team name"
"score": "0"
}
},
{
"matchID": "3",
"matchStatus": {
"statusID": "0"
},
"matchDate": "2023-08-11",
"matchTime": "14:00",
"matchVenue": {
"venueID": "2"
},
"homeParticipant": {
"participantID": "16",
"score": "0"
},
"awayParticipant": {
"participantID": "18",
"score": "0"
}
}
]
}
]
}
}
Live Matches
A request on Live Matches endpoint returns all Matches information within the timeframe +3 hours/-1 hour based on the date and time of the request
Example of HTTP Request: https://api.statorium.com/api/v1/matches/live/?apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| matches | An object containing Match details |
| seasonID | The id of the Season (integer) |
| matchdayID | The id of the Matchday (integer) |
| matchID | The id of the Match in the database (integer) |
| matchStatus | An object containing details about Match status |
| matchDate | Date of the Match (format yyyy-mm-dd) |
| matchTime | Time of the Match (24h format) |
| matchVenue | An object containing details about Venue of the Match |
| homeParticipant | An object containing details about Home team of the Match |
| awayParticipant | An object containing details about Away team of the Match |
| participantID | The id of the Participant (integer) |
| score | An object containing details about Team score |
Example of Response: hide code
{
"gmtUpdated":1624107889,
"matches":[
{
"matchID":"19956",
"seasonID":"40",
"matchdayID":"893",
"matchStatus":{
"value":"-1"
},
"matchDate":"2021-06-19",
"matchTime":"13:00",
"matchVenue":{
"value":"415"
},
"homeParticipant":{
"participantID":"671",
"score":"0"
},
"awayParticipant":{
"participantID":"383",
"score":"0"
}
},
{
"matchID":"8211",
"seasonID":"40",
"matchdayID":"893",
"matchStatus":{
"value":"0"
},
"matchDate":"2021-06-19",
"matchTime":"16:00",
"matchVenue":{
"value":"44"
},
"homeParticipant":{
"participantID":"387",
"score":"0"
},
"awayParticipant":{
"participantID":"384",
"score":"0"
}
},
{
"matchID":"24437",
"seasonID":"89",
"matchdayID":"2617",
"matchStatus":{
"value":"0"
},
"matchDate":"2021-06-19",
"matchTime":"16:00",
"matchVenue":{
"value":"751"
},
"homeParticipant":{
"participantID":"757",
"score":"0"
},
"awayParticipant":{
"participantID":"601",
"score":"0"
}
}
]
}
Today Matches
A request on Today Matches endpoint returns information about all Matches on the specified date
This endpoint has two parameters:
&date={date} - required. The date is entered in the ISO format (yyyy-mm-dd)
&withoutTeams=true - optional. Used for tournaments when you need to show knockout games without defined teams yet (World Cup, Euro Cup and etc.)
Example of HTTP Request: https://api.statorium.com/api/v1/todaymatches/?apikey=123_test_token_123&withoutTeams=true&date=2024-11-01
Included attributes:
| Name | Description |
|---|---|
| matches | An object containing Match details |
| matchID | The id of the Match in the database (integer) |
| seasonID | The id of the Season (integer) |
| matchdayID | The id of the Matchday (integer) |
| matchStatus | An object containing details about Match status |
| matchDate | Date of the Match (format yyyy-mm-dd) |
| matchTime | Time of the Match (24h format) |
| matchVenue | An object containing details about Venue of the Match |
| homeParticipant | An object containing details about Home team of the Match |
| awayParticipant | An object containing details about Away team of the Match |
| participantID | The id of the Participant (integer) |
| score | An object containing details about Team score |
| translations | Available translations of the team name (Premium package) |
Example of Response: hide code
{
"gmtUpdated": 1730479240,
"matches": [
{
"matchID": "91811",
"seasonID": "397",
"matchdayID": "9938",
"matchStatus": {
"value": "1"
},
"matchDate": "2024-11-01",
"matchTime": "14:35",
"matchVenue": {
"value": "1296"
},
"homeParticipant": {
"participantID": "1449",
"score": "4",
"translations": {
"ar": {
"name": "نادي الخليج"
}
}
},
"awayParticipant": {
"participantID": "732",
"score": "0",
"translations": {
"ar": {
"name": "نادي الرائد"
}
}
}
},
{
"matchID": "91815",
"seasonID": "397",
"matchdayID": "9938",
"matchStatus": {
"value": "-1"
},
"matchDate": "2024-11-01",
"matchTime": "15:15",
"matchVenue": {
"value": "714"
},
"homeParticipant": {
"participantID": "727",
"score": "1",
"translations": {
"ar": {
"name": "نادي ضمك"
}
}
},
"awayParticipant": {
"participantID": "2042",
"score": "1",
"translations": {
"ar": {
"name": "الرياض"
}
}
}
},
{
"matchID": "81812",
"seasonID": "358",
"matchdayID": "8837",
"matchStatus": {
"value": "0"
},
"matchDate": "2024-11-01",
"matchTime": "18:00",
"matchVenue": {
"value": "87"
},
"homeParticipant": {
"participantID": "76",
"score": "0",
"translations": {
"ar": {
"name": "موناكو"
},
"zh": {
"name": "摩納哥",
"middle_name": "摩納哥"
},
"gr": {
"name": "ΑΣ Μονακό",
"middle_name": "ΑΣ Μονακό"
}
}
}
]
}
Odds
Odds for the match are available for premium level accounts and are provided through Matches endpoint. The additional parameter &include=odds allows you to pull odds from that endpoint.
Example of HTTP Request: https://api.statorium.com/api/v1/matches/{matchID}/?apikey=123_test_token_123&include=odds
Included attributes:
| Name | Description |
|---|---|
| betting | An object containing betting details |
| key | The name of the bookmaker (string) |
| title | The name of the bookmaker (string) |
| timestamp | Current time (format yyyy-mm-dd) |
| odds | An object containing odds details |
| key | The key of the available odds type |
| title | The name of the available odds type |
| values | An object containing odds values |
| value | The event's name |
| odd | Coefficient |
Example of Response: hide code
"betting": {
"bokkmakers": [
{
"key": "marathonbet",
"title": "MarathonBet",
"timestamp": "2024-07-01 15:38:14 UTC",
"odds": [
{
"key": "1x2",
"title": "1x2",
"values": [
{
"value": "Home",
"odd": 1.909
},
{
"value": "Draw",
"odd": 3.44
},
{
"value": "Away",
"odd": 4.6
}
]
}
]
}
]
}
Teams
A request on Team endpoint returns all information about the Team which id is used in request: Name, ShortName, Home Venue and Players
Example of HTTP Request: https://api.statorium.com/api/v1/teams/1/?season_id=1&apikey=123_test_token_123
To show “next five” or “last fifteen” matches on team page you need to use extra parameter &showmatches=true
Example of HTTP Request: https://api.statorium.com/api/v1/teams/1/?apikey=123_test_token_123&showmatches=true
Included attributes:
| Name | Description |
|---|---|
| team | An object containing details about Team |
| seasonID | The id of the Season (integer) |
| teamName | The name of the Team (string) |
| shortName | The short name of the Team (string) |
| city | The name of the City (string) |
| logo | Path to logo png format |
| homeVenue | An object containing details about Home venue |
| name | The name of the Venue (string) |
| id | The id of the Venue (integer) |
| additionalInfo | An object containing additional info about Team |
| coach | An object containing info about Coach |
| players | An object containing Player info |
| prev_matches | The last 15 matches played by the team in all tournaments |
| next_matches | The next 5 matches of the team in all tournaments |
Example of Response: hide code
{
"gmtUpdated": 1567176563,
"team": {
"teamID": "1",
"seasonID": 0,
"teamName": "West Ham United",
"shortName": "WHU",
"city": "London",
"logo": "https://api.statorium.com/media/bearleague/bl15524865522808.png",
"homeVenue": {
"name": "London Stadium",
"id": "13"
},
"additionalInfo": {
"coach": null
},
"players": []
}
}
Players
Get Player by ID
A request on Player endpoint returns all information about the Player which id is used in request: Name, Full Name, Birthdate and other personal info including path to photo file.
Example of HTTP Request: https://api.statorium.com/api/v1/players/1/?season_id=1&apikey=123_test_token_123
To show player statistics for all seasons in all tournaments on player page you need to use extra parameter &showstat=true
Example of HTTP Request: https://api.statorium.com/api/v1/players/1/?apikey=123_test_token_123&showstat=true
Included attributes:
| Name | Description |
|---|---|
| player | An object containing details about Player |
| playerID | The id of the Player (integer) |
| firstName | The first name of the Player (string) |
| lastName | The last name of the Player (string) |
| shortName | The short name of the Player (string) |
| fullName | Full Player name (string) |
| country | An object containing details about Country |
| name | The name of the Country (string) |
| currentTeam | An object containing info about Player's Team |
| name | The name of the Team (string) |
| id | The id of the Team (integer) |
| photo | Path to the Player photo |
| additionalInfo | An object containing additional info about Player |
| birthdate | The Birthdate of Player (format yyyy/dd/mm) |
| height | The Height of Player |
| weight | The Weight of Player |
| position | Player position; 1-Goalkeeper 2-Defender 3-Midfielder 4-Attacker |
| teams | An object containing info about Player's teams |
| stat | Player statistics for all seasons in all tournaments |
Example of Response: hide code
{
"gmtUpdated": 1567177984,
"player": {
"playerID": "1",
"firstName": "Łukasz",
"lastName": "Fabiański",
"shortName": "Ł. Fabiański",
"fullName": "Łukasz Fabiański",
"country": {
"name": "Poland",
"id": "176"
},
"currentTeam": {
"name": null,
"id": "0"
},
"photo": "https://api.statorium.com/media/bearleague/bl15544573321057.png",
"additionalInfo": {
"birthdate": "1985-04-18",
"height": "190 cm",
"weight": "83 kg",
"position": "1"
},
"teams": []
}
}
Top players
A request on Top Players endpoint returns Event stats by Player in chosen Season.
Example of HTTP Request: https://api.statorium.com/api/v1/topplayers/20/?apikey=123_test_token_123&event_id=1&limit=100
Included attributes:
| Name | Description |
|---|---|
| seasonID | The id of the Season in the database (Integer) |
| eventId | The id of the Event in the database (Integer) |
| eventName | The name of the Event (string) |
| limit | Number of Players to be displayed (Integer). If not specified 10 Players will be displayed by default |
| player | An object containing details about Player |
| playerID | The id of the Player (integer) |
| firstName | The first name of the Player (string) |
| lastName | The last name of the Player (string) |
| shortName | The short name of the Player (string) |
| fullName | Full Player name (string) |
| teamName | The name of the Team (string) |
| eventCount | Number of Events achieved by Player (or average value depending on Event settings |
Example of Response: hide code
[
{
"fullname": "Robert Lewandowski",
"first_name": "Robert",
"last_name": "Lewandowski",
"shortname": "R. Lewandowski",
"id": "1407",
"teamname": "FC Bayern München",
"eventCount": "29"
},
{
"fullname": "Timo Werner",
"first_name": "Timo",
"last_name": "Werner",
"shortname": "T. Werner",
"id": "1344",
"teamname": "RB Leipzig",
"eventCount": "25"
}
]
Venue
Get Venue by ID
A request on Venue endpoint returns all information about the Venue which id is used in request: Name, Address, Coordinates and other info including path to photo file.
Example of HTTP Request: https://api.statorium.com/api/v1/venues/1/?apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| venue | An object containing details about Venue |
| id | The id of the Venue (integer) |
| venueName | The name of the Venue (string) |
| venueAddress | The Venue address details |
| venueCity | The name of the city where the Venue located (string) |
| venueCoordX | The Latitude of the Venue |
| venueCoordY | The Longitude of the Venue |
| photo | Path to the Venue photo |
| additionalInfo | An object containing additional info about Venue |
| capacity | The Capacity of the Venue |
| opened | The Year of Venue opening |
Example of Response: hide code
{
"gmtUpdated": 1567178467,
"venue": {
"id": "1",
"venueName": "King Power Stadium",
"venueAddress": "Filbert Way, Leicester LE2 7FL, UK",
"venueCity": "Leicester, Leicestershire",
"venueCoordX": "52.6204",
"venueCoordY": "-1.14219",
"photo": "https://api.statorium.com/media/bearleague/bl15658693202664.jpg",
"additionalInfo": {
"capacity": "32312",
"opened": "2002"
}
}
}
Countries
A request on Countries endpoint returns all Countries info available in Database.
The Countries Endpoint includes such information as ID, Name and Code
Example of HTTP Request: https://api.statorium.com/api/v1/countries/?apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| countries | An object containing additional info about Countries |
| id | The id of the Country (integer) |
| name | The name of the Country (string) |
| code | The international code of the Country (string) |
Example of Response: hide code
{
"gmtUpdated": 1567179960,
"countries": [
{
"id": "1",
"name": "Afghanistan",
"code": "AF"
},
{
"id": "2",
"name": "Aland Islands",
"code": "AX"
},
{
"id": "3",
"name": "Albania",
"code": "AL"
},
{
"id": "4",
"name": "Algeria",
"code": "DZ"
},
{
"id": "5",
"name": "American Samoa",
"code": "AS"
},
{
"id": "6",
"name": "Andorra",
"code": "AD"
},
{
"id": "7",
"name": "Angola",
"code": "AO"
},
{
"id": "8",
"name": "Anguilla",
"code": "AI"
},
{
"id": "9",
"name": "Antarctica",
"code": "AQ"
},
{
"id": "10",
"name": "Antigua and Barbuda",
"code": "AG"
},
{
"id": "11",
"name": "Argentina",
"code": "AR"
},
{
"id": "12",
"name": "Armenia",
"code": "AM"
},
{
"id": "13",
"name": "Aruba",
"code": "AW"
},
{
"id": "14",
"name": "Australia",
"code": "AU"
},
{
"id": "15",
"name": "Austria",
"code": "AT"
},
{
"id": "16",
"name": "Azerbaijan",
"code": "AZ"
},
{
"id": "17",
"name": "Bahamas",
"code": "BS"
},
{
"id": "18",
"name": "Bahrain",
"code": "BH"
},
{
"id": "19",
"name": "Bangladesh",
"code": "BD"
},
{
"id": "20",
"name": "Barbados",
"code": "BB"
},
{
"id": "21",
"name": "Belarus",
"code": "BY"
},
{
"id": "22",
"name": "Belgium",
"code": "BE"
},
{
"id": "23",
"name": "Belize",
"code": "BZ"
}
]
}
Get Country by ID
Example of HTTP Request: https://api.statorium.com/api/v1/countries/31/?apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| country | An object containing additional info about Country |
| id | The id of the Country in the database (Integer) |
| name | The name of the Country (string) |
| code | The international code of the Country (string) |
| img | Path to the Country flag |
Example of Response: hide code
{
"gmtUpdated": 1567180341,
"country": {
"id": "31",
"name": "Brazil",
"code": "BR",
"img": "https://api.statorium.com/components/com_joomsport/img/flags/br.png"
}
}
Transfers
Transfers data is available for premium level accounts
A request on Transfers endpoint returns all transfers available in Database.
The Transfers Endpoint includes information about Date, Player, Teams and transfer details.
Example of HTTP Request: https://api.statorium.com/api/v1/transfers/?apikey=123_test_token_123
To receive the limited number of transfers you need to use extra parameter &limit={number}
Example of HTTP Request: https://api.statorium.com/api/v1/transfers/?apikey=123_test_token_123&limit=15
You can filter transfers by selected teams. You need to use extra parameter with team IDs separated by coma &teams={teamID},{teamID},{teamID}
Example of HTTP Request: https://api.statorium.com/api/v1/transfers/?apikey=123_test_token_123&teams=1,2,6,8
Included attributes:
| Name | Description |
|---|---|
| date | Transfer date (format yyyy-mm-dd) |
| player | An object containing details about Player |
| id | The id of the Player (integer) |
| name | Full Player name (string) |
| photo | Path to the Player photo |
| fromTeam | An object containing details about departure Team |
| id | The id of the Team (integer) |
| name | The full name of the Team (string) |
| shortName | The short name of the Team (string) |
| middleName | The middle name of the Team (string) |
| emblem | Path to the Team emblem |
| toTeam | An object containing details about arrival Team |
| details | An object containing details about Transfer details |
| type | Type of Transfer |
| fee | Transfer fee |
Example of Response: hide code
{
"gmtUpdated": 1713876746,
"transfers": {
"date": "2024-04-09",
"player": [
{
"id": "1174",
"name": "Sanjin Prcić",
"photo": "https://api.statorium.com/media/bearleague/bl15580045281342.png"
}
],
"fromTeam": [
{
"id": "68",
"name": "RC Strasbourg Alsace",
"shortName": "STR",
"middleName": "Strasbourg",
"emblem": "https://api.statorium.com/media/bearleague/bl1552913121645.png"
}
],
"toTeam": [
{
"id": "",
"name": "null",
"shortName": "null",
"middleName": "null",
"emblem": ""
}
],
"details": [
{
"type": "Contract suspended",
"fee": "0"
}
]
}
}
Get updates
It's the unique ability of Statorium API, that allows to update data without overwriting it. During updating the system will just add missed or change new information.
A request on Update endpoint returns all update have permission to since specified time (seconds after Unix time January 1,1970).
In case if mentioned data about mentioned below entities is updated, it is marked in separate table with time mark.
Database record is added once one of mentioned actions performed:
1) Matchday (add/edit);
2) Match (add/edit);
3) Player (edit);
4) Team(edit);
5) Team players (on change).
Example of HTTP Request: https://api.statorium.com/api/v1/updates/555545645?apikey=123_test_token_123
Included attributes:
| Name | Description |
|---|---|
| elementID | The id of the element (integer) |
| elementName | the name of element that was changed |
| changes | Type of changes |
| delete | Type of changes when element is deleted |
| update | Type of changes when element is updated |
| add | Type of changes when element is added |
| lastUpd | The date of last update of mentioned element |
| season_id | The id of the Season (integer) |
| venue | The Venue entity title |
| team_players | The Team players entity title |
| team | The Team entity title |
| match | The Match entity title |
Example of Response: hide code
[
{
"id": "1",
"elementID": "757",
"elementName": "player",
"changes": "update",
"lastUpd": "2019-08-20 12:20:53",
"season_id": "24"
},
{
"id": "2",
"elementID": "949",
"elementName": "player",
"changes": "update",
"lastUpd": "2019-08-20 12:20:53",
"season_id": "24"
},
{
"id": "3",
"elementID": "1213",
"elementName": "player",
"changes": "update",
"lastUpd": "2019-08-20 12:20:53",
"season_id": "24"
},
{
"id": "4",
"elementID": "1474",
"elementName": "player",
"changes": "update",
"lastUpd": "2019-08-20 12:20:53",
"season_id": "24"
},
{
"id": "5",
"elementID": "3758",
"elementName": "player",
"changes": "update",
"lastUpd": "2019-08-20 12:20:53",
"season_id": "24"
},
{
"id": "6",
"elementID": "3759",
"elementName": "player",
"changes": "update",
"lastUpd": "2019-08-20 12:20:53",
"season_id": "24"
}
]
WordPress integration
Statorium football data feed can be integrated with WordPress website.
The Sport information is imported directly to your site database. There is JoomSport plugin that allows managing and keeping updated all soccer data easily on your WordPress site. The information about Fixtures, Standings, Players, Teams, Matches and other items delivered via WordPress Posts, plugin Shortcodes, Widgets and Menu items.
The delivery process:
1. To get Statorium Data you need to acquire two items:
- Purchase JoomSport software. Advanced subscription level required.
- Data subscription for chosen leagues. Please contact us if you haven't done so yet.
2. The setup service and the first data import is included into the subscription price. Once subscriptions confirmed JoomSport team will request the access to your site. We will setup JoomSport software for soccer and configure Statorium API plugin for football data feeds import.
3. The Statorium support team will import all the leagues ordered to your WordPress site.
4. Then you will be able to distribute all the Sports data such as Standings, Calendar, etc. using Menu items, Shortcodes and Widgets.
How the data and LIVE matches are updated:
Statorium plugin has a unique update system. It allows updating data without overwriting the full database. The system consists of two parts:
The first part is the API server-side script. Once any item (Player / Team / Match / etc.) updated system submits the new entry with timestamp into the update log.
The second part is the script that constantly checks (using the WordPress cron job) information from the update log and compares it with the last update time mark. If there are any updates happened within the last update interval system pulls them from API server.
Joomla integration
Statorium football data feed can be integrated with Joomla! CMS based website.
The Sport information is imported directly to your site database. There is JoomSport component that allows managing and keeping updated all soccer data easily on your Joomla site. The information about Fixtures, Standings, Players, Teams, Matches and other items delivered via Joomla pages, Modules and Menu items.
The delivery process:
1. To get Statorium Data you need to acquire two items:
- Purchase JoomSport software. Advanced subscription level required.
- Data subscription for chosen leagues. Please contact us if you haven't done so yet.
2. The setup service and the first data import is included into the subscription price. Once subscriptions confirmed JoomSport team will request the access to your site. We will setup JoomSport software for soccer and configure Statorium API add-on for football data feeds import.
3. The Statorium support team will import all the leagues ordered to your Joomla site.
4. Then you will be able to distribute all the Sports data such as Standings, Calendar, etc. using Menu items, Joomla Menu and Modules.
How the data and LIVE matches are updated:
Statorium add-on has a unique update system. It allows data updating without overwriting the full database. The system consists of two parts:
The first part is the API server-side script. Once any item (Player / Team / Match / etc.) updated system submits the new entry with timestamp into the update log.
The second part is the script that constantly checks (using the cron job) information from the update log and compares it with the last update time mark. If there are any updates happened within the last update interval system pulls them from API server.
Mobile App Integration
Statorium football data feed can be delivered to Android and iOS with our JoomSport mobile application.
Using JoomSport plugin the soccer data is imported directly to Joomla! or WordPress based website database. (check Joomla integration or WordPress integration)
Specially developed JoomSport Mobile application is connected to your website database and displays data on mobile device. Implemented Push notifications for match results allow fans to follow their favorite Teams.
The following diagram applies:
Predictions Integration
Statorium football API feed can be also used to organize prediction competition on your WordPress or Joomla website.
Using JoomSport plugin the soccer data is imported directly to Joomla! or WordPress based website database. (check Joomla integration or WordPress integration)
Specially developed Predictions plugin (or add-on) allows you to use matches to create prediction leagues and rounds. Once your site users submit their predictions, the prediction stats blocks can be added to your JoomSport match pages.
The following diagram applies: