Documentation - SoccersAPI

Introduction

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

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

Setup the API

Following these steps will ensure that you're able to quickly and easily access the soccer data you need. If you have any questions or run into any issues, please don't hesitate to reach out to our support team for assistance.

Subscribe to SoccersAPI and login to your account.
Once you've logged in, navigate to https://soccersapi.com/dashboard/api-key.
Generate a token in your user dashboard by following the instructions provided.
Take note of your username and token.
With your username and token in hand, you're now ready to start making 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

2024-10-09 [2.2]
Added
- Added default_color league parameter.

2024-10-03 [2.2]
Added (beta)
- Added media endpoints (highlights) by (event, league, season, team, round, date [type=date&d=2024-10-03]). Example of request: https://api.soccersapi.com/v2.2/media/?user={{USERNAME}}&token={{TOKEN}}&t=league&id=637

2024-09-19 [2.2]
Added
- Use the country_broadcast_id filter to include only broadcasts from a specific country for a match. Example of request: https://api.soccersapi.com/v2.2/broadcast/?user={{USERNAME}}&token={{TOKEN}}&t=match_tvs&id=1910954&country_broadcast_id=5

2024-08-30 [2.2]
Added
- Field is_current in stages by season #stages_season

2024-08-20 [2.2]
Added
- Default images for not existing leagues, teams and players

## [2.2]
Added
- New Bookmaker "Betika" #match_odds

## [2.2]
Added
- Bookmakers custom sort #match_odds

## [2.2]
Added
- New Language "Chinese simplified" (ZH_CN) #lang

## [2.2]
Added
- New Language "Chinese" (ZH) #lang

## [2.2]
Added
- New Language "Portuguese" (PT) #lang

## [2.2]
Added
- New Language "Turkish" (TR) #lang

## [2.2]
Added
- New Language "Polish" (PL) #lang

## [2.2]
Added
- New Language "French" (FR) #lang

## [2.2]
Added
- New endpoint "Standings Live" #standings_live

## [2.2]
Added
- Added the capability to search Matches #search_all

## [2.2]
Added
- Added the capability to search TV Channels #search_all

## [2.2]
Improved
- On "TV Channels by Match" coverage improved #match_tv

## [2.2]
Added
- New Endpoint "TV Channels by Country" #tv_channels_country

## [2.2]
Added
- New Endpoint "All TV Channels" #tv_channels_all

## [2.2]
Added
- New Endpoint "Coaches by Country" #coaches_country

## [2.2]
Added
- New Endpoint "All Coaches" #coaches_all

## [2.2]
Added
- New Endpoint "Venues by Country" #venues_country

## [2.2]
Added
- New Endpoint "All Venues" #venues_all

## [2.2]
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]
Added
- 'position_name' on lineups from today's matches (left winger, right winger...)

## [2.2]
Added
- Attendance

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

## [2.2]
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]
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]
Added
- Added new dataset include "Match Events" in #Livescores, #Fixtures, #MatchById, #MatchByMultipleID. #Includes

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

## [2.2]
Added
- Added includes feature in #MatchByMultipleID endpoint #Includes

## [2.2]
Added
- Added includes feature in #MatchByID endpoint #Includes

## [2.2]
Added
- Added includes feature in #livescores endpoints #Includes

## [2.2]
Added
- Filter by status_id on #Fixtures_by_season

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

## [2.2]
Added
- Added endpoint Leagues by Multiple ID #leagues_multiple_id

## [2.2]
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]
Beta
- Added API Translations to Arabic, Greek and Italian. #language

## [2.2]
Added
- Added market_value parameter in player's info.

## [2.2]
Added
- Added endpoint for check all groups by season id.

## [2.2]
Added
- Added teams and league images in all H2H endpoints.

## [2.2]
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]
Added
- Timestamp parameter in match events from today

## [2.2]
Fixed
- Endpoint Season Stats > goal_line has been recalculated.

## [2.2]
Added
- New Endpoint Player Stats by Match ID #player_stats_match

## [2.2]
Added
- New Endpoint Cup Draw (Tournament Bracket) #cup_draw

## [2.2]
Added
- New Endpoint TV Channel by ID #tv_info

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

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

## [2.2]
Added
- New Endpoint added Fixtures Next & Last

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

