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.
Introduction
API Version : v2.2
API Contents : Football
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
Authentication
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
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
Leagues
100x100

80x80

50x50

18x18

Teams
100x100

80x80

50x50

18x18

Players
100x100

80x80

50x50

18x18

TV Channels
100x100

80x80

50x50

18x18

Coaches
100x100
Soon!80x80
Soon!50x50
Soon!18x18
Soon!Referees
100x100
Soon!80x80
Soon!50x50
Soon!18x18
Soon!Bookmakers
Default

Big
Soon!Medium
Soon!Small
Soon!Venues
Default

Changelog
## [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 reculculated
## [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
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.
Search by String
GETAll, Continents, Countries, Leagues, Teams, Players, Referees
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/search/?user={{USERNAME}}&token={{TOKEN}}&t=all&q={{QUERY}} | |
Endpoint | https://api.soccersapi.com/v2.2/search/?user=user1&token=Z5R9jArYsKZmHmP47&t=all&q=Germany | |
Paginated | Yes, 100 per page |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | all |
q | string | {{QUERY}} |
Response
Test Endpoint
All Continents
GETAll Continents
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/continents/?user={{USERNAME}}&token={{TOKEN}}&t=list | |
Endpoint | https://api.soccersapi.com/v2.2/continents/?user=user1&token=Z5R9jArYsKZmHmP47&t=list | |
Paginated | Yes, 100 leagues per page |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | list |
Response
Test Endpoint
Continent by ID
GETContinent By Id
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/continents/?user={{USERNAME}}&token={{TOKEN}}&t=info&id=2 | |
Endpoint | https://api.soccersapi.com/v2.2/continents/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id={{CONTINENT_ID}} | |
Paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | string | {{CONTINENT_ID}} |
Response
Test Endpoint
All Countries
GETAll Countries
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/countries/?user={{USERNAME}}&token={{TOKEN}}&t=list | |
Endpoint | https://api.soccersapi.com/v2.2/countries/?user=user1&token=Z5R9jArYsKZmHmP47&t=list | |
Paginated | Yes, 100 per page |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | list |
page | integer | {{PAGE}} |
Response
Test Endpoint
Country by ID
GETCountry By Id
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/countries/?user={{USERNAME}}&token={{TOKEN}}&t=info&id=4 | |
Endpoint | https://api.soccersapi.com/v2.2/countries/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id={{COUNTRY_ID}} | |
Paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{COUNTRY_ID}} |
Response
Test Endpoint
All Leagues
GETAll Leagues
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/leagues/?user={{USERNAME}}&token={{TOKEN}}&t=list | |
Endpoint | https://api.soccersapi.com/v2.2/leagues/?user=user1&token=Z5R9jArYsKZmHmP47&t=list | |
Paginated | Yes, 100 leagues per page |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | list |
page | integer | {{PAGE}} |
Response
Test Endpoint
All Leagues by Country ID
GETAll Leagues by country ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/leagues/?user={{USERNAME}}&token={{TOKEN}}&t=list&country_id={{COUNTRY_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/leagues/?user=user1&token=Z5R9jArYsKZmHmP47&t=list&country_id=4 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | list |
country_id | integer | {{COUNTRY_ID}} |
Response
Test Endpoint
League by ID
GETLeague by ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/leagues/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{LEAGUE_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/leagues/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=594 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{LEAGUE_ID}} |
Response
Test Endpoint
League Standings
GETLeague Standings by Season ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/leagues/?user={{USERNAME}}&token={{TOKEN}}&t=standings&season_id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/leagues/?user=user1&token=Z5R9jArYsKZmHmP47&t=standings&season_id=406 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | standings |
season_id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Cup Draw (Tournament Bracket)
GETCup Draw (Tournament Bracket) by season ID and Stage ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/leagues/?user={{USERNAME}}&token={{TOKEN}}&t=cup_draw&season_id=45&stage_id=26 | |
Endpoint | https://api.soccersapi.com/v2.2/leagues/?user=user1&token=Z5R9jArYsKZmHmP47&t=cup_draw&season_id=45&stage_id=26 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | String | {{TOKEN}} |
t | String | cup_draw |
season_id | integer | {{SEASON_ID}} |
stage_id | integer | {{STAGE_ID}} |
Response
Test Endpoint
Season by ID
GETSeason By ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/seasons/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/seasons/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=406 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Stage by ID
GETStage By ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/stages/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{STAGE_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/stages/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=1 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{STAGE_ID}} |
Response
Test Endpoint
Stages by Season
GETStages by Season ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/stages/?user={{USERNAME}}&token={{TOKEN}}&t=byseason&season_id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/broadcast/?user=user1&token=Z5R9jArYsKZmHmP47&t=byseason&season_id=2091 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | byseason |
season_id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Group by ID
GETGroup By ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/groups/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{GROUP_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/groups/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=5 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{GROUP_ID}} |
Response
Test Endpoint
Groups by Season
GETGroups by Season
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/groups/?user={{USERNAME}}&token={{TOKEN}}&t=byseason&season_id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/groups/?user=user1&token=Z5R9jArYsKZmHmP47&t=byseason&season_id=7011 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | String | {{TOKEN}} |
t | String | byseason |
season_id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Rounds by Season
GETRounds by Season ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/rounds/?user={{USERNAME}}&token={{TOKEN}}&t=byseason&season_id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/rounds/?user=user1&token=Z5R9jArYsKZmHmP47&t=byseason&season_id=406 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | byseason |
season_id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Round by ID
GETRound By ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/rounds/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{ROUND_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/rounds/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=2005 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{ROUND_ID}} |
Response
Test Endpoint
Teams by Country
GETTeams by Country ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/teams/?user={{USERNAME}}&token={{TOKEN}}&t=list&country_id={{COUNTRY_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=list&country_id=4 | |
Paginated | Yes, 100 per page |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | list |
country_id | integer | {{COUNTRY_ID}} |
Response
Test Endpoint
Teams by Season
GETTeams by Season ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/teams/?user={{USERNAME}}&token={{TOKEN}}&t=byseason&season_id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=byseason&season_id=406 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | byseason |
season_id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Teams National
GETNational Teams
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/teams/?user={{USERNAME}}&token={{TOKEN}}&t=national | |
Endpoint | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=national | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | national |
Response
Test Endpoint
Team by ID
GETTeam By Id
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/teams/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{TEAM_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=111 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{TEAM_ID}} |
Response
Test Endpoint
Team Squad
GETSquad by Team ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/teams/?user={{USERNAME}}&token={{TOKEN}}&t=squad&id={{TEAM_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=squad&id=111 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | squad |
id | integer | {{TEAM_ID}} |
Response
Test Endpoint
Team Squad by Season
GETSquad By Team Id ans Season ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/teams/?user={{USERNAME}}&token={{TOKEN}}&t=squad&id={{TEAM_ID}}&season_id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=squad&id=111&season_id=406 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | squad |
id | integer | {{TEAM_ID}} |
season_id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Team Transfers
GETTransfers By Team Id
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/teams/?user={{USERNAME}}&token={{TOKEN}}&t=transfers&id={{TEAM_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=transfers&id=52 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | transfers |
id | integer | {{TEAM_ID}} |
Response
Test Endpoint
Team Sidelined
GETSidelined By Team ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/teams/?user={{USERNAME}}&token={{TOKEN}}&t=sidelined&id={{TEAM_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=sidelined&id=111 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | sidelined |
id | integer | {{TEAM_ID}} |
Response
Test Endpoint
Team Trophies
GETTrophies By Team Id
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/teams/?user={{USERNAME}}&token={{TOKEN}}&t=trophies&id={{TEAM_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=trophies&id=111 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | trophies |
id | integer | {{TEAM_ID}} |
Response
Test Endpoint
Livescores Today
GETToday Matches
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/livescores/?user={{USERNAME}}&token={{TOKEN}}&t=today | |
Endpoint | https://api.soccersapi.com/v2.2/livescores/?user=user1&token=Z5R9jArYsKZmHmP47&t=today | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | today |
Response
Test Endpoint
Livescores Tomorrow
GETTomorrow Matches
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/livescores/?user={{USERNAME}}&token={{TOKEN}}&t=tomorrow | |
Endpoint | https://api.soccersapi.com/v2.2/livescores/?user=user1&token=Z5R9jArYsKZmHmP47&t=tomorrow | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | tomorrow |
Response
Test Endpoint
Livescores Yesterday
GETYesterday Matches
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/livescores/?user={{USERNAME}}&token={{TOKEN}}&t=yesterday | |
Endpoint | https://api.soccersapi.com/v2.2/livescores/?user=user1&token=Z5R9jArYsKZmHmP47&t=yesterday | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | yesterday |
Response
Test Endpoint
Livescores Inplay
GETInplay Matches
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/livescores/?user={{USERNAME}}&token={{TOKEN}}&t=live | |
Endpoint | https://api.soccersapi.com/v2.2/livescores/?user=user1&token=Z5R9jArYsKZmHmP47&t=live | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | live |
Response
Test Endpoint
Livescores Not Started
GETNot Started Matches
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/livescores/?user={{USERNAME}}&token={{TOKEN}}&t=notstarted | |
Endpoint | https://api.soccersapi.com/v2.2/livescores/?user=user1&token=Z5R9jArYsKZmHmP47&t=notstarted | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | notstarted |
Response
Test Endpoint
Livescores Ended
GETEnded Matches
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/livescores/?user={{USERNAME}}&token={{TOKEN}}&t=ended | |
Endpoint | https://api.soccersapi.com/v2.2/livescores/?user=user1&token=Z5R9jArYsKZmHmP47&t=ended | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | ended |
Response
Test Endpoint
Fixtures by Date
GETFixtures By date
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=schedule&d={{YYYY-MM-DD}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=schedule&d=2020-05-20 | |
Paginated | Yes, 100 per page |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | schedule |
d | date | {{YYYY-MM-DD}} |
page | integer | {{PAGE}} |
Response
Test Endpoint
Fixtures by Date / Country
GETFixtures By Date and Country ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=schedule&d={{YYYY-MM-DD}}&country_id={{COUNTRY_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=schedule&d=2020-05-16&country_id=4 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | schedule |
d | date | {{YYYY-MM-DD}} |
country_id | integer | {{COUNTRY_ID}} |
Response
Test Endpoint
Fixtures by Date / League (Current Season)
GETFixtures by Date and League ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=schedule&d={{YYYY-MM-DD}}&league_id={{LEAGUE_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=schedule&d=2020-05-16&league_id=594 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | schedule |
d | date | {{YYYY-MM-DD}} |
league_id | integer | {{LEAGUE_ID}} |
Response
Test Endpoint
Fixtures by Date / Season
GETFixtures By Date and Season ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=schedule&d={{YYYY-MM-DD}}&season_id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=schedule&d=2020-05-16&season_id=406 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | season |
d | date | {{YYYY-MM-DD}} |
id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Fixtures by Date / Season / Stage
GETFixtures by Date, Season ID and Stage ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=schedule&d={{YYYY-MM-DD}}&season_id={{SEASON_ID}}&stage_id={{STAGE_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=schedule&d=2019-11-19&season_id=7355&stage_id=6 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | stages |
d | date | {{YYYY-MM-DD}} |
season_id | integer | {{SEASON_ID}} |
stage_id | integer | {{STAGE_ID}} |
order | string | {{ORDER}} |
Response
Test Endpoint
Fixtures by Season / Stage
GETFixtures By Season ID and Stage ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=stage&season_id={{SEASON_ID}}&stage_id={{STAGE_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=stage&season_id=640&stage_id=1 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | stage |
season_id | integer | {{SEASON_ID}} |
stage_id | integer | {{STAGE_ID}} |
order | string | {{ORDER}} |
Response
Test Endpoint
Fixtures by Date / Season / Group
GETFixtures by Date, Season ID and Group ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=schedule&d={{YYYY-MM-DD}}&season_id={{SEASON_ID}}&group_id={{GROUP_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=schedule&d=2020-09-16&season_id=7169&group_id=1 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | schedule |
d | date | {{YYYY-MM-DD}} |
season_id | integer | {{SEASON_ID}} |
group_id | integer | {{GROUP_ID}} |
Response
Test Endpoint
Fixtures by Date / Round
GETFixtures by Date and Round ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=schedule&d={{YYYY-MM-DD}}&round_id={{ROUND_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=schedule&d=2019-07-28&round_id=2202 | |
Paginated | Yes, 100 per page |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | rounds |
d | date | YYYY-MM-DD |
id | integer | {{ROUND_ID}} |
Response
Test Endpoint
Fixtures by Season
GETFixtures By Season ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=season&season_id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=season&season_id=406 | |
Paginated | Not paginated yet, but will be |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | season |
season_id | integer | {{SEASON_ID}} |
order | string | {{ORDER}} |
Response
Test Endpoint
Fixtures by Season / Team
GETFixtures By Season ID and Team ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=season&season_id={{SEASON_ID}}&team_id={{TEAM_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=season&season_id=406&team_id=111 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | season |
season_id | integer | {{SEASON_ID}} |
team_id | integer | {{TEAM_ID}} |
order | string | {{ORDER}} |
Response
Test Endpoint
Fixtures by Season / Group
GETFixtures By Season ID and Group
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=group&season_id={{SEASON_ID}}&group_id={{GROUP_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=group&season_id=8653&group_id=91 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | stage |
season_id | integer | {{SEASON_ID}} |
group_id | integer | {{GROUP_ID}} |
order | string | {{ORDER}} |
Response
Test Endpoint
Fixtures by Season / Group / Team
GETFixtures By Season ID, Group and Team ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=group&season_id={{SEASON_ID}}&group_id={{GROUP_ID}}&team_id={{TEAM_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=group&season_id=8653&group_id=91&team_id=5496 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | stage |
season_id | integer | {{SEASON_ID}} |
group_id | integer | {{GROUP_ID}} |
order | string | {{ORDER}} |
Response
Test Endpoint
Fixtures by Season / Stage / Team
GETFixtures by Season ID, Stage ID and Team ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=stage&season_id={{SEASON_ID}}&stage_id={{STAGE_ID}}&team_id={{TEAM_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=stage&stage_id=77441847&team_id=18683 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | stage |
season_id | integer | {{SEASON_ID}} |
stage_id | integer | {{STAGE_ID}} |
team_id | integer | {{TEAM_ID}} |
order | string | {{ORDER}} |
Response
Test Endpoint
Fixtures by Round
GETFixtures By Round ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=round&round_id={{ROUND_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=round&round_id=1994 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | round |
round_id | integer | {{ROUND_ID}} |
Response
Test Endpoint
Fixtures by Round / Team
GETFixtures By Round ID and Team ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=round&round_id={{ROUND_ID}}&team_id={{TEAM_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=round&round_id=1994&team_id=111 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | round |
round_id | integer | {{ROUND_ID}} |
team_id | integer | {{TEAM_ID}} |
Response
Test Endpoint
Fixtures by Team Next & Last
GETFixtures by Team ID Last and Next Matches
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=last_next&team_id={{TEAM_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=last_next&team_id=99 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | String | {{TOKEN}} |
t | String | last_next |
team_id | integer | {{TEAM_ID}} |
Response
Test Endpoint
Match by ID
GETMatch By ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=info&id=ID | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=15006543 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{MATCH_ID}} |
Response
Test Endpoint
Match Commentary
GETMatch Commentary By Match ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=match_comments&id={{MATCH_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_comments&id=15006543 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match_comments |
id | integer | {{MATCH_ID}} |
order | string | {{ASC / DESC}} |
Response
Test Endpoint
Match Events
GETMatch Events By Match ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=match_events&id={{MATCH_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_events&id=15006543 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match_events |
id | string | {{MATCH_ID}} |
Response
Test Endpoint
Match Lineups
GETLineups By Match ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=match_lineups&id={{MATCH_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_lineups&id=15006543 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match_lineups |
id | string | {{MATCH_ID}} |
Response
Test Endpoint
Match Bench
GETBench By Match ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=match_bench&id={{MATCH_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_bench&id=15006543 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match_bench |
id | string | {{MATCH_ID}} |
Response
Test Endpoint
Match by Multiple ID
GETMatches by Multiple Match IDs
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=sort&ids={{ID, ID, ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=sort&ids=1311114,1281416 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | string | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | sort |
ids | string | {{ID, ID, ID}} |
Response
Test Endpoint
Match Sidelined
GETMatch Sidelined by Match ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=match_sidelined&id={{MATCH_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_sidelined&id=15006543 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | string | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match_sidelined |
id | string | {{MATCH_ID}} |
Response
Test Endpoint
Match Stats
GETMatch Statistics By Match ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/stats/?user={{USERNAME}}&token={{TOKEN}}&t=match&id={{MATCH_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/stats/?user=user1&token=Z5R9jArYsKZmHmP47&t=match&id=15006543 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match |
id | integer | {{MATCH_ID}} |
Response
Test Endpoint
League Stats
GETLeague Statistics by League ID (Current Season)
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/stats/?user={{USERNAME}}&token={{TOKEN}}&t=league&id={{LEAGUE_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/stats/?user=user1&token=Z5R9jArYsKZmHmP47&t=league&id=1005 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | league |
id | integer | {{LEAGUE_ID}} |
Response
Test Endpoint
Season Stats
GETSeason Statistics by Season ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/stats/?user={{USERNAME}}&token={{TOKEN}}&t=season&id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/stats/?user=user1&token=Z5R9jArYsKZmHmP47&t=season&id=406 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | season |
id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Team Stats
GETTeam Statistics by Team ID and Season ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/stats/?user={{USERNAME}}&token={{TOKEN}}&t=team&id={{TEAM_ID}}&season_id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/stats/?user=user1&token=Z5R9jArYsKZmHmP47&t=team&id=98&season_id=406 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | team |
id | integer | {{TEAM_ID}} |
season_id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Player Stats / Season
GETPlayer Statistics by Player ID and Season ID
API ReferenceDescription
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | player |
id | integer | {{PLAYER_ID}} |
season_id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Player Stats by Match ID
GETPlayer Stats by Player ID and Match ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/stats/?user={{USERNAME}}&token={{TOKEN}}&t=player&player_id={{PLAYER_ID}}&match_id={{MATCH_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/stats/?user=user1&token=Z5R9jArYsKZmHmP47&t=player&player_id=14674&match_id=42643467 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | String | {{TOKEN}} |
t | String | player |
player_id | integer | {{PLAYER_ID}} |
match_id | integer | {{MATCH_ID}} |
Response
Test Endpoint
Match H2H
GETMatch Head to Head
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/h2h/?user={{USERNAME}}&token={{TOKEN}}&t=match&id={{MATCH_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/h2h/?user=user1&token=Z5R9jArYsKZmHmP47&t=match&id=15006543 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match |
id | string | {{MATCH_ID}} |
Response
Test Endpoint
H2H Team vs Team
GETteam vs team Head to Head
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/h2h/?user={{USERNAME}}&token={{TOKEN}}&t=teams&team1={{TEAM1_ID}}&team2={{TEAM2_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/h2h/?user=user1&token=Z5R9jArYsKZmHmP47&t=teams&team1=99&team2=113 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match |
team1 | int | {{TEAM1_ID}} |
team2 | int | {{TEAM2_ID}} |
Response
Test Endpoint
Topscorers (Leaders)
GETTopscorers By Season ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/leaders/?user={{USERNAME}}&token={{TOKEN}}&t=topscorers&season_id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/leaders/?user=user1&token=Z5R9jArYsKZmHmP47&t=topscorers&season_id=406 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | topscorers |
season_id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Topassists (Leaders)
GETTopassists By Season ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/leaders/?user={{USERNAME}}&token={{TOKEN}}&t=topscorers&season_id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/leaders/?user=user1&token=Z5R9jArYsKZmHmP47&t=topscorers&season_id=406 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | topassists |
season_id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Topcards (Leaders)
GETTopcards by Season ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/leaders/?user={{USERNAME}}&token={{TOKEN}}&t=topcards&season_id={{SEASON_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/leaders/?user=user1&token=Z5R9jArYsKZmHmP47&t=topcards&season_id=406 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | topcards |
season_id | integer | {{SEASON_ID}} |
Response
Test Endpoint
Bookmakers
GETBookmakers
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/bookmakers/?user={{USERNAME}}&token={{TOKEN}}&t=list | |
Endpoint | https://api.soccersapi.com/v2.2/bookmakers/?user=user1&token=Z5R9jArYsKZmHmP47&t=list | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | list |
Response
Test Endpoint
Bookmaker by ID
GETBookmaker by ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/bookmakers/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{BOOKMAKER_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/bookmakers/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=2 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{BOOKMAKER_ID}} |
Response
Test Endpoint
Markets
GETMarkets
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/markets/?user={{USERNAME}}&token={{TOKEN}}&t=list | |
Endpoint | https://api.soccersapi.com/v2.2/markets/?user=user1&token=Z5R9jArYsKZmHmP47&t=list | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | list |
Response
Test Endpoint
Market by ID
GETMarket by ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/markets/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{MARKET_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/markets/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=1 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{MARKET_ID}} |
Response
Test Endpoint
Pre-Match Odds
GETPre-Match Odds
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=match_odds&id={{MATCH_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_odds&id=15006543 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match_odds |
id | integer | {{MATCH_ID}} |
Response
Test Endpoint
In-Play Odds
GETIn-Play Odds by Match ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=match_oddsinplay&id={{MATCH_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_oddsinplay&id=15006543 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match_oddsinplay |
id | integer | {{MATCH_ID}} |
Response
Test Endpoint
Match Odds by Bookmaker
GETMatch Odds by Bookmaker
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=match_odds_info&id={{MATCH_ID}}&bookmaker_id={{BOOKMAKER_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_odds_info&id=15203332&bookmaker_id=1 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match_odds_info |
id | integer | {{MATCH_ID}} |
bookmaker_id | integer | {{BOOKMAKER_ID}} |
Response
Test Endpoint
Player by ID
GETplayer By ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/players/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{PLAYER_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/players/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=13185 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{PLAYER_ID}} |
Response
Test Endpoint
Players by Country
GETplayer By ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/players/?user={{USERNAME}}&token={{TOKEN}}&t=list&country_id={{COUNTRY_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/players/?user=user1&token=Z5R9jArYsKZmHmP47&t=list&country_id=4 | |
Paginated | Yes, 100 per page |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | list |
country_id | integer | {{COUNTRY_ID}} |
Response
Test Endpoint
Scheduled on TV by Date
GETScheduled on TV by Date
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/broadcast/?user={{USERNAME}}&token={{TOKEN}}&t=schedule&d={{YYYY-MM-DD}} | |
Endpoint | https://api.soccersapi.com/v2.2/broadcast/?user=user1&token=Z5R9jArYsKZmHmP47&t=schedule&d=2020-08-03 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match_tvs |
d | string | {{YYYY-MM-DD}} |
Response
Test Endpoint
Match TV Channels
GETTV Channels by Match ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/broadcast/?user={{USERNAME}}&token={{TOKEN}}&t=match_tvs&id={{MATCH_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/broadcast/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_tvs&id=15006543 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | match_tvs |
id | integer | {{MATCH_ID}} |
Response
Test Endpoint
TV Channel by ID
GETTV Channel info by ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/broadcast/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{TV_CHANNEL_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/broadcast/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=2 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | String | {{TOKEN}} |
t | String | info |
id | integer | {{TV_CHANNEL_ID}} |
Response
Test Endpoint
Coach by ID
GETcoaches By ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/coaches/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{COACH_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/coaches/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=1007 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{COACH_ID}} |
Response
Test Endpoint
Venue by ID
GETVenue By ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/venues/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{VENUE_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/venues/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=1216 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{VENUE_ID}} |
Response
Test Endpoint
Referee by ID
GETReferee By ID
API ReferenceDescription
Headers | application/json | |
Endpoint Example | https://api.soccersapi.com/v2.2/referees/?user={{USERNAME}}&token={{TOKEN}}&t=info&id={{REFEREE_ID}} | |
Endpoint | https://api.soccersapi.com/v2.2/referees/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=372 | |
Paginated | No, this endpoint is not paginated |
URI Parameters
user | String | {{USERNAME}} |
token | string | {{TOKEN}} |
t | string | info |
id | integer | {{REFEREE_ID}} |
Response
Test Endpoint