API Soccer - Documentation

API Soccer Documentation

Here you will find all the calls available in API return.

All calls have a first required parameter called apiKey, there are methods that receive more than one parameter, such as team by ID or league by ID, in which case the apiKey parameter must always be the first.

The default data format is Json, with a structure that you can check the return status, the success of the call and the data return.

Use the left menu for main methods or scroll down to view all API methods

Response Json:

"Success": true, "Status": "Ok","Data": [ {} ]

Is Alive API

Get current status of API

HTTP GET apisoccer.com/api/Soccer/isAlive

Method Parameters

action = isAlive

apiKey = Your unique apiKey (freeAPIKey for test)

Request Example

http://www.apisoccer.com/api/Soccer/isAlive?apiKey=freeAPIKey

Response JSON

Test this Call

Livescore Matches

Get list of all livematches from API

HTTP GET apisoccer.com/api/Soccer/getLiveMatches

Method Parameters

action = getLiveMatches

apiKey = Your unique apiKey (freeAPIKey for test)

justInPlay = Flag to hide 'Not Started' matches (usage &justInPlay=true)

Request Example

http://www.apisoccer.com/api/Soccer/getLiveMatches?apiKey=freeAPIKey

Response JSON

Test this Call

Lineups for Matches

Get the lineup by matchID

HTTP GET apisoccer.com/api/Soccer/getLineupByMatchID

Method Parameters

action = getLineupByMatchID

apiKey = Your unique apiKey (freeAPIKey for test)

matchID = The match ID (Tottenham Hotspur x Liverpool Example)

Request Example

http://www.apisoccer.com/api/Soccer/getLineupByMatchID?apiKey=freeAPIKey&matchID=F30AC3

Response JSON

Test this Call

Teams Coverage

Get list of all teams from API

HTTP GET apisoccer.com/api/Soccer/getAllTeams

Method Parameters

action = getAllTeams

apiKey = Your unique apiKey (freeAPIKey for test)

Request Example

http://www.apisoccer.com/api/Soccer/getAllTeams?apiKey=freeAPIKey

Response JSON

Test this Call

Leagues Coverage

Get list of all leagues from API

HTTP GET apisoccer.com/api/Soccer/getAllLeagues

Method Parameters

action = getAllLeagues

apiKey = Your unique apiKey (freeAPIKey for test)

Request Example

http://www.apisoccer.com/api/Soccer/getAllLeagues?apiKey=freeAPIKey

Response JSON

Test this Call

Countries Coverage

Get list of all countries from API

HTTP GET apisoccer.com/api/Soccer/getAllCountries

Method Parameters

action = getAllCountries

apiKey = Your unique apiKey (freeAPIKey for test)

Request Example

http://www.apisoccer.com/api/Soccer/getAllCountries?apiKey=freeAPIKey

Response JSON

Test this Call

League Standings

Get standings for the league

HTTP GET apisoccer.com/api/Soccer/getStandingsByLeagueID

Method Parameters

action = getStandingsByLeagueID

apiKey = Your unique apiKey (freeAPIKey for test)

leagueID = The league ID (England Premier League Example)

Request Example

http://www.apisoccer.com/api/Soccer/getStandingsByLeagueID?apiKey=freeAPIKey&leagueID=42719

Response JSON

Test this Call

Upcoming Matches

Get list of upcoming matches from API (Next 10 Days)

HTTP GET apisoccer.com/api/Soccer/getUpcomingMatches

Method Parameters

action = getUpcomingMatches

apiKey = Your unique apiKey (freeAPIKey for test)

Request Example

http://www.apisoccer.com/api/Soccer/getUpcomingMatches?apiKey=freeAPIKey

Response JSON

Test this Call

Matches For Home Win Soccer

Get a system predictions with all favorites home teams to win

HTTP GET apisoccer.com/api/Soccer/getMatchesForHomeWin

Method Parameters

action = getMatchesForHomeWin

apiKey = Your unique apiKey (freeAPIKey for Example)

Request Example

http://www.apisoccer.com/api/Soccer/getMatchesForHomeWin?apiKey=freeAPIKey

Response JSON

Test this Call

Matches For Over

Get a system predictions with all matches that average gols is high

HTTP GET apisoccer.com/api/Soccer/getMatchesForOver

Method Parameters

action = getMatchesForOver

apiKey = Your unique apiKey (freeAPIKey for Example)

Request Example

http://www.apisoccer.com/api/Soccer/getMatchesForOver?apiKey=freeAPIKey

Response JSON

Test this Call

Matches For Accumulator Bet

Get a system predictions for accumulator bets

HTTP GET apisoccer.com/api/Soccer/getMatchesForAccumulator

Method Parameters

action = getMatchesForAccumulator

apiKey = Your unique apiKey (freeAPIKey for Example)

Request Example

http://www.apisoccer.com/api/Soccer/getMatchesForAccumulator?apiKey=freeAPIKey

Response JSON

Test this Call

Check APIKey

Verify the details of your APIKey

HTTP GET apisoccer.com/api/Soccer/checkAPIKey

Method Parameters

action = checkAPIKey

apiKey = Your unique apiKey (freeAPIKey for Example)

Request Example

http://www.apisoccer.com/api/Soccer/checkAPIKey?apiKey=freeAPIKey

Response JSON

Test this Call

Odds by Match ID

Get odds match by match ID

HTTP GET apisoccer.com/api/Soccer/getOddsByMatchID

Method Parameters

action = getOddsByMatchID

apiKey = Your unique apiKey (freeAPIKey for Example)

matchID = The match ID (Tottenham Hotspur x Liverpool Example)

Request Example

http://www.apisoccer.com/api/Soccer/getOddsByMatchID?apiKey=freeAPIKey&matchID=10B871D

Response JSON

Test this Call

Livescore Matches Include Odds

Get list of all livematches with odds from API

HTTP GET apisoccer.com/api/Soccer/getLiveMatchesWithOdds

Method Parameters

action = getLiveMatchesWithOdds

apiKey = Your unique apiKey (freeAPIKey for test)

justInPlay = Flag to hide 'Not Started' matches (usage &justInPlay=true)

Request Example

http://www.apisoccer.com/api/Soccer/getLiveMatchesWithOdds?apiKey=freeAPIKey

Response JSON

Test this Call

Fixtures Season For League

Get all fixtures matches for leagueID

HTTP GET apisoccer.com/api/Soccer/getFixturesSeasonByLeagueID

Method Parameters

action = getFixturesSeasonByLeagueID

apiKey = Your unique apiKey (freeAPIKey for test)

leagueID = The league ID (England Premier League Example)

Request Example

http://www.apisoccer.com/api/Soccer/getFixturesSeasonByLeagueID?apiKey=freeAPIKey&leagueID=42719

Response JSON

Test this Call

Leagues Complete Coverage

Get list of all leagues with all features coverage from API

HTTP GET apisoccer.com/api/Soccer/getCompleteCoverageLeagues

Method Parameters

action = getCompleteCoverageLeagues

apiKey = Your unique apiKey (freeAPIKey for test)

Request Example

http://www.apisoccer.com/api/Soccer/getCompleteCoverageLeagues?apiKey=freeAPIKey

Response JSON

Test this Call

Leagues by Country ID

Get all leagues with this countryID

HTTP GET apisoccer.com/api/Soccer/getLeaguesByCountryID

Method Parameters

action = getLeaguesByCountryID

apiKey = Your unique apiKey (freeAPIKey for test)

countryID = The country ID (England Example)

Request Example

http://www.apisoccer.com/api/Soccer/getLeaguesByCountryID?apiKey=freeAPIKey&countryID=426F9

Response JSON

Test this Call

Get All Top Scorers

Get list of all top scorers players

HTTP GET apisoccer.com/api/Soccer/getAllTopScorers

Method Parameters

action = getAllTopScorers

apiKey = Your unique apiKey (freeAPIKey for test)

Request Example

http://www.apisoccer.com/api/Soccer/getAllTopScorers?apiKey=freeAPIKey

Response JSON

Test this Call

Get Top Scorers By League

Get list of all top scorers players by leagueID

HTTP GET apisoccer.com/api/Soccer/getTopScorersByLeagueID

Method Parameters

action = getUpcomingMatchesByLeagueID

apiKey = Your unique apiKey (freeAPIKey for test)

leagueID = The league ID (England Premier League Example)

Request Example

http://www.apisoccer.com/api/Soccer/getTopScorersByLeagueID?apiKey=freeAPIKey&leagueID=42719

Response JSON

Test this Call

Matches with Favorite Baseball Team

Get a system predictions with all favorites teams to win (Baseball)

HTTP GET apisoccer.com/api/Soccer/getMatchesBasebolFavorites

Method Parameters

action = getMatchesBasebolFavorites

apiKey = Your unique apiKey (freeAPIKey for Example)

Request Example

http://www.apisoccer.com/api/Soccer/getMatchesBasebolFavorites?apiKey=freeAPIKey

Response JSON

Test this Call

Top Matches with Favorite Soccer Home Team

GGet a system predictions with all favorites home teams to win (Premium Tips)

HTTP GET apisoccer.com/api/Soccer/getTopMatchesForHomeWin

Method Parameters

action = getTopMatchesForHomeWin

apiKey = Your unique apiKey (freeAPIKey for Example)

Request Example

http://www.apisoccer.com/api/Soccer/getTopMatchesForHomeWin?apiKey=freeAPIKey

Response JSON

Test this Call

Upcoming Matches by Date Interval and League ID

Get all matches between two dates with leagueID (Optional)

HTTP GET apisoccer.com/api/Soccer/getMatchesByDateInterval

Method Parameters

action = getUpcomingMatchesByDateInterval

apiKey = Your unique apiKey (freeAPIKey for Example)

dateFrom = Date From Return (Format Example yyyy-MM-dd)

dateTo = Date To Return (Format Example yyyy-MM-dd)

leagueID = The league ID (England Premier League Example) - Its Optional Parameter

Request Example

http://www.apisoccer.com/api/Soccer/getUpcomingMatchesByDateInterval?apiKey=freeAPIKey&dateFrom=2018-08-18&dateTo=2018-08-19

http://www.apisoccer.com/api/Soccer/getUpcomingMatchesByDateInterval?apiKey=freeAPIKey&dateFrom=2018-08-18&dateTo=2018-08-19&leagueID=42719

Response JSON

Test this Call

Upcoming Matches by League ID

Get list of upcoming matches from API (Next 10 Days) by league ID

HTTP GET apisoccer.com/api/Soccer/getUpcomingMatchesByLeagueID

Method Parameters

action = getUpcomingMatchesByLeagueID

apiKey = Your unique apiKey (freeAPIKey for test)

leagueID = The league ID (England Premier League Example)

Request Example

http://www.apisoccer.com/api/Soccer/getUpcomingMatchesByLeagueID?apiKey=freeAPIKey&leagueID=42719

Response JSON

Test this Call

Upcoming Matches by Team ID

Get list of upcoming matches from API (Next 10 Days) by team ID

HTTP GET apisoccer.com/api/Soccer/getUpcomingMatchesByTeamID

Method Parameters

action = getUpcomingMatchesByTeamID

apiKey = Your unique apiKey (freeAPIKey for Example)

teamID = The team ID (Manchester United Example)

Request Example

http://www.apisoccer.com/api/Soccer/getUpcomingMatchesByTeamID?apiKey=freeAPIKey&teamID=4273D

Response JSON

Test this Call

Match by Match ID

Get a single match by match ID

HTTP GET apisoccer.com/api/Soccer/getMatchByID

Method Parameters

action = getMatchByID

apiKey = Your unique apiKey (freeAPIKey for Example)

matchID = The match ID (Bayern München x Manchester City Example)

Request Example

http://www.apisoccer.com/api/Soccer/getMatchByID?apiKey=freeAPIKey&matchID=F26389

Response JSON

Test this Call

Matches by Team ID

Get last 10 matches from team ID

HTTP GET apisoccer.com/api/Soccer/getMatchesByTeamID

Method Parameters

action = getMatchesByTeamID

apiKey = Your unique apiKey (freeAPIKey for Example)

teamID = The team ID (Manchester United Example)

Request Example

http://www.apisoccer.com/api/Soccer/getMatchesByTeamID?apiKey=freeAPIKey&teamID=4273D

Response JSON

Test this Call

Matches by League ID

Get last 20 matches from league ID

HTTP GET apisoccer.com/api/Soccer/getMatchesByLeagueID

Method Parameters

action = getMatchesByLeagueID

apiKey = Your unique apiKey (freeAPIKey for Example)

leagueID = The league ID (England Premier League Example)

Request Example

http://www.apisoccer.com/api/Soccer/getMatchesByLeagueID?apiKey=freeAPIKey&leagueID=42719

Response JSON

Test this Call

Matches by Date Interval

Get all matches between two dates (Max 10 days)

HTTP GET apisoccer.com/api/Soccer/getMatchesByDateInterval

Method Parameters

action = getMatchesByDateInterval

apiKey = Your unique apiKey (freeAPIKey for Example)

dateFrom = Date From Return (Format Example yyyy-MM-dd)

dateTo = Date To Return (Format Example yyyy-MM-dd)

Request Example

http://www.apisoccer.com/api/Soccer/getMatchesByDateInterval?apiKey=freeAPIKey&dateFrom=2018-01-01&dateTo=2018-01-10

Response JSON

Test this Call

Matches by Date Interval And Team ID

Get all matches between two dates and specific team(Max 30 days)

HTTP GET apisoccer.com/api/Soccer/getMatchesByDateIntervalAndTeamID

Method Parameters

action = getMatchesByDateIntervalAndTeamID

apiKey = Your unique apiKey (freeAPIKey for Example)

dateFrom = Date From Return (Format Example yyyy-MM-dd)

dateTo = Date To Return (Format Example yyyy-MM-dd)

teamID = The team ID (Manchester United Example)

Request Example

http://www.apisoccer.com/api/Soccer/getMatchesByDateIntervalAndTeamID?apiKey=freeAPIKey&dateFrom=2018-01-01&dateTo=2018-01-10&teamID=4273D

Response JSON

Test this Call

Matches by Date Interval And League ID

Get all matches between two dates and specific league (Max 30 days)

HTTP GET apisoccer.com/api/Soccer/getMatchesByDateIntervalAndLeagueID

Method Parameters

action = getMatchesByDateInterval

apiKey = Your unique apiKey (freeAPIKey for Example)

dateFrom = Date From Return (Format Example yyyy-MM-dd)

dateTo = Date To Return (Format Example yyyy-MM-dd)

leagueID = The league ID (England Premier League Example)

Request Example

http://www.apisoccer.com/api/Soccer/getMatchesByDateIntervalAndLeagueID?apiKey=freeAPIKey&dateFrom=2018-01-01&dateTo=2018-01-10&leagueID=42719

Response JSON

Test this Call