## [2.2]
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]
Added
- Basic Stats of players in Match Lineups endpoint

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

## [2.2]
Added
- Historical data up to 10 years

## [2.2]
Fixed
- Fixtures endpoints datetime value to UTC

## [2.2]
Added
- Endpoint Match Sidelined

## [2.2]
Added
- Endpoint Match by Multiple IDs

## [2.2]
Added
- Team Kit colors on Fixtures Endpoints

## [2.2]
Added
- Endpoint Teams National

## [2.2]
Added
- Endpoint Search by Keyword

## [2.2]
Added
- Endpoint Stages by Season

## [2.2]
Added
- Endpoint Stage by ID

## [2.2]
Added
- Endpoint Group by ID

## [2.2]
Added
- Team Kit Colors (Team by ID Endpoint)

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

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

## [2.2]
Added
- Endpoint H2H Team vs Team

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

## [2.2]
Added
- Logos +800 leagues

## [2.2]
Added
- Endpoint Team Transfers
- Endpoint Match H2H

## [2.2]
Added
- Endpoint Match Odds by Bookmaker

## [2.2]
Added
- Team Kit colors
- Endpoint Team Trophies

Timezone

Getting data in a different timezone

Get match dates and fixtures in different time zones by adding "&utc={{TIMEZONE}}" to the end of the fixtures and livescores endpoints?

For example, to get fixtures in UTC +3.5, you can use this endpoint: https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=schedule&d=2020-12-29&utc=3.5

And to get fixtures in UTC -3.5, you can use this endpoint: https://api.soccersapi.com/v2.2/fixtures/?user={{USERNAME}}&token={{TOKEN}}&t=schedule&d=2020-12-29&utc=-3.5

When the UTC parameter is enabled, the endpoints may return different fixtures depending on the match starting time and the selected timezone. For example, if a match is scheduled at 23:00h on December 29th in UTC, adding UTC +2 would make the same match start at 01:00h on December 30th.

By using the "&utc={{TIMEZONE}}" parameter, you can easily get match data and fixtures in the timezone you need, making it easier to work with soccer data from around the world.

Language (BETA)

Get data in other languages. Now you can get data in a different language just adding &lang={{LANG}} append to endpoints URL.

Language is a beta feature and there may be errors

Get fixtures in different languages:

Parameter	Value	Language
lang	AR	Arabic
lang	EL	Hellenic
lang	IT	Italian
lang	DE	German
lang	ES	Spanish
lang	RU	Russian
lang	KA	Georgian
lang	NL	Dutch
lang	FR	French
lang	PL	Polish
lang	PT	Portuguese
lang	TR	Turkish

Includes

Include extra datasets to existing endpoints.

Endpoint	Includes	Description
#Fixtures	&include=events,odds_prematch,odds_inplay,stats,tvs	Match events summary, Pre-match odds, In-play odds, Match Stats, Match TV Broadcast
#Livescores	&include=events,odds_prematch,odds_inplay,stats,tvs	Match events summary, Pre-match odds, In-play odds, Match Stats, Match TV Broadcast
#MatchByID	&include=events,odds_prematch,odds_inplay,stats,tvs	Match events summary, Pre-match odds, In-play odds, Match Stats, Match TV Broadcast
#MatchByMultipleID	&include=events,odds_prematch,odds_inplay,stats,tvs	Match events summary, Pre-match odds, In-play odds, Match Stats, Match TV Broadcast
#MatchLineups	&include=stats	Match player stats
#matches_tv	&include=tvs	Include TV Channels

Search by String

