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 : Soccers' API
API Version : v2.2
API Contents : Football
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
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
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
Soccer's API Version 2.2
## [2.2] - 01/10/2021
Added
- New Endpoint "TV Channels by Country" #tv_channels_country
## [2.2] - 01/10/2021
Added
- New Endpoint "All TV Channels" #tv_channels_all
## [2.2] - 30/09/2021
Added
- New Endpoint "Coaches by Country" #coaches_country
## [2.2] - 30/09/2021
Added
- New Endpoint "All Coaches" #coaches_all
## [2.2] - 30/09/2021
Added
- New Endpoint "Venues by Country" #venues_country
## [2.2] - 30/09/2021
Added
- New Endpoint "All Venues" #venues_all
## [2.2] - 02/09/2021
Added
- 'team_id' on player's information to know quickest current national team ID.
- 'national_team_id' on player's information to know quickest current national team ID.
#player_id
## [2.2] - 10/06/2021
Added
- 'position_name' on lineups from today's matches (left winger, right winger...)
## [2.2] - 17/05/2021
Added
- Attendance
## [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,stats | Match events summary, Bookmakers Match pre-match odds, Bookmakers Match in-play odds, Teams Match Stats |
| #Livescores | &include=events,odds_prematch,odds_inplay,stats | Match events summary, Bookmakers Match pre-match odds, Bookmakers Match in-play odds, Teams Match Stats |
| #MatchByID | &include=events,odds_prematch,odds_inplay,stats | Match events summary, Bookmakers Match pre-match odds, Bookmakers Match in-play odds, Teams Match Stats |
| #MatchByMultipleID | &include=events,odds_prematch,odds_inplay,stats | Match events summary, Bookmakers Match pre-match odds, Bookmakers Match in-play odds, Teams Match Stats |
| #MatchLineups | &include=stats | Match player stats |
| #matches_tv | &include=tvs | Include TV Channels |
Search by String
GETAll, Continents, Countries, Leagues, Teams, Players, Referees
Postman
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).
Description
| 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
Postman
The Continents endpoint gives you a list of all Continents.
Description
| 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
Postman
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...
Description
| 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
Postman
The All Countries endpoint gives you a list of all Countries and data like its Name, Flag, IsoCode, Continent and other related Country data.
Description
| 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
Postman
The Get Country By Id Endpoint gives you data from a specific country like Name, Flag, IsoCode, Continent and other related Country data.
Description
| 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
Postman
The Get All Leagues Endpoint gives you a paginated list of all leagues available in your plan.
Description
| 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
Postman
The Get All Leagues Endpoint gives you all leagues of a specific country
Description
| 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
Postman
The Get League by ID Endpoint gives you data from a specific League / tournament.
Description
| 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
Postman
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.
Description
| 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
Postman
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.
Description
| 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
Leagues by Multiple ID
GETLeagues by Multiple ID
Postman
The Get League by multiple ID Endpoint return multiple leagues in a single call
Description
| Headers | application/json | |
| Endpoint Example | https://api.soccersapi.com/v2.2/leagues/?user={{USERNAME}}&token={{TOKEN}}&t=sort&ids=974,594 | |
| Endpoint | https://api.soccersapi.com/v2.2/leagues/?user=user1&token=Z5R9jArYsKZmHmP47&t=sort&ids=974,594 | |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | String | {{USERNAME}} |
| token | String | {{TOKEN}} |
| t | String | sort |
| ids | integer | {{LEAGUE_ID}} |
Response
Test Endpoint
Season by ID
GETSeason By ID
Postman
The Season by ID Endpoint gives you info about a specific Season, like their league, their year, stages, rounds.
Description
| 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
Postman
The Stage by ID Endpoint gives you info about a specific Stage.
Description
| 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
Postman
The Stages by Season Endpoint returns the stages available for a specific season
Description
| 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
Postman
The Group by ID Endpoint give you information of a specific Group
Description
| 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
Postman
The Groups by Season returns groups availables in a season
If stages aren't group stages then groups may be only for specification purpose
Description
| 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
Postman
The Rounds by Season ID endpoint returns a list of Rounds of a single season
Description
| 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
Postman
The Round by ID endpoint returns information of a single round
Description
| 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
Postman
The Teams by Country ID endpoint returns a list of teams from a specific country
Description
| 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
Postman
The Teams by Season ID endpoint returns a list of teams participants on a single season
Description
| 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
Postman
The Teams National endpoint returns a list of national soccer teams
Description
| 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
Postman
The Team Info endpoint gives you data of a specific team.
Description
| 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
Postman
The Team Squad endpoint gives you all players of a specific team of the current season.
Description
| 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
Postman
The Team Squad current season endpoint gives you all players of a specific team from a specific season.
Description
| 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
Postman
The Team Transfers endpoint returns the transfers (IN, OUT) of a specific team
Description
| 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
Postman
The Team Sidelined endpoint return data about injured or missing players.
Description
| 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
Postman
The Team Trophies endpoint returns data about how many and which trophies has won the specified team along his history.
Description
| 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
Postman
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
Description
| 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
Postman
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
Description
| 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
Postman
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
Description
| 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
Postman
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
Description
| 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
Postman
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
Description
| 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
Postman
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
Description
| 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
Postman
The Fixtures by Date Endpoint gives you fixtures from a specific date.
Now you can use #Includes
You can use #Includes with this endpoint
Description
| 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
Postman
The Fixtures by Date / Country Endpoint fixtures from a single country on a specific date
You can use #Includes with this endpoint
Description
| 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
Postman
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
Description
| 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
Postman
The Fixtures by Date / Season Endpoint gives you fixtures from a single season on a specific date
You can use #Includes with this endpoint
Description
| 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
Postman
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
Description
| 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
Postman
The Fixtures by Season / Stage Endpoint gives you fixtures from a single season stage
You can use #Includes with this endpoint
Description
| 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
Postman
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
Description
| 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
Postman
The Fixtures by Date / Round Endpoint gives you fixtures from a single round on a specific date
You can use #Includes with this endpoint
Description
| 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
Postman
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}}
Now you can filter by "status_id" by passing the parameter &status_id={{STATUS_ID}}
You can use #Includes with this endpoint
Description
| 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}} |
| status_id | integer | {{STATUS_ID}} |
Response
Test Endpoint
Fixtures by Season / Team
GETFixtures By Season ID and Team ID
Postman
The Fixtures Season Endpoint gives you fixtures from a specific Season by ID and Team ID
You can use #Includes with this endpoint
Description
| 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
Postman
The Fixtures by Season / Group Endpoint gives you fixtures from a single Group
You can use #Includes with this endpoint
Description
| 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
Postman
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
Description
| 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
Postman
The Fixtures by Stage Endpoint gives you fixtures from a single stage and Team
You can use #Includes with this endpoint
Description
| 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
Postman
The Fixtures by Round Endpoint gives you fixtures from a single round
You can use #Includes with this endpoint
Description
| 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
Postman
The Fixtures by Round Endpoint gives you fixtures from a single round and Team
You can use #Includes with this endpoint
Description
| 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
Postman
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
Description
| 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
Fixtures by TV Channel
GETFixtures by TV Channel ID
Postman
The Fixtures by TV Channel Endpoint gives you next 2 weeks fixtures from a specific TV Channel
Description
| Headers | application/json | |
| Endpoint Example | https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=tv&tv_id=15 | |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=tv&tv_id=15 | |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | String | {{USERNAME}} |
| token | String | {{TOKEN}} |
| t | String | tv |
| tv_id | integer | {{TV_ID}} |
Response
Test Endpoint
Match by ID
GETMatch By ID
Postman
The Match by ID Endpoint gives you information from a specific match
You can use #Includes with this endpoint
Description
| 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
Postman
The Match Commentary Endpoint gives you commentaries by Match ID
Description
| 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
Postman
The Match Events Endpoint gives the list ofevents / occurrences by Match ID
Description
| 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
Postman
The Lineups Endpoint gives you starting Lineups by Match ID.
You can include player stats by adding the parameter "&include=stats".
Description
| 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}} |
| include | integer | stats |
Response
Test Endpoint
Match Bench
GETBench By Match ID
Postman
The Match Bench Endpoint gives you the bench of both teams
Description
| 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
Postman
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
Description
| 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
Postman
The Match Sidelined endpoint give you information about missing players of both teams on a single match
Description
| 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
Postman
The Match Stats endpoint gives you the statistics of a single event
Description
| 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)
Postman
This endpoint allows you to get league stats by ID. By default it will return the current Season of the league
Description
| 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
Postman
This endpoint allows you to get Season stats by ID.
Description
| 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
Postman
This endpoint allows you to get Team stats by Team ID and season ID.
Description
| 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
Postman
The Player Stats Endpoint gives you singular player statistics by season ID
Description
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
Postman
The Player Stats by Match returns player statistics from a specified player on a specified match
Description
| 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
Postman
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.
Description
| 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
Postman
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.
Description
| 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
Postman
The Topscorers Endpoint gives you a list of players leaders in goals, assists and cards by season.
Description
| 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
Postman
The Topassists Endpoint gives you a list of players leaders by season.
Description
| 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
Postman
The Topcards Endpoint gives you a list of players leaders in cards by season.
Description
| 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
Postman
The Bookmakers Endpoint gives you a list of all Bookmakers available in your plan
Description
| 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
Postman
The Bookmaker by ID Endpoint gives you information of a specific bookmaker by ID
Description
| 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
Postman
The Markets Endpoint gives a list of all available markets
Description
| 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
Postman
The Market by ID Endpoint gives you information of a specific market
Description
| 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
Postman
The Pre-Match Odds Endpoint gives you Pre-match odds for a specific match
Description
| 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
Postman
The In-Play Odds Endpoint gives you Live odds while the match is playing
Description
| 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
Postman
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.
Description
| 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
Postman
The Player by ID endpoint returns information of a single player
Description
| 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
Postman
The Players by Country ID Endpoint return all players from a specific country (Nationality)
Description
| 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
Matches on TV by Date
GETMatches on TV by Date
Postman
The Matches on TV by Date Endpoint gives you a list of matches that will be or has been broadcasted on TV or Streaming. You can use &include=tvs in order to get TV channels for each match within the same API request.
You can use #Includes with this endpoint
Description
| 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}} |
| include | string | tvs |
Response
Test Endpoint
Match TV Channels
GETTV Channels by Match ID
Postman
The Match TV Channels Endpoint returns International TV Channels that will cover the specified match.
Description
| 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
Postman
The TV Channel by ID returns information of specified TV Channel
Description
| 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
All TV Channels
GETAll TV Channels list
Postman
The All TV Channels endpoint returns a paginated list of all TV Channels
This endpoint is only available after the free trial period
Description
| Headers | application/json | |
| Endpoint Example | https://api.soccersapi.com/v2.2/broadcast/?user=null&token=null&t=list | |
| Endpoint | https://api.soccersapi.com/v2.2/broadcast/?user={{USERNAME}}&token={{TOKEN}}&t=list | |
| Paginated | Yes, 100 per page |
URI Parameters
| user | String | {{USERNAME}} |
| token | String | {{TOKEN}} |
| t | String | list |
Response
Test Endpoint
TV Channels by Country
GETTV Channels by country ID
Postman
The TV Channels by Country endpoint returns a list of TV Channels of a single country
This endpoint is only available after the free trial period
Description
| Headers | application/json | |
| Endpoint Example | https://api.soccersapi.com/v2.2/broadcast/?user={{USERNAME}}&token={{TOKEN}}&t=list&country_id={{COUNTRY_ID}} | |
| Endpoint | https://api.soccersapi.com/v2.2/broadcast/?user=null&token=null&t=list&country_id=15 | |
| 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
Coach by ID
GETcoaches By ID
Postman
The Coach by ID Endpoint give you information of a specific coach
Description
| 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
All Coaches
GETAll Coaches list
Postman
The All Coaches Endpoint returns a list of all coaches
This endpoint is only available after the free trial period
Description
| Headers | application/json | |
| Endpoint Example | https://api.soccersapi.com/v2.2/coaches/?user={{USERNAME}}&token={{TOKEN}}&t=list&page={{PAGE}} | |
| Endpoint | https://api.soccersapi.com/v2.2/coaches/?user=null&token=null&t=list&page=1 | |
| Paginated | Yes, 100 per page |
URI Parameters
| user | String | {{USERNAME}} |
| token | String | {{TOKEN}} |
| t | String | list |
| page | integer | {{PAGE}} |
Response
Test Endpoint
Coaches by Country
GETCoaches by Country ID
Postman
The Coaches by Country ID Endpoint returns a list of coaches of a single country
This endpoint is only available after the free trial period
Description
| Headers | application/json | |
| Endpoint Example | https://api.soccersapi.com/v2.2/coaches/?user={{USERNAME}}&token={{TOKEN}}&t=list&country_id={{COUNTRY_ID}} | |
| Endpoint | https://api.soccersapi.com/v2.2/coaches/?user=null&token=null&t=list&country_id=25 | |
| 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
Venue by ID
GETVenue By ID
Postman
The Venue by ID Endpoint give you information of a specific venue
Description
| 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
All Venues
GETAll Venues list
Postman
The All Venues Endpoint returns a list of all venues (Stadiums)
This endpoint is only available after the free trial period
Description
| Headers | application/json | |
| Endpoint Example | https://api.soccersapi.com/v2.2/venues/?user={{USERNAME}}&token={{TOKEN}}&t=list | |
| Endpoint | https://api.soccersapi.com/v2.2/venues/?user=null&token=null&t=list | |
| Paginated | Yes, 100 per page |
URI Parameters
| user | String | {{USERNAME}} |
| token | String | {{TOKEN}} |
| t | String | list |
| page | integer | {{PAGE}} |
Response
Test Endpoint
Venues by Country
GETVenues by Country ID
Postman
The Venues by Country endpoint returns a list of venues of a single country
This endpoint is only available after the free trial period
Description
| Headers | application/json | |
| Endpoint Example | https://api.soccersapi.com/v2.2/venues/?user={{USERNAME}}&token={{TOKEN}}&t=list&country_id={{COUNTRY_ID}} | |
| Endpoint | https://api.soccersapi.com/v2.2/venues/?user=null&token=null&t=list&country_id=15 | |
| 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
Referee by ID
GETReferee By ID
Postman
The Referee by ID Endpoint give you information of a specific Referee
Description
| 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