Statorium Statorium Reliable Soccer Data Feeds

Introduction

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= {season_id}&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
matchdayType 0 Round Robin competition
matchdayType 2 Single elimination competition
matchdayType 3 Double elimination competition
matchdayPlayoff 0 Ordinary Round
matchdayPlayoff 1 Playoff Round

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

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
s_legend The Standings legend name
place The place number
color The color code to highlight chosen Places (Hex Code)

Example of Response: hide code

{
  "gmtUpdated": 1565781923,
  "season": {
    "seasonID": 1,
    "leagueID": "1",
    "seasonName": "2018/2019",
    "fullName": "Premier League (England) 2018/2019",
    "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 qualification"
      },
      {
        "place": "18-20",
        "color": "#FF0000",
        "s_legend": "Relegation"
      },
      {
        "place": "1-4",
        "color": "#003300",
        "s_legend": "Champions League group stage qualification"
      }
    ]
  }
}

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
    },
    {
      "matchdayID": "3",
      "matchdayName": "MatchDay 3",
      "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

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"
        },
        "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"
        }
      },
      {
        "matchID": "4",
        "matchStatus": {
          "statusID": "1"
        },
        "matchDate": "2018-08-11",
        "matchTime": "14:00",
        "matchVenue": {
          "venueID": "19"
        },
        "homeParticipant": {
          "participantID": "5",
          "score": "0"
        },
        "awayParticipant": {
          "participantID": "15",
          "score": "2"
        }
      },
      {
        "matchID": "5",
        "matchStatus": {
          "statusID": "1"
        },
        "matchDate": "2018-08-11",
        "matchTime": "14:00",
        "matchVenue": {
          "venueID": "16"
        },
        "homeParticipant": {
          "participantID": "20",
          "score": "0"
        },
        "awayParticipant": {
          "participantID": "8",
          "score": "3"
        }
      },
      {
        "matchID": "6",
        "matchStatus": {
          "statusID": "1"
        },
        "matchDate": "2018-08-11",
        "matchTime": "14:00",
        "matchVenue": {
          "venueID": "3"
        },
        "homeParticipant": {
          "participantID": "11",
          "score": "2"
        },
        "awayParticipant": {
          "participantID": "19",
          "score": "0"
        }
      },
      {
        "matchID": "7",
        "matchStatus": {
          "statusID": "1"
        },
        "matchDate": "2018-08-11",
        "matchTime": "16:30",
        "matchVenue": {
          "venueID": "20"
        },
        "homeParticipant": {
          "participantID": "13",
          "score": "2"
        },
        "awayParticipant": {
          "participantID": "6",
          "score": "2"
        }
      },
      {
        "matchID": "8",
        "matchStatus": {
          "statusID": "1"
        },
        "matchDate": "2018-08-12",
        "matchTime": "12:30",
        "matchVenue": {
          "venueID": "14"
        },
        "homeParticipant": {
          "participantID": "3",
          "score": "4"
        },
        "awayParticipant": {
          "participantID": "1",
          "score": "0"
        }
      },
      {
        "matchID": "9",
        "matchStatus": {
          "statusID": "1"
        },
        "matchDate": "2018-08-12",
        "matchTime": "12:30",
        "matchVenue": {
          "venueID": "6"
        },
        "homeParticipant": {
          "participantID": "17",
          "score": "0"
        },
        "awayParticipant": {
          "participantID": "12",
          "score": "0"
        }
      },
      {
        "matchID": "10",
        "matchStatus": {
          "statusID": "1"
        },
        "matchDate": "2018-08-12",
        "matchTime": "15:00",
        "matchVenue": {
          "venueID": "10"
        },
        "homeParticipant": {
          "participantID": "9",
          "score": "0"
        },
        "awayParticipant": {
          "participantID": "4",
          "score": "2"
        }
      }
    ]
  },
  "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)
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

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/1/?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)
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)
homeParticipant an object containing details about Home participant of the Match
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)
bench an object containing Player who are named on the bench
subs an object containing details about occured 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 additiona 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

Example of Response: hide code