GETAll, Continents, Countries, Leagues, Teams, Players, Referees, Matches, TV Channels

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	{{all, country, league, team, player, match, channel}}
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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	list

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	string	{{CONTINENT_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	list
page	integer	{{PAGE}}

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{COUNTRY_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	list
page	integer	{{PAGE}}

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	list
country_id	integer	{{COUNTRY_ID}}

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{LEAGUE_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	standings
season_id	integer	{{SEASON_ID}}

Response

Test Endpoint

standings

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	String	{{TOKEN}}
t	String	cup_draw
season_id	integer	{{SEASON_ID}}
stage_id	integer	{{STAGE_ID}}

Response

Test Endpoint

cup_draw

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	String	{{TOKEN}}
t	String	sort
ids	integer	{{LEAGUE_ID}}

Response

Test Endpoint

sort

Standings Live

GETStandings Live by Season ID

Postman

Standings Live Endpoint provides live team rankings for each league, with real-time provisional positions while matches are in progress.

Description

Headers	`application/json`
Endpoint Example	https://api.soccersapi.com/v2.2/leagues/?user={{USERNAME}}&token={{TOKEN}}&t=standings_live&season_id={{SEASON_ID}}
Endpoint	https://api.soccersapi.com/v2.2/leagues/?user=user1&token=Z5R9jArYsKZmHmP47&t=standings_live&season_id=13449
Paginated	No, this endpoint is not paginated

URI Parameters

Parameter	Type	Value
user	string	{{USERNAME}}
token	string	{{TOKEN}}
t	string	standings_live
season_id	integer	{{SEASON_ID}}

Response

Test Endpoint

standings_live

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{SEASON_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{STAGE_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	byseason
season_id	integer	{{SEASON_ID}}

Response

Test Endpoint

byseason

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{GROUP_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	String	{{TOKEN}}
t	String	byseason
season_id	integer	{{SEASON_ID}}

Response

Test Endpoint

byseason

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	byseason
season_id	integer	{{SEASON_ID}}

Response

Test Endpoint

byseason

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{ROUND_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	list
country_id	integer	{{COUNTRY_ID}}

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	byseason
season_id	integer	{{SEASON_ID}}

Response

Test Endpoint

byseason

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	national

Response

Test Endpoint

national

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{TEAM_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	squad
id	integer	{{TEAM_ID}}

Response

Test Endpoint

squad

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	squad
id	integer	{{TEAM_ID}}
season_id	integer	{{SEASON_ID}}

Response

Test Endpoint

squad

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	transfers
id	integer	{{TEAM_ID}}

Response

Test Endpoint

transfers

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	sidelined
id	integer	{{TEAM_ID}}

Response

Test Endpoint

sidelined

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	trophies
id	integer	{{TEAM_ID}}

Response

Test Endpoint

trophies

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	today

Response

Test Endpoint

today

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	tomorrow

Response

Test Endpoint

tomorrow

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	yesterday

Response

Test Endpoint

yesterday

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	live

Response

Test Endpoint

live

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	notstarted

Response

Test Endpoint

notstarted

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	ended

Response

Test Endpoint

ended

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	schedule
d	date	{{YYYY-MM-DD}}
page	integer	{{PAGE}}

Response

Test Endpoint

schedule

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	schedule
d	date	{{YYYY-MM-DD}}
country_id	integer	{{COUNTRY_ID}}

Response

Test Endpoint

schedule

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	schedule
d	date	{{YYYY-MM-DD}}
league_id	integer	{{LEAGUE_ID}}

Response

Test Endpoint

schedule

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	season
d	date	{{YYYY-MM-DD}}
id	integer	{{SEASON_ID}}

Response

Test Endpoint

season

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

Parameter	Type	Value
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

stages

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

Parameter	Type	Value
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

stage

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

Parameter	Type	Value
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

schedule

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	rounds
d	date	YYYY-MM-DD
id	integer	{{ROUND_ID}}

Response

Test Endpoint

rounds

YYYY-MM-DD

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

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

Parameter	Type	Value
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

season

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

Parameter	Type	Value
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

season

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

Parameter	Type	Value
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

stage

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

Parameter	Type	Value
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

stage

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

Parameter	Type	Value
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

stage

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	round
round_id	integer	{{ROUND_ID}}

Response

Test Endpoint

round

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	round
round_id	integer	{{ROUND_ID}}
team_id	integer	{{TEAM_ID}}

Response

Test Endpoint

round

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	String	{{TOKEN}}
t	String	last_next
team_id	integer	{{TEAM_ID}}

Response

Test Endpoint

last_next

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

Parameter	Type	Value
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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{MATCH_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match_comments
id	integer	{{MATCH_ID}}
order	string	{{ASC / DESC}}

Response

Test Endpoint

match_comments

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match_events
id	string	{{MATCH_ID}}

Response

Test Endpoint

match_events

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match_lineups
id	string	{{MATCH_ID}}
include	integer	stats

Response

Test Endpoint

match_lineups

stats

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match_bench
id	string	{{MATCH_ID}}

Response

Test Endpoint

match_bench

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

Parameter	Type	Value
user	string	{{USERNAME}}
token	string	{{TOKEN}}
t	string	sort
ids	string	{{ID, ID, ID}}

Response

Test Endpoint

sort

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

Parameter	Type	Value
user	string	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match_sidelined
id	string	{{MATCH_ID}}

Response

Test Endpoint

match_sidelined

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match
id	integer	{{MATCH_ID}}

Response

Test Endpoint

match

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	league
id	integer	{{LEAGUE_ID}}

Response

Test Endpoint

league

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	season
id	integer	{{SEASON_ID}}

Response

Test Endpoint

season

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	team
id	integer	{{TEAM_ID}}
season_id	integer	{{SEASON_ID}}

Response

Test Endpoint

team

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

Headers	`application/json`
Endpoint Example	https://api.soccersapi.com/v2.2/stats/?user={{USERNAME}}&token={{TOKEN}}&t=player&id={{PLAYER_ID}}&season_id={{SEASON_ID}}
Endpoint	https://api.soccersapi.com/v2.2/stats/?user=user1&token=Z5R9jArYsKZmHmP47&t=player&id=13185&season_id=406
Paginated

URI Parameters

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	player
id	integer	{{PLAYER_ID}}
season_id	integer	{{SEASON_ID}}

Response

Test Endpoint

player

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	String	{{TOKEN}}
t	String	player
player_id	integer	{{PLAYER_ID}}
match_id	integer	{{MATCH_ID}}

Response

Test Endpoint

player

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match
id	string	{{MATCH_ID}}

Response

Test Endpoint

match

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match
team1	int	{{TEAM1_ID}}
team2	int	{{TEAM2_ID}}

Response

Test Endpoint

match

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	topscorers
season_id	integer	{{SEASON_ID}}

Response

Test Endpoint

topscorers

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	topassists
season_id	integer	{{SEASON_ID}}

Response

Test Endpoint

topassists

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	topcards
season_id	integer	{{SEASON_ID}}

Response

Test Endpoint

topcards

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	list

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{BOOKMAKER_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	list

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{MARKET_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value	Description
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match_odds
id	integer	{{MATCH_ID}}	Match ID
bookmaker_custom_sort	integer	{{BOOKMAKERS_ID}}	The bookmaker_custom_sort parameter allows you to customize the response to only include bookmakers with specific IDs and order them according to your preference.

Response

Test Endpoint

match_odds

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match_oddsinplay
id	integer	{{MATCH_ID}}
bookmaker_custom_sort	integer	{{BOOKMAKERS_ID}}

Response

Test Endpoint

match_oddsinplay

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match_odds_info
id	integer	{{MATCH_ID}}
bookmaker_id	integer	{{BOOKMAKER_ID}}

Response

Test Endpoint

match_odds_info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{PLAYER_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	list
country_id	integer	{{COUNTRY_ID}}

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match_tvs
d	string	{{YYYY-MM-DD}}
include	string	tvs

Response

Test Endpoint

match_tvs

tvs

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	match_tvs
id	integer	{{MATCH_ID}}

Response

Test Endpoint

match_tvs

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	String	{{TOKEN}}
t	String	info
id	integer	{{TV_CHANNEL_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	String	{{TOKEN}}
t	String	list

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	String	{{TOKEN}}
t	String	list
country_id	integer	{{COUNTRY_ID}}

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{COACH_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	String	{{TOKEN}}
t	String	list
page	integer	{{PAGE}}

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	String	{{TOKEN}}
t	String	list
country_id	integer	{{COUNTRY_ID}}

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{VENUE_ID}}

Response

Test Endpoint

info

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	String	{{TOKEN}}
t	String	list
page	integer	{{PAGE}}

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	String	{{TOKEN}}
t	String	list
country_id	integer	{{COUNTRY_ID}}

Response

Test Endpoint

list

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

Parameter	Type	Value
user	String	{{USERNAME}}
token	string	{{TOKEN}}
t	string	info
id	integer	{{REFEREE_ID}}

Response

Test Endpoint

info