Introduction

API : Soccers' API
API Version : v2.2
API Contents : Football

Soccer's API is a RESTful service for real time soccer data. It is a PAID service with low price (starting from 39€ per month). Note that in order to access Soccer's API you must purchase related packages or apply for our free plan. If you want a custom plan please contact us.

Setup the API

After subscribe, login and go to https://soccersapi.com/dashboard/api-key Generate a {{TOKEN}} in your user Dashboard Take your {{USERNAME}} and your {{TOKEN}} Now you're ready to make calls to the API

After subscribe, login and go to https://soccersapi.com/dashboard/api-key
Generate a TOKEN in your user Dashboard
Take your USERNAME and your TOKEN
Now you're ready to make calls to the API

Authentication

API BASE URL

All API endpoints are relative to the base URL

 https://api.soccersapi.com/v2.2/

This a single API Endpoint URL without parameteres:

https://api.soccersapi.com/v2.2/countries/

This an API Endpoint URL with Query Parameters:

https://api.soccersapi.com/v2.2/countries/?user={{USERNAME}}&token={{TOKEN}}&t=list

(Make sure replace {{USERNAME}} and {{TOKEN}} values with yours.)

Statuses

Check the following table to know what status number means.
Status Name Description
0 Not Started The event is not started
1 Inplay The event is inplay
11 Half-time The event is in half-time.
12 Extra-time The event is in extra time.
13 Penalties The event is in penalties because extra time didn't determinate a winner.
14 Break-time Event is in break waiting for extra time or penalties.
15 Awarding Awarding of a victory to a contestant because there are no other contestants.
2 Update later Event will be updated later.
3 Ended Event has ended after 90 minutes.
31 After penalties Event has ended after penalty shootout.
32 After Extra-time The event has finished after extra time.
4 Postponed The event has been Postponed.
5 Cancelled The event has been Cancelled.
6 Abandoned The event has abandoned and will continue at a later time or day.
7 interrupted The event has been interrupted. Can be due to bad weather for example.
8 Suspended The event has been suspended.
9 Awarded Winner is beeing decided externally.
10 Delayed The event is delayed.
17 To be announced The event has not been verified yet.

Images

You can get images in four different sizes based on pixels

Leagues

100x100

Austria Tipico Bundesliga

80x80

Austria Tipico Bundesliga

50x50

Austria Tipico Bundesliga

18x18

Austria Tipico Bundesliga

Teams

100x100

FC Salzburg

80x80

FC Salzburg

50x50

FC Salzburg

18x18

FC Salzburg

Players

100x100

Andreas Ulmer

80x80

Andreas Ulmer

50x50

Andreas Ulmer

18x18

Andreas Ulmer

TV Channels

100x100

Andreas Ulmer

80x80

Andreas Ulmer

50x50

Andreas Ulmer

18x18

Andreas Ulmer

Coaches

100x100

Soon!

80x80

Soon!

50x50

Soon!

18x18

Soon!

Referees

100x100

Soon!

80x80

Soon!

50x50

Soon!

18x18

Soon!

Bookmakers

Default

bet365

Big

Soon!

Medium

Soon!

Small

Soon!

Venues

Default

Red Bull Arena

Changelog

Soccer's API Version 2.2

## [2.2] - 21/04/2021
Added
- Fixtures by TV Channel (2 weeks forecast) #fixtures_tv_channel

## [2.2] - 25/03/2021
Added
- Improvement on standings request #Standings. Were added a field called "number_standings". If is more than 1, is an array with special leagues that have more than 1 standings information and each are tagged in group_name. It happen for example in Indian I-League.

## [2.2] - 25/03/2021
Added
- Added new dataset "info" in all fixtures from today. If there're information about match for example 'Decision by Federation' you'll find in there.

## [2.2] - 18/03/2021
Added
- Added new dataset include "Match Events" in #Livescores, #Fixtures, #MatchById, #MatchByMultipleID. #Includes

## [2.2] - 18/03/2021
Added
- Added new dataset include "Match Stats" in #Livescores, #Fixtures, #MatchById, #MatchByMultipleID. #Includes

## [2.2] - 17/03/2021
Added
- Added includes feature in #MatchByMultipleID endpoint #Includes

## [2.2] - 16/03/2021
Added
- Added includes feature in #MatchByID endpoint #Includes

## [2.2] - 16/03/2021
Added
- Added includes feature in #livescores endpoints #Includes

## [2.2] - 15/03/2021
Added
- Filter by status_id on #Fixtures_by_season

## [2.2] - 03/03/2021
Added
- Added includes feature in fixtures endpoints #Includes

## [2.2] - 26/02/2021
Added
- Added endpoint Leagues by Multiple ID #leagues_multiple_id

## [2.2] - 18/02/2021
Changed
- Match lineups will show formations without stats of every player in order to avoid delays in this endpoint. If you need to know stats of every player you can add this code in request &include=stats #match_lineups

## [2.2] - 28/01/2021
Beta
- Added API Translations to Arabic, Greek and Italian. #language

## [2.2] - 20/01/2021
Added
- Added market_value parameter in player's info.

## [2.2] - 11/01/2021
Added
- Added endpoint for check all groups by season id.

## [2.2] - 30/12/2020
Added
- Added teams and league images in all H2H endpoints.

## [2.2] - 26/12/2020
Added
- UTC parameter enabled in Fixtures and Livescores endpoint, by adding &utc=4 or &utc=4.5 at the end of your request to get rensponse in your correct timezone.

## [2.2] - 22/12/2020
Added
- Timestamp parameter in match events from today

## [2.2] - 21/12/2020
Fixed
- Endpoint Season Stats > goal_line has been recalculated.

## [2.2] - 18/12/2020
Added
- New Endpoint Player Stats by Match ID #player_stats_match

## [2.2] - 18/12/2020
Added
- New Endpoint Cup Draw (Tournament Bracket) #cup_draw

## [2.2] - 17/12/2020
Added
- New Endpoint TV Channel by ID #tv_info

## [2.2] - 15/12/2020
Added
- TV Channels images in 4 differents sizes (100,80,50,18)

## [2.2] - 15/12/2020
###Update
- Venue images in png and added our current image px formats (100,80,50,18)

## [2.2] - 14/12/2020
Added
- New Endpoint added Fixtures Next & Last

## [2.2] - 11/12/2020
Added
In Player by ID Endpoint:
- Seasons of the leagues where specific player have participated.
- Roles and on which teams have played.

## [2.2] - 10/12/2020
Added
In Team by ID Endpoint:
- Seasons of the leagues where specific team have participated.
- Added more fields in array leagues on Teams by ID Endpoint.

## [2.2] - 06/12/2020
Added
- Basic Stats of players in Match Lineups endpoint

## [2.2] - 05/12/2020
Added
- Aggregate_id in fixtures endpoints and Match by ID endpoint
- Country_code in fixtures endpoints and Match by ID endpoint

## [2.2] - 02/12/2020
Added
- Historical data up to 10 years

## [2.2] - 30/09/2020
Fixed
- Fixtures endpoints datetime value to UTC

## [2.2] - 30/09/2020
Added
- Endpoint Match Sidelined

## [2.2] - 30/09/2020
Added
- Endpoint Match by Multiple IDs

## [2.2] - 29/09/2020
Added
- Team Kit colors on Fixtures Endpoints

## [2.2] - 12/09/2020
Added
- Endpoint Teams National

## [2.2] - 07/09/2020
Added
- Endpoint Search by Keyword

## [2.2] - 04/09/2020
Added
- Endpoint Stages by Season

## [2.2] - 03/09/2020
Added
- Endpoint Stage by ID

## [2.2] - 27/08/2020
Added
- Endpoint Group by ID

## [2.2] - 06/08/2020
Added
- Team Kit Colors (Team by ID Endpoint)

## [2.2] - 06/08/2020
Added
- Coverage info (Fixtures, Match by ID Endpoints)

## [2.2] - 03/08/2020
Added
- Endpoint TV Schedule by Date (on Broadcast & TV section)

## [2.2] - 18/06/2020
Added
- Endpoint H2H Team vs Team

## [2.2] - 17/06/2020
Added
- Endpoint All Continents
- Endpoint Continent by ID
- Order ASC / DESC in Fixtures by Season Endpoint

## [2.2] - 14/06/2020
Added
- Logos +800 leagues

## [2.2] - 06/06/2020
Added
- Endpoint Team Transfers
- Endpoint Match H2H

## [2.2] - 03/06/2020
Added
- Endpoint Match Odds by Bookmaker

## [2.2] - 25/05/2020
Added
- Team Kit colors
- Endpoint Team Trophies

Timezone

Getting data in a different timezone

You can get match datetime and fixtures in a different timezone just adding &utc={{TIMEZONE}} append to fixtures and livescores endpoints.

  • Get fixtures in UTC +3.5: https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=schedule&d=2020-12-29&utc=3.5
  • Get fixtures in UTC -3.5: https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=schedule&d=2020-12-29&utc=-3.5

With UTC parameter enabled, endpoints may return different fixtures depending the match starting time and the selected timezone. For example if some match is scheduled at 23:00h 2020-12-29 UTC then by adding UTC + 2 the same match will start at 01:00h 2020-12-30.

Language (BETA)

Get data in other languages

Language is a BETA feature and there may be errors
Now you can get data in a different language just adding &lang={{LANG}} append to endpoints URL.







Parameter Value Language
lang AR Arabic
lang GR Greec
lang IT Italian

Includes

Include extra datasets to existing endpoints.
Endpoint Includes Description
#Fixtures &include=events,odds_prematch,odds_inplay,match_stats Match events summary, Bookmakers Match pre-match odds, Bookmakers Match in-play odds, Teams Match Stats
#Livescores &include=events,odds_prematch,odds_inplay,match_stats Match events summary, Bookmakers Match pre-match odds, Bookmakers Match in-play odds, Teams Match Stats
#MatchByID &include=events,odds_prematch,odds_inplay,match_stats Match events summary, Bookmakers Match pre-match odds, Bookmakers Match in-play odds, Teams Match Stats
#MatchByMultipleID &include=events,odds_prematch,odds_inplay,match_stats Match events summary, Bookmakers Match pre-match odds, Bookmakers Match in-play odds, Teams Match Stats
#MatchLineups &include=stats Match player stats

Search by String

GETAll, Continents, Countries, Leagues, Teams, Players, Referees

API Reference
The Search endpoint gives you a list of items by keyword (minimum 3 letters) and it allows filter by type (all, continent, country, league, team, player, referee).

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringall
qstring{{QUERY}}

Response

Test Endpoint

All Continents

GETAll Continents

API Reference
The Continents endpoint gives you a list of all Continents.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist

Response

Test Endpoint

Continent by ID

GETContinent By Id

API Reference
The Get Continent By ID Endpoint gives you data from a specific continent like its name and ID. It's useful for ordering and structuring navigation by countries and for classify leagues, teams, players...

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idstring{{CONTINENT_ID}}

Response

Test Endpoint

All Countries

GETAll Countries

API Reference
The All Countries endpoint gives you a list of all Countries and data like its Name, Flag, IsoCode, Continent and other related Country data.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist
pageinteger{{PAGE}}

Response

Test Endpoint

Country by ID

GETCountry By Id

API Reference
The Get Country By Id Endpoint gives you data from a specific country like Name, Flag, IsoCode, Continent and other related Country data.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{COUNTRY_ID}}

Response

Test Endpoint

All Leagues

GETAll Leagues

API Reference
The Get All Leagues Endpoint gives you a paginated list of all leagues available in your plan.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist
pageinteger{{PAGE}}

Response

Test Endpoint

All Leagues by Country ID

GETAll Leagues by country ID

API Reference
The Get All Leagues Endpoint gives you all leagues of a specific country

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist
country_idinteger{{COUNTRY_ID}}

Response

Test Endpoint

League by ID

GETLeague by ID

API Reference
The Get League by ID Endpoint gives you data from a specific League / tournament.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{LEAGUE_ID}}

Response

Test Endpoint

League Standings

GETLeague Standings by Season ID

API Reference
The Standings Endpoint show the rank of the teams of each League in which they are participating. The response of the Standings Endpoint can be returned in two formats.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringstandings
season_idinteger{{SEASON_ID}}

Response

Test Endpoint

Cup Draw (Tournament Bracket)

GETCup Draw (Tournament Bracket) by season ID and Stage ID

API Reference
The Cup Draw (Tournament Bracket) Endpoint allow you to represent a tournament bracket as a tree diagram that represents the series of games played during a knockout tournament. You can filter (optional) by Stage ID.

URI Parameters

userString{{USERNAME}}
tokenString{{TOKEN}}
tStringcup_draw
season_idinteger{{SEASON_ID}}
stage_idinteger{{STAGE_ID}}

Response

Test Endpoint

Leagues by Multiple ID

GETLeagues by Multiple ID

API Reference
The Get League by multiple ID Endpoint return multiple leagues in a single call

URI Parameters

userString{{USERNAME}}
tokenString{{TOKEN}}
tStringsort
idsinteger{{LEAGUE_ID}}

Response

Test Endpoint

Season by ID

GETSeason By ID

API Reference
The Season by ID Endpoint gives you info about a specific Season, like their league, their year, stages, rounds.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{SEASON_ID}}

Response

Test Endpoint

Stage by ID

GETStage By ID

API Reference
The Stage by ID Endpoint gives you info about a specific Stage.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{STAGE_ID}}

Response

Test Endpoint

Stages by Season

GETStages by Season ID

API Reference
The Stages by Season Endpoint returns the stages available for a specific season

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringbyseason
season_idinteger{{SEASON_ID}}

Response

Test Endpoint

Group by ID

GETGroup By ID

API Reference
The Group by ID Endpoint give you information of a specific Group

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{GROUP_ID}}

Response

Test Endpoint

Groups by Season

GETGroups by Season

API Reference
The Groups by Season returns groups availables in a season
If stages aren't group stages then groups may be only for specification purpose

URI Parameters

userString{{USERNAME}}
tokenString{{TOKEN}}
tStringbyseason
season_idinteger{{SEASON_ID}}

Response

Test Endpoint

Rounds by Season

GETRounds by Season ID

API Reference
The Rounds by Season ID endpoint returns a list of Rounds of a single season

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringbyseason
season_idinteger{{SEASON_ID}}

Response

Test Endpoint

Round by ID

GETRound By ID

API Reference
The Round by ID endpoint returns information of a single round

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{ROUND_ID}}

Response

Test Endpoint

Teams by Country

GETTeams by Country ID

API Reference
The Teams by Country ID endpoint returns a list of teams from a specific country

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist
country_idinteger{{COUNTRY_ID}}

Response

Test Endpoint

Teams by Season

GETTeams by Season ID

API Reference
The Teams by Season ID endpoint returns a list of teams participants on a single season

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringbyseason
season_idinteger{{SEASON_ID}}

Response

Test Endpoint

Teams National

GETNational Teams

API Reference
The Teams National endpoint returns a list of national soccer teams

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringnational

Response

Test Endpoint

Team by ID

GETTeam By Id

API Reference
The Team Info endpoint gives you data of a specific team.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{TEAM_ID}}

Response

Test Endpoint

Team Squad

GETSquad by Team ID

API Reference
The Team Squad endpoint gives you all players of a specific team of the current season.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringsquad
idinteger{{TEAM_ID}}

Response

Test Endpoint

Team Squad by Season

GETSquad By Team Id ans Season ID

API Reference
The Team Squad current season endpoint gives you all players of a specific team from a specific season.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringsquad
idinteger{{TEAM_ID}}
season_idinteger{{SEASON_ID}}

Response

Test Endpoint

Team Transfers

GETTransfers By Team Id

API Reference
The Team Transfers endpoint returns the transfers (IN, OUT) of a specific team

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtransfers
idinteger{{TEAM_ID}}

Response

Test Endpoint

Team Sidelined

GETSidelined By Team ID

API Reference
The Team Sidelined endpoint return data about injured or missing players.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringsidelined
idinteger{{TEAM_ID}}

Response

Test Endpoint

Team Trophies

GETTrophies By Team Id

API Reference
The Team Trophies endpoint returns data about how many and which trophies has won the specified team along his history.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtrophies
idinteger{{TEAM_ID}}

Response

Test Endpoint

Livescores Today

GETToday Matches

API Reference
The Livescores today Endpoint gives you a list of matches will play today. (From the leagues available in your plan)

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtoday

Response

Test Endpoint

Livescores Tomorrow

GETTomorrow Matches

API Reference
The Livescores Tomorrow Endpoint gives you a list of matches will play tomorrow. (From the leagues available in your plan)

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtomorrow

Response

Test Endpoint

Livescores Yesterday

GETYesterday Matches

API Reference
The Livescores Yesterday Endpoint gives you a list of matches has play yesterday. (From the leagues available in your plan)

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringyesterday

Response

Test Endpoint

Livescores Inplay

GETInplay Matches

API Reference
The Livescores Inplay Endpoint gives you a list of matches playing now. (From the leagues available in your plan)

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlive

Response

Test Endpoint

Livescores Not Started

GETNot Started Matches

API Reference
The Livescores Not Started Endpoint gives you a list of matches will play today and haven't started yet. (From the leagues available in your plan)

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringnotstarted

Response

Test Endpoint

Livescores Ended

GETEnded Matches

API Reference
The Livescores Ended Endpoint gives you a list of matches will play today and has ended. (From the leagues available in your plan)

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringended

Response

Test Endpoint

Fixtures by Date

GETFixtures By date

API Reference
The Fixtures by Date Endpoint gives you fixtures from a specific date. Now you can use #Includes

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringschedule
ddate{{YYYY-MM-DD}}
pageinteger{{PAGE}}

Response

Test Endpoint

Fixtures by Date / Country

GETFixtures By Date and Country ID

API Reference
The Fixtures by Date / Country Endpoint fixtures from a single country on a specific date

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringschedule
ddate{{YYYY-MM-DD}}
country_idinteger{{COUNTRY_ID}}

Response

Test Endpoint

Fixtures by Date / League (Current Season)

GETFixtures by Date and League ID

API Reference
The Fixtures by Date / League Endpoint return fixtures of the current season from a single league and specific date

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringschedule
ddate{{YYYY-MM-DD}}
league_idinteger{{LEAGUE_ID}}

Response

Test Endpoint

Fixtures by Date / Season

GETFixtures By Date and Season ID

API Reference
The Fixtures by Date / Season Endpoint gives you fixtures from a single season on a specific date

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringseason
ddate{{YYYY-MM-DD}}
idinteger{{SEASON_ID}}

Response

Test Endpoint

Fixtures by Date / Season / Stage

GETFixtures by Date, Season ID and Stage ID

API Reference
The Fixtures by Date / Season / Stage Endpoint gives you fixtures from a single season stage on a specific date

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringstages
ddate{{YYYY-MM-DD}}
season_idinteger{{SEASON_ID}}
stage_idinteger{{STAGE_ID}}
orderstring{{ORDER}}

Response

Test Endpoint

Fixtures by Season / Stage

GETFixtures By Season ID and Stage ID

API Reference
The Fixtures by Season / Stage Endpoint gives you fixtures from a single season stage

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringstage
season_idinteger{{SEASON_ID}}
stage_idinteger{{STAGE_ID}}
orderstring{{ORDER}}

Response

Test Endpoint

Fixtures by Date / Season / Group

GETFixtures by Date, Season ID and Group ID

API Reference
The Fixtures by Date / Season / Group Endpoint gives you fixtures from a single Group on a specific date

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringschedule
ddate{{YYYY-MM-DD}}
season_idinteger{{SEASON_ID}}
group_idinteger{{GROUP_ID}}

Response

Test Endpoint

Fixtures by Date / Round

GETFixtures by Date and Round ID

API Reference
The Fixtures by Date / Round Endpoint gives you fixtures from a single round on a specific date

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringrounds
ddateYYYY-MM-DD
idinteger{{ROUND_ID}}

Response

Test Endpoint

Fixtures by Season

GETFixtures By Season ID

API Reference
The Fixtures Season Endpoint gives you fixtures from a specific Season by ID.
Now you can filter by "status_id" by passing the parameter &status_id={{STATUS_ID}}

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringseason
season_idinteger{{SEASON_ID}}
orderstring{{ORDER}}
status_idinteger{{STATUS_ID}}

Response

Test Endpoint

Fixtures by Season / Team

GETFixtures By Season ID and Team ID

API Reference
The Fixtures Season Endpoint gives you fixtures from a specific Season by ID and Team ID

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringseason
season_idinteger{{SEASON_ID}}
team_idinteger{{TEAM_ID}}
orderstring{{ORDER}}

Response

Test Endpoint

Fixtures by Season / Group

GETFixtures By Season ID and Group

API Reference
The Fixtures by Season / Group Endpoint gives you fixtures from a single Group

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringstage
season_idinteger{{SEASON_ID}}
group_idinteger{{GROUP_ID}}
orderstring{{ORDER}}

Response

Test Endpoint

Fixtures by Season / Group / Team

GETFixtures By Season ID, Group and Team ID

API Reference
The Fixtures by Season / Group / Team Endpoint gives you fixtures from a single Team from a specific Group

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringstage
season_idinteger{{SEASON_ID}}
group_idinteger{{GROUP_ID}}
orderstring{{ORDER}}

Response

Test Endpoint

Fixtures by Season / Stage / Team

GETFixtures by Season ID, Stage ID and Team ID

API Reference
The Fixtures by Stage Endpoint gives you fixtures from a single stage and Team

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringstage
season_idinteger{{SEASON_ID}}
stage_idinteger{{STAGE_ID}}
team_idinteger{{TEAM_ID}}
orderstring{{ORDER}}

Response

Test Endpoint

Fixtures by Round

GETFixtures By Round ID

API Reference
The Fixtures by Round Endpoint gives you fixtures from a single round

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringround
round_idinteger{{ROUND_ID}}

Response

Test Endpoint

Fixtures by Round / Team

GETFixtures By Round ID and Team ID

API Reference
The Fixtures by Round Endpoint gives you fixtures from a single round and Team

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringround
round_idinteger{{ROUND_ID}}
team_idinteger{{TEAM_ID}}

Response

Test Endpoint

Fixtures by Team Next & Last

GETFixtures by Team ID Last and Next Matches

API Reference
The Fixtures by Team Next & Last Endpoint returns 25 last matches and 25 next matches from a single team.

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenString{{TOKEN}}
tStringlast_next
team_idinteger{{TEAM_ID}}

Response

Test Endpoint

Fixtures by TV Channel

GETFixtures by TV Channel ID

API Reference
The Fixtures by TV Channel Endpoint gives you next 2 weeks fixtures from a specific TV Channel

URI Parameters

userString{{USERNAME}}
tokenString{{TOKEN}}
tStringtv
tv_idinteger{{TV_ID}}

Response

Test Endpoint

Match by ID

GETMatch By ID

API Reference
The Match by ID Endpoint gives you information from a specific match

You can use #Includes with this endpoint

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{MATCH_ID}}

Response

Test Endpoint

Match Commentary

GETMatch Commentary By Match ID

API Reference
The Match Commentary Endpoint gives you commentaries by Match ID

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_comments
idinteger{{MATCH_ID}}
orderstring{{ASC / DESC}}

Response

Test Endpoint

Match Events

GETMatch Events By Match ID

API Reference
The Match Events Endpoint gives the list ofevents / occurrences by Match ID

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_events
idstring{{MATCH_ID}}

Response

Test Endpoint

Match Lineups

GETLineups By Match ID

API Reference
The Lineups Endpoint gives you starting Lineups by Match ID. You can include player stats by adding the parameter "&include=stats".

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_lineups
idstring{{MATCH_ID}}
includeintegerstats

Response

Test Endpoint

Match Bench

GETBench By Match ID

API Reference
The Match Bench Endpoint gives you the bench of both teams

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_bench
idstring{{MATCH_ID}}

Response

Test Endpoint

Match by Multiple ID

GETMatches by Multiple Match IDs

API Reference
The Match by Multiple ID Endpoint allows you to get info from up to 15 matches by passing multiple IDs

You can use #Includes with this endpoint

URI Parameters

userstring{{USERNAME}}
tokenstring{{TOKEN}}
tstringsort
idsstring{{ID, ID, ID}}

Response

Test Endpoint

Match Sidelined

GETMatch Sidelined by Match ID

API Reference
The Match Sidelined endpoint give you information about missing players of both teams on a single match

URI Parameters

userstring{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_sidelined
idstring{{MATCH_ID}}

Response

Test Endpoint

Match Stats

GETMatch Statistics By Match ID

API Reference
The Match Stats endpoint gives you the statistics of a single event

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch
idinteger{{MATCH_ID}}

Response

Test Endpoint

League Stats

GETLeague Statistics by League ID (Current Season)

API Reference
This endpoint allows you to get league stats by ID. By default it will return the current Season of the league

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringleague
idinteger{{LEAGUE_ID}}

Response

Test Endpoint

Season Stats

GETSeason Statistics by Season ID

API Reference
This endpoint allows you to get Season stats by ID.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringseason
idinteger{{SEASON_ID}}

Response

Test Endpoint

Team Stats

GETTeam Statistics by Team ID and Season ID

API Reference
This endpoint allows you to get Team stats by Team ID and season ID.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringteam
idinteger{{TEAM_ID}}
season_idinteger{{SEASON_ID}}

Response

Test Endpoint

Player Stats / Season

GETPlayer Statistics by Player ID and Season ID

API Reference
The Player Stats Endpoint gives you singular player statistics by season ID

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringplayer
idinteger{{PLAYER_ID}}
season_idinteger{{SEASON_ID}}

Response

Test Endpoint

Player Stats by Match ID

GETPlayer Stats by Player ID and Match ID

API Reference
The Player Stats by Match returns player statistics from a specified player on a specified match

URI Parameters

userString{{USERNAME}}
tokenString{{TOKEN}}
tStringplayer
player_idinteger{{PLAYER_ID}}
match_idinteger{{MATCH_ID}}

Response

Test Endpoint

Match H2H

GETMatch Head to Head

API Reference
The Match H2H Endpoint returns the performance between both teams by Match ID. The Latest 10 matches overall as home and as away and between the both teams.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch
idstring{{MATCH_ID}}

Response

Test Endpoint

H2H Team vs Team

GETteam vs team Head to Head

API Reference
The H2H Team vs Team Endpoint compare the performance between 2 selected teams by ID. The Latest 10 matches overall as home and as away and between both teams.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch
team1int{{TEAM1_ID}}
team2int{{TEAM2_ID}}

Response

Test Endpoint

Topscorers (Leaders)

GETTopscorers By Season ID

API Reference
The Topscorers Endpoint gives you a list of players leaders in goals, assists and cards by season.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtopscorers
season_idinteger{{SEASON_ID}}

Response

Test Endpoint

Topassists (Leaders)

GETTopassists By Season ID

API Reference
The Topassists Endpoint gives you a list of players leaders by season.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtopassists
season_idinteger{{SEASON_ID}}

Response

Test Endpoint

Topcards (Leaders)

GETTopcards by Season ID

API Reference
The Topcards Endpoint gives you a list of players leaders in cards by season.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtopcards
season_idinteger{{SEASON_ID}}

Response

Test Endpoint

Bookmakers

GETBookmakers

API Reference
The Bookmakers Endpoint gives you a list of all Bookmakers available in your plan

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist

Response

Test Endpoint

Bookmaker by ID

GETBookmaker by ID

API Reference
The Bookmaker by ID Endpoint gives you information of a specific bookmaker by ID

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{BOOKMAKER_ID}}

Response

Test Endpoint

Markets

GETMarkets

API Reference
The Markets Endpoint gives a list of all available markets

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist

Response

Test Endpoint

Market by ID

GETMarket by ID

API Reference
The Market by ID Endpoint gives you information of a specific market

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{MARKET_ID}}

Response

Test Endpoint

Pre-Match Odds

GETPre-Match Odds

API Reference
The Pre-Match Odds Endpoint gives you Pre-match odds for a specific match

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_odds
idinteger{{MATCH_ID}}

Response

Test Endpoint

In-Play Odds

GETIn-Play Odds by Match ID

API Reference
The In-Play Odds Endpoint gives you Live odds while the match is playing

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_oddsinplay
idinteger{{MATCH_ID}}

Response

Test Endpoint

Match Odds by Bookmaker

GETMatch Odds by Bookmaker

API Reference
The Match Odds by Match ID and Bookmaker ID Endpoint returns all odds for a match in a more detailed way from a single bookmaker.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_odds_info
idinteger{{MATCH_ID}}
bookmaker_idinteger{{BOOKMAKER_ID}}

Response

Test Endpoint

Player by ID

GETplayer By ID

API Reference
The Player by ID endpoint returns information of a single player

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{PLAYER_ID}}

Response

Test Endpoint

Players by Country

GETplayer By ID

API Reference
The Players by Country ID Endpoint return all players from a specific country (Nationality)

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist
country_idinteger{{COUNTRY_ID}}

Response

Test Endpoint

Scheduled on TV by Date

GETScheduled on TV by Date

API Reference
The Scheduled on TV by Date Endpoint gives you a list of matches that will be or has been broadcasted on TV or Streaming. Note that to know related TV Channels you must to retrieve "Match TV Channels" for each respective Match ID.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_tvs
dstring{{YYYY-MM-DD}}

Response

Test Endpoint

Match TV Channels

GETTV Channels by Match ID

API Reference
The Match TV Channels Endpoint returns International TV Channels that will cover the specified match.

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_tvs
idinteger{{MATCH_ID}}

Response

Test Endpoint

TV Channel by ID

GETTV Channel info by ID

API Reference
The TV Channel by ID returns information of specified TV Channel

URI Parameters

userString{{USERNAME}}
tokenString{{TOKEN}}
tStringinfo
idinteger{{TV_CHANNEL_ID}}

Response

Test Endpoint

Coach by ID

GETcoaches By ID

API Reference
The Coach by ID Endpoint give you information of a specific coach

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{COACH_ID}}

Response

Test Endpoint

Venue by ID

GETVenue By ID

API Reference
The Venue by ID Endpoint give you information of a specific venue

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{VENUE_ID}}

Response

Test Endpoint

Referee by ID

GETReferee By ID

API Reference
The Referee by ID Endpoint give you information of a specific Referee

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{REFEREE_ID}}

Response

Test Endpoint