{
  "gmtUpdated": 1567165009,
  "match": {
    "matchID": "1",
    "matchdayID": "1",
    "matchStatus": {
      "statusID": "1"
    },
    "matchDate": "2018-08-10",
    "matchTime": "19:00",
    "matchVenue": {
      "venueID": "12"
    },
    "homeParticipant": {
      "participantID": "7",
      "score": "2",
      "squad": {
        "lineup": [
          {
            "playerID": "169"
          },
          {
            "playerID": "171"
          },
          {
            "playerID": "172"
          },
          {
            "playerID": "173"
          },
          {
            "playerID": "174"
          },
          {
            "playerID": "178"
          },
          {
            "playerID": "180"
          },
          {
            "playerID": "182"
          },
          {
            "playerID": "183"
          },
          {
            "playerID": "186"
          },
          {
            "playerID": "187"
          }
        ],
        "bench": [
          {
            "playerID": "170"
          },
          {
            "playerID": "175"
          },
          {
            "playerID": "176"
          },
          {
            "playerID": "181"
          },
          {
            "playerID": "184"
          },
          {
            "playerID": "185"
          },
          {
            "playerID": "558"
          }
        ],
        "subs": [
          {
            "playerIN": "184",
            "playerOUT": "186",
            "minute": "67"
          },
          {
            "playerIN": "181",
            "playerOUT": "183",
            "minute": "76"
          },
          {
            "playerIN": "558",
            "playerOUT": "182",
            "minute": "84"
          }
        ]
      },
      "events": [
        {
          "rowId": "1",
          "eventId": "4",
          "eventName": "Penalty goal",
          "playerID": "182",
          "minute": "3"
        },
        {
          "rowId": "8",
          "eventId": "5",
          "eventName": "Yellow card",
          "playerID": "183",
          "minute": "54"
        },
        {
          "rowId": "5",
          "eventId": "5",
          "eventName": "Yellow card",
          "playerID": "178",
          "minute": "69"
        },
        {
          "rowId": "2",
          "eventId": "1",
          "eventName": "Goal",
          "playerID": "174",
          "minute": "83",
          "assist": [
            {
              "rowId": "3",
              "eventId": "2",
              "eventName": "Assist",
              "playerID": "180",
              "minute": "83"
            }
          ]
        }
      ],
      "teamStats": [
        {
          "rowId": "46957",
          "teamStatID": "11",
          "teamStatName": "Possesions",
          "count": "46"
        },
        {
          "rowId": "46959",
          "teamStatID": "9",
          "teamStatName": "Total shots",
          "count": "8"
        },
        {
          "rowId": "46961",
          "teamStatID": "16",
          "teamStatName": "Shots on target",
          "count": "6"
        },
        {
          "rowId": "46963",
          "teamStatID": "15",
          "teamStatName": "Shots off target",
          "count": "1"
        },
        {
          "rowId": "46965",
          "teamStatID": "17",
          "teamStatName": "Blocked shots",
          "count": "1"
        },
        {
          "rowId": "46967",
          "teamStatID": "12",
          "teamStatName": "Corners",
          "count": "2"
        },
        {
          "rowId": "46969",
          "teamStatID": "14",
          "teamStatName": "Offsides",
          "count": "4"
        },
        {
          "rowId": "46971",
          "teamStatID": "10",
          "teamStatName": "Fouls",
          "count": "11"
        }
      ]
    },
    "awayParticipant": {
      "participantID": "14",
      "score": "1",
      "squad": {
        "lineup": [
          {
            "playerID": "363"
          },
          {
            "playerID": "364"
          },
          {
            "playerID": "365"
          },
          {
            "playerID": "368"
          },
          {
            "playerID": "369"
          },
          {
            "playerID": "371"
          },
          {
            "playerID": "372"
          },
          {
            "playerID": "373"
          },
          {
            "playerID": "374"
          },
          {
            "playerID": "376"
          },
          {
            "playerID": "557"
          }
        ],
        "bench": [
          {
            "playerID": "366"
          },
          {
            "playerID": "367"
          },
          {
            "playerID": "370"
          },
          {
            "playerID": "375"
          },
          {
            "playerID": "378"
          },
          {
            "playerID": "379"
          },
          {
            "playerID": "560"
          }
        ],
        "subs": [
          {
            "playerIN": "379",
            "playerOUT": "371",
            "minute": "63"
          },
          {
            "playerIN": "375",
            "playerOUT": "376",
            "minute": "63"
          },
          {
            "playerIN": "560",
            "playerOUT": "557",
            "minute": "80"
          }
        ]
      },
      "events": [
        {
          "rowId": "6",
          "eventId": "5",
          "eventName": "Yellow card",
          "playerID": "371",
          "minute": "51"
        },
        {
          "rowId": "4",
          "eventId": "1",
          "eventName": "Goal",
          "playerID": "375",
          "minute": "90+3"
        }
      ],
      "teamStats": [
        {
          "rowId": "46958",
          "teamStatID": "11",
          "teamStatName": "Possesions",
          "count": "54"
        },
        {
          "rowId": "46960",
          "teamStatID": "9",
          "teamStatName": "Total shots",
          "count": "13"
        },
        {
          "rowId": "46962",
          "teamStatID": "16",
          "teamStatName": "Shots on target",
          "count": "4"
        },
        {
          "rowId": "46964",
          "teamStatID": "15",
          "teamStatName": "Shots off target",
          "count": "3"
        },
        {
          "rowId": "46966",
          "teamStatID": "17",
          "teamStatName": "Blocked shots",
          "count": "6"
        },
        {
          "rowId": "46968",
          "teamStatID": "12",
          "teamStatName": "Corners",
          "count": "5"
        },
        {
          "rowId": "46970",
          "teamStatID": "14",
          "teamStatName": "Offsides",
          "count": "2"
        },
        {
          "rowId": "46972",
          "teamStatID": "10",
          "teamStatName": "Fouls",
          "count": "8"
        }
      ]
    },
    "additionalInfo": {
      "attendance": "744391",
      "referee": "0",
      "referee_assitant": "0",
      "fourth_official": "0"
    }
  }
}

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/7/?season_id=1&apikey=123_test_token_123

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

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

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
teams An object containing info about Player's teams

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": []
  }
}

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"
  }
}

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:

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:

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: