Documentation v2.2
SoccersAPI / Documentation Version 2.2
Introduction
- API : Soccers' API
- API Version : v 2.2
- API Contents : Football
SoccersAPI is a RESTful service for soccer data sport. It is a PAID service with low price (started with $25 per month). Note that in order to access Soccer's API you must purchase related packages. Please contact us if you have any problem.
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
Note that some endpoints aren't available while trial period.
Authentication #back to top
API base URL
All API endpoints are relative to the base URLhttps://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=YOUR_USER&token=YOUR_TOKEN&t=list
Make sure replace YOUR_USER and YOUR_TOKEN values with yours.
Statuses and Explanation#back to top
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. |
Images #back to top
You can get images in four different sizes based on pixels
Get Images by Size
Leagues
18x18https://cdn.soccersapi.com/images/soccer/leagues/18/1005.png50x50
https://cdn.soccersapi.com/images/soccer/leagues/50/1005.png80x80
https://cdn.soccersapi.com/images/soccer/leagues/80/1005.png100x100
https://cdn.soccersapi.com/images/soccer/leagues/100/1005.png
Teams
18x18https://cdn.soccersapi.com/images/soccer/teams/18/104.png50x50
https://cdn.soccersapi.com/images/soccer/teams/50/104.png80x80
https://cdn.soccersapi.com/images/soccer/teams/80/104.png100x100
https://cdn.soccersapi.com/images/soccer/teams/100/104.png
Players
18x18https://cdn.soccersapi.com/images/soccer/players/18/1000.png50x50
https://cdn.soccersapi.com/images/soccer/players/50/1000.png80x80
https://cdn.soccersapi.com/images/soccer/players/80/1000.png100x100
https://cdn.soccersapi.com/images/soccer/players/150/1000.png
Bookmakers (1 size)
80xhttps://cdn.soccersapi.com/images/soccer/bookmakers/2.png
Changelog #back to top
Soccer's API Version 2.2
18/06/2020
17/06/2020
- Added new Endpoint All Continents
- Added new Endpoint Continent by ID
- Added new Feature Order ASC / DESC in Fixtures by Season Endpoint
14/06/2020
06/06/2020
03/06/2020
25/05/2020
- Added Team Kit colors
- Added new Endpoint Team Trophies
All Continents#back to top
The Continents endpoint gives you a list of all Continents.
GET Get All Continents
Description
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/continents/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=list | |
| Example | https://api.soccersapi.com/v2.2/continents/?user=user1&token=Z5R9jArYsKZmHmP47&t=list | |
| Paginated | Yes, 100 leagues per page |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | list |
Response Attributes
Response Example
{
"data": [
{
"id": "1",
"name": "World"
},
{
"id": "2",
"name": "Europe"
},
{
"id": "3",
"name": "Africa"
},
{
"id": "4",
"name": "North America"
},
{
"id": "5",
"name": "South America"
},
{
"id": "6",
"name": "Asia"
},
{
"id": "7",
"name": "Oceania"
}
],
...
Continent by ID#back to top
The Get Continent By Id Endpoint gives you data from a specific continent.
GET Get Country By Id
API ReferenceDescription
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | string | CONTINENT_ID |
Response Attributes
Response Example
{
"data": {
"id": "2",
"name": "Europe"
},
...
All Countries#back to top
The All Countries endpoint gives you a list of all Countries and data like its Name, Flag, IsoCode, Continent and other related Country data.
GET Get All Countries
Description
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/countries/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=list |
| Example | https://api.soccersapi.com/v2.2/countries/?user=user1&token=Z5R9jArYsKZmHmP47&t=list |
| Paginated | Yes, 100 per page |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | list |
| page | integer | PAGE_NUMBER |
Response Attributes
| id | integer | The id of the country |
| name | string | The name of the country |
| continent | string | The continent of the country |
| sub_region | string | Region of the country |
| code | string | Code of 2 letters of country |
Response Example
{
"data": [
{
"id": "1",
"name": "International",
"continent": "World",
"sub_region": null,
"code": ""
},
{
"id": "2",
"name": "International Clubs",
"continent": "World",
"sub_region": null,
"code": ""
},
{
"id": "3",
"name": "England",
"continent": "Europe",
"sub_region": null,
"code": "en"
},
{
"id": "4",
"name": "Germany",
"continent": "Europe",
"sub_region": null,
"code": "de"
},
{
"id": "5",
"name": "Spain",
"continent": "Europe",
"sub_region": null,
"code": "es"
},
{
"id": "6",
"name": "Italy",
"continent": "Europe",
"sub_region": null,
"code": "it"
},
{
"id": "7",
"name": "France",
"continent": "Europe",
"sub_region": null,
"code": "fr"
},
{
"id": "8",
"name": "Albania",
"continent": "Europe",
"sub_region": null,
"code": "al"
},
{
"id": "9",
"name": "Algeria",
"continent": "Africa",
"sub_region": null,
"code": "dz"
},
{
"id": "10",
"name": "Andorra",
"continent": "Europe",
"sub_region": null,
"code": "ad"
},
{
"id": "11",
"name": "Angola",
"continent": "Africa",
"sub_region": null,
"code": "ao"
},
{
"id": "12",
"name": "Argentina",
"continent": "South America",
"sub_region": null,
"code": "ar"
},
{
"id": "13",
"name": "Armenia",
"continent": "Europe",
"sub_region": null,
"code": "am"
},
{
"id": "14",
"name": "Australia",
"continent": "Asia",
"sub_region": null,
"code": "au"
},
{
"id": "15",
"name": "Austria",
"continent": "Europe",
"sub_region": null,
"code": "at"
},
{
"id": "17",
"name": "Azerbaijan",
"continent": "Europe",
"sub_region": null,
"code": "az"
},
{
"id": "18",
"name": "Bahrain",
"continent": "Asia",
"sub_region": null,
"code": "bh"
},
{
"id": "19",
"name": "Bangladesh",
"continent": "Oceania",
"sub_region": null,
"code": "bd"
},
...
Country by ID#back to top
The Get Country By Id Endpoint gives you data from a specific country like Name, Flag, IsoCode, Continent and other related Country data.
GET Get Country By Id
API Reference
https://api.soccersapi.com/v2.2/countries/(?user, token, t, id)
Description
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/countries/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id={COUNTRY_ID} |
| Example | https://api.soccersapi.com/v2.2/countries/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=4 |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | COUNTRY_ID |
Response Attributes
| id | integer | The id of the country |
| name | string | The name of the country |
| continent | string | The continent of the country |
| sub_region | string | Region of the country |
| long | string | Longitude |
| lat | string | Latitude |
| code | string | Code of 2 letters of country |
Response Example
{
"data": {
"id": "4",
"name": "Germany",
"continent": "Europe",
"sub_region": null,
"long": null,
"lat": null,
"img": "https://cdn.soccersapi.com/images/countries/30/de.png",
"code": "de"
},
...
All Leagues#back to top
The Get All Leagues Endpoint gives you a paginated list of all leagues available in your plan.
GET Get All Leagues
Description
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/leagues/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=list | |
| Example | https://api.soccersapi.com/v2.2/leagues/?user=user1&token=Z5R9jArYsKZmHmP47&t=list | |
| Paginated | Yes, 100 leagues per page |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | list |
| page | integer | PAGE_NUMBER |
Response Attributes
| id | integer | The id of the league |
| name | string | The name of the league |
| is_cup | string | Boolean if that league is cup |
| is_amateur | string | Boolean if that league is amateur |
| country_id | integer | COUNTRY_ID |
| continent_id | integer | CONTINENT_ID |
Response Example
{
"data": [
{
"id": "799",
"name": "Ligue 1",
"is_cup": "0",
"is_amateur": "0",
"continent_id": "3",
"country_id": "9",
"current_season_id": "8513",
"current_round_id": "29659",
"current_stage_id": null
},
{
"id": "798",
"name": "Algeria Cup",
"is_cup": "1",
"is_amateur": "0",
"continent_id": "3",
"country_id": "9",
"current_season_id": "9523",
"current_round_id": "7648",
"current_stage_id": null
},
{
"id": "800",
"name": "Ligue 2",
"is_cup": "0",
"is_amateur": "0",
"continent_id": "3",
"country_id": "9",
"current_season_id": "10027",
"current_round_id": "29660",
"current_stage_id": null
},
{
"id": "801",
"name": "Super Cup",
"is_cup": "1",
"is_amateur": "0",
"continent_id": "3",
"country_id": "9",
"current_season_id": "10171",
"current_round_id": "9518",
"current_stage_id": null
},
{
"id": "813",
"name": "Girabola",
"is_cup": "0",
"is_amateur": "0",
"continent_id": "3",
"country_id": "11",
"current_season_id": "9831",
"current_round_id": "29480",
"current_stage_id": null
},
{
"id": "1134",
"name": "Premier League",
"is_cup": "0",
"is_amateur": "0",
"continent_id": "3",
"country_id": "24",
"current_season_id": "10167",
"current_round_id": "9506",
"current_stage_id": null
},
{
"id": "1425",
"name": "Elite One",
"is_cup": "0",
"is_amateur": "0",
"continent_id": "3",
"country_id": "27",
"current_season_id": "8839",
"current_round_id": "6053",
"current_stage_id": null
},
...
All Leagues by Country ID#back to top
The Get All Leagues Endpoint gives you all leagues of a specific country
GET Get All Leagues by country ID
Description
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/leagues/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=list&country_id={COUNTRY_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | list |
| country_id | integer | COUNTRY_ID |
Response Attributes
| id | integer | The id of the league |
| name | string | The name of the league |
| is_amateur | integer | Boolean if the league is amateur |
| id_current_season | integer | The id of the current season |
| id_current_stage | integer | The id of the current stage |
| id_current_round | integer | The id of the current round |
| continent | object | id, name |
| country | object | id, name, cc |
| seasons | object | id, name, is_current |
Response Example
{
"data": [
{
"id": "592",
"name": "2. Bundesliga",
"is_cup": "0",
"is_amateur": "0",
"id_current_season": "613",
"id_current_stage": null,
"id_current_round": "2227",
"continent": {
"id": "2",
"name": "Europe"
},
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
},
"seasons": [
{
"id": "613",
"name": "19/20",
"is_current": "1"
},
{
"id": "614",
"name": "18/19",
"is_current": "0"
}
]
},
{
"id": "1855",
"name": "2. Bundesliga Women",
"is_cup": "0",
"is_amateur": "1",
"id_current_season": "9879",
"id_current_stage": null,
"id_current_round": "8325",
"continent": {
"id": "2",
"name": "Europe"
},
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
},
"seasons": [
{
"id": "9879",
"name": "19/20",
"is_current": "1"
},
{
"id": "9880",
"name": "18/19",
"is_current": "0"
}
]
},
{
"id": "593",
"name": "3. Liga",
"is_cup": "0",
"is_amateur": "0",
"id_current_season": "3223",
"id_current_stage": null,
"id_current_round": "3898",
"continent": {
"id": "2",
"name": "Europe"
},
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
},
"seasons": [
{
"id": "3223",
"name": "19/20",
"is_current": "1"
},
{
"id": "3224",
"name": "18/19",
"is_current": "0"
}
]
},
{
"id": "594",
"name": "Bundesliga",
"is_cup": "0",
"is_amateur": "0",
"id_current_season": "406",
"id_current_stage": null,
"id_current_round": "2019",
"continent": {
"id": "2",
"name": "Europe"
},
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
},
"seasons": [
{
"id": "406",
"name": "19/20",
"is_current": "1"
},
{
"id": "407",
"name": "18/19",
"is_current": "0"
}
]
},
{
"id": "1882",
"name": "Bundesliga Women",
"is_cup": "0",
"is_amateur": "1",
"id_current_season": "2027",
"id_current_stage": null,
"id_current_round": "3470",
"continent": {
"id": "2",
"name": "Europe"
},
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
},
"seasons": [
{
"id": "2027",
"name": "19/20",
"is_current": "1"
},
{
"id": "2028",
"name": "18/19",
"is_current": "0"
}
]
},
{
"id": "1863",
"name": "DFB Junioren Pokal",
"is_cup": "0",
"is_amateur": "1",
"id_current_season": "10371",
"id_current_stage": null,
"id_current_round": "10893",
"continent": {
"id": "2",
"name": "Europe"
},
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
},
"seasons": [
{
"id": "10371",
"name": "19/20",
"is_current": "1"
},
{
"id": "10372",
"name": "18/19",
"is_current": "0"
}
]
},
...
League by ID #back to top
The Get League by ID Endpoint gives you data from a specific League / tournament.
GET Get League by ID
API ReferenceDescription
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/leagues/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id={LEAGUE_ID} | |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | LEAGUE_ID |
Response Attributes
| id | integer | The id of the league |
| name | string | The name of the league |
| is_cup | string | Boolean if that league is cup |
| id_current_season | string | Current Season |
| id_current_stage | string | Current Stage |
| id_current_round | string | Current Round |
| continent | object | id, name |
| seasons | object | id, name, is_current |
Response Example
{
"data": {
"id": "594",
"name": "Bundesliga",
"is_cup": "0",
"is_amateur": "0",
"id_current_season": "406",
"id_current_stage": null,
"id_current_round": "2019",
"continent": {
"id": "2",
"name": "Europe"
},
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
},
"seasons": [
{
"id": "406",
"name": "19/20",
"is_current": "1"
},
{
"id": "407",
"name": "18/19",
"is_current": "0"
}
]
},
...
League Standings #back to top
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.
GET Get League Standings by Season ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/leagues/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=standings&season_id={SEASON_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | standings |
| season_id | integer | SEASON_ID |
Response Attributes
| league_id | integer | The id of the season |
| season_id | string | The name of the league |
| stage_id | string | Boolean if that league is cup |
| round_id | string | Current Season |
| standings | object | position, team_id, team_name, round, group, status, result, points, recent_form |
| overall | object | games_played, won, draw, lost, goals_diff, goals_scored, goals_against, points, position |
| home | object | games_played, won, draw, lost, goals_diff, goals_scored, goals_against, points, position |
| away | object | games_played, won, draw, lost, goals_diff, goals_scored, goals_against, points, position |
Response Example
{
"data": {
"league_id": "594",
"season_id": "406",
"stage_id": null,
"round_id": null,
"standings": [
{
"position": 1,
"team_id": "111",
"team_name": "B. Munich",
"round": null,
"group": null,
"overall": {
"games_played": 26,
"won": 18,
"draw": 4,
"lost": 4,
"goals_diff": 49,
"goals_scored": 75,
"goals_against": 26,
"points": 58,
"position": 1
},
"home": {
"games_played": 13,
"won": 9,
"draw": 2,
"lost": 2,
"goals_diff": 27,
"goals_scored": 38,
"goals_against": 11,
"points": 29,
"position": 2
},
"away": {
"games_played": 13,
"won": 9,
"draw": 2,
"lost": 2,
"goals_diff": 22,
"goals_scored": 37,
"goals_against": 15,
"points": 29,
"position": 1
},
"total": 26,
"status": "Promotion",
"result": "Champions League",
"points": 58,
"recent_form": null
},
{
"position": 2,
"team_id": "98",
"team_name": "Dortmund",
"round": null,
"group": null,
"overall": {
"games_played": 27,
"won": 17,
"draw": 6,
"lost": 4,
"goals_diff": 41,
"goals_scored": 74,
"goals_against": 33,
"points": 57,
"position": 2
},
"home": {
"games_played": 13,
"won": 10,
"draw": 3,
"lost": 0,
"goals_diff": 35,
"goals_scored": 45,
"goals_against": 10,
"points": 33,
"position": 1
},
"away": {
"games_played": 14,
"won": 7,
"draw": 3,
"lost": 4,
"goals_diff": 6,
"goals_scored": 29,
"goals_against": 23,
"points": 24,
"position": 4
},
"total": 27,
"status": "Promotion",
"result": "Champions League",
"points": 57,
"recent_form": null
},
{
"position": 3,
"team_id": "114",
"team_name": "Leverkusen",
"round": null,
"group": null,
"overall": {
"games_played": 27,
"won": 16,
"draw": 5,
"lost": 6,
"goals_diff": 20,
"goals_scored": 52,
"goals_against": 32,
"points": 53,
"position": 3
},
"home": {
"games_played": 13,
"won": 7,
"draw": 4,
"lost": 2,
"goals_diff": 12,
"goals_scored": 25,
"goals_against": 13,
"points": 25,
"position": 5
},
"away": {
"games_played": 14,
"won": 9,
"draw": 1,
"lost": 4,
"goals_diff": 8,
"goals_scored": 27,
"goals_against": 19,
"points": 28,
"position": 2
},
"total": 27,
"status": "Promotion",
"result": "Champions League",
"points": 53,
"recent_form": null
},
{
"position": 4,
"team_id": "2815",
"team_name": "M´gladbach",
"round": null,
"group": null,
"overall": {
"games_played": 27,
"won": 16,
"draw": 4,
"lost": 7,
"goals_diff": 19,
"goals_scored": 53,
"goals_against": 34,
"points": 52,
"position": 4
},
"home": {
"games_played": 14,
"won": 9,
"draw": 2,
"lost": 3,
"goals_diff": 12,
"goals_scored": 31,
"goals_against": 19,
"points": 29,
"position": 3
},
"away": {
"games_played": 13,
"won": 7,
"draw": 2,
"lost": 4,
"goals_diff": 7,
"goals_scored": 22,
"goals_against": 15,
"points": 23,
"position": 5
},
"total": 27,
"status": "Promotion",
"result": "Champions League",
"points": 52,
"recent_form": null
},
{
"position": 5,
"team_id": "101",
"team_name": "Leipzig",
"round": null,
"group": null,
"overall": {
"games_played": 26,
"won": 14,
"draw": 9,
"lost": 3,
"goals_diff": 36,
"goals_scored": 63,
"goals_against": 27,
"points": 51,
"position": 5
},
"home": {
"games_played": 13,
"won": 7,
"draw": 5,
"lost": 1,
"goals_diff": 19,
"goals_scored": 33,
"goals_against": 14,
"points": 26,
"position": 4
},
"away": {
"games_played": 13,
"won": 7,
"draw": 4,
"lost": 2,
"goals_diff": 17,
"goals_scored": 30,
"goals_against": 13,
"points": 25,
"position": 3
},
"total": 26,
"status": "Promotion",
"result": "Europa League",
"points": 51,
"recent_form": null
},
{
"position": 6,
"team_id": "2808",
"team_name": "Wolfsburg",
"round": null,
"group": null,
"overall": {
"games_played": 27,
"won": 10,
"draw": 9,
"lost": 8,
"goals_diff": 3,
"goals_scored": 36,
"goals_against": 33,
"points": 39,
"position": 6
},
"home": {
"games_played": 14,
"won": 4,
"draw": 6,
"lost": 4,
"goals_diff": 1,
"goals_scored": 16,
"goals_against": 15,
"points": 18,
"position": 12
},
"away": {
"games_played": 13,
"won": 6,
"draw": 3,
"lost": 4,
"goals_diff": 2,
"goals_scored": 20,
"goals_against": 18,
"points": 21,
"position": 6
},
"total": 27,
"status": "Promotion",
"result": "Europa League Qualification",
"points": 39,
"recent_form": null
},
{
"position": 7,
"team_id": "2812",
"team_name": "Freiburg",
"round": null,
"group": null,
"overall": {
"games_played": 27,
"won": 10,
"draw": 7,
"lost": 10,
"goals_diff": -2,
"goals_scored": 35,
"goals_against": 37,
"points": 37,
"position": 7
},
"home": {
"games_played": 13,
"won": 6,
"draw": 2,
"lost": 5,
"goals_diff": 1,
"goals_scored": 16,
"goals_against": 15,
"points": 20,
"position": 9
},
"away": {
"games_played": 14,
"won": 4,
"draw": 5,
"lost": 5,
"goals_diff": -3,
"goals_scored": 19,
"goals_against": 22,
"points": 17,
"position": 9
},
"total": 27,
"status": "same",
"result": null,
"points": 37,
"recent_form": null
},
{
"position": 8,
"team_id": "2816",
"team_name": "Schalke",
"round": null,
"group": null,
"overall": {
"games_played": 26,
"won": 9,
"draw": 10,
"lost": 7,
"goals_diff": -7,
"goals_scored": 33,
"goals_against": 40,
"points": 37,
"position": 8
},
"home": {
"games_played": 13,
"won": 5,
"draw": 6,
"lost": 2,
"goals_diff": 0,
"goals_scored": 18,
"goals_against": 18,
"points": 21,
"position": 7
},
"away": {
"games_played": 13,
"won": 4,
"draw": 4,
"lost": 5,
"goals_diff": -7,
"goals_scored": 15,
"goals_against": 22,
"points": 16,
"position": 10
},
"total": 26,
"status": "same",
"result": null,
"points": 37,
"recent_form": null
},
{
"position": 9,
"team_id": "2818",
"team_name": "Hoffenheim",
"round": null,
"group": null,
"overall": {
"games_played": 27,
"won": 10,
"draw": 6,
"lost": 11,
"goals_diff": -11,
"goals_scored": 36,
"goals_against": 47,
"points": 36,
"position": 9
},
"home": {
"games_played": 14,
"won": 5,
"draw": 1,
"lost": 8,
"goals_diff": -15,
"goals_scored": 19,
"goals_against": 34,
"points": 16,
"position": 13
},
"away": {
"games_played": 13,
"won": 5,
"draw": 5,
"lost": 3,
"goals_diff": 4,
"goals_scored": 17,
"goals_against": 13,
"points": 20,
"position": 7
},
"total": 27,
"status": "same",
"result": null,
"points": 36,
"recent_form": null
},
{
"position": 10,
"team_id": "2806",
"team_name": "Hertha",
"round": null,
"group": null,
"overall": {
"games_played": 27,
"won": 9,
"draw": 7,
"lost": 11,
"goals_diff": -9,
"goals_scored": 39,
"goals_against": 48,
"points": 34,
"position": 10
},
"home": {
"games_played": 14,
"won": 4,
"draw": 3,
"lost": 7,
"goals_diff": -10,
"goals_scored": 18,
"goals_against": 28,
"points": 15,
"position": 14
},
...
Season by ID#back to top
The Season by ID Endpoint gives you info about a specific Season, like their league, their year, stages, rounds.
GET Get Season By ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/seasons/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id={SEASON_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | SEASON_ID |
Response Attributes
| id | integer | The id of the season |
| name | string | The name of the season |
| is_current | boolean | Boolean if the Season is current |
| league_id | integer | The id of the league associated |
| current_round_id | integer | The id of the current round |
| rounds | object | id |
| current_stage_id | integer | The id of the current stage |
Response Example
{
"data": {
"id": "406",
"name": "19/20",
"is_current": "1",
"league_id": "594",
"current_round_id": "2019",
"round_ids": [
"255",
"1994",
"1995",
"1996",
"1997",
"1998",
"1999",
"2000",
"2001",
"2002",
"2003",
"2004",
"2005",
"2006",
"2007",
"2008",
"2009",
"2010",
"2011",
"2012",
"2013",
"2014",
"2015",
"2016",
"2017",
"2018",
"2019",
"2020",
"2021",
"2022",
"2023",
"2024",
"2025",
"2026"
],
"current_stage_id": null,
"stages": null
},
...
Stage by ID (Available soon) #back to top
The Stage by ID Endpoint gives you info about a specific Stage, like their league, season, name, rounds.
GET Get Stage By ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/stages/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id={STAGE_ID} |
| Example | https://api.soccersapi.com/v2.2/stages/?user=user1&token=Z5R9jArYsKZmHmP47&t=info&id=77444636 |
| Paginated | No, this endpoint is not paginated |
URI Params
| Name | Type | Value |
|---|---|---|
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | STAGE_ID |
Response Attributes
| id | integer | The id of the stage |
| name | string | The name of the stage |
| league_id | integer | The id of the league of the stage |
| season_id | integer | The id of the season of the stage |
| rounds | object | id, stage_id |
| groups | object | id, stage_id |
Response Example
{
"data":{
"id":77444636,
"name":"Group Stage",
"league_id":1497,
"season_id":15720,
"rounds":[
{
"id":null,
"stage_id":77444636
},
{
"id":null,
"stage_id":77444636
},
{
"id":null,
"stage_id":77444636
}
],
"groups":[
{
"id":243491,
"stage_id":77444636
},
{
"id":243492,
"stage_id":77444636
},
{
"id":243493,
"stage_id":77444636
},
{
"id":243494,
"stage_id":77444636
}
]
}
}
Rounds by Season #back to top
The Rounds by Season ID endpoint returns a list of Rounds of a single season
GETGet Rounds by Season ID
API Reference| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/rounds/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=byseason&season_id={SEASON_ID} | |
| Example | https://api.soccersapi.com/v2.2/rounds/?user=user1&token=Z5R9jArYsKZmHmP47&t=byseason&season_id=406 | |
| Paginated | No, this endpoint is not paginated |
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | byseason |
| season_id | integer | SEASON_ID |
| id | integer | The id of the round |
| name | string | The name of the round |
| league_id | integer | The league id of the round |
| season_id | integer | The season id of the round |
| is_current | boolean | If is the current season |
{
"data": [
{
"id": "1994",
"name": "1",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "1995",
"name": "2",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "1996",
"name": "3",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "1997",
"name": "4",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "1998",
"name": "5",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "1999",
"name": "6",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "2000",
"name": "7",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "2001",
"name": "8",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "2002",
"name": "9",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "2003",
"name": "10",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "2004",
"name": "11",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "2005",
"name": "12",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "2006",
"name": "13",
"league_id": "594",
"season_id": "406",
"is_current": null
},
{
"id": "2007",
"name": "14",
"league_id": "594",
"season_id": "406",
"is_current": null
},
...
Round by ID#back to top
The Round by ID endpoint returns information of a single round
GET Get Round By ID
API ReferenceDescription
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/rounds/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id={ROUND_ID} | |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | ROUND_ID |
Response
| id | integer | The id of the round |
| name | string | The name of the round |
| league_id | integer | The league id of the round |
| season_id | integer | The season id of the round |
{
"data": {
"id": "2005",
"name": "12",
"league_id": "594",
"season_id": "406",
"is_current": null
},
...
Teams by Country #back to top
The Teams by Country ID endpoint returns a list of teams from a specific country
GETGet Teams by Country ID
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/teams/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=list&country_id={COUNTRY_ID} | |
| Example | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=list&country_id=4 | |
| Paginated | Yes, 100 per page |
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | list |
| country_id | integer | COUNTRY_ID |
| id | integer | The ID of the team |
| common_name | string | The common name of the team |
| name | string | The name of the team |
| short_code | string | Short code of the team |
| img | string | Logo of the team |
| leagues | object | ID, name, current_season |
| founded | string | Year of Foundation |
| string | Twitter account | |
| coach_id | integer | The ID of the current coach |
| venue_id | integer | venue ID |
| country | object | ID, name, cc |
{
"data": [
{
"id": "98",
"name": "Borussia Dortmund",
"country_id": "4"
},
{
"id": "101",
"name": "RB Leipzig",
"country_id": "4"
},
{
"id": "111",
"name": "FC Bayern Munich",
"country_id": "4"
},
{
"id": "114",
"name": "Bayer 04 Leverkusen",
"country_id": "4"
},
{
"id": "1108",
"name": "1. Goppinger SV",
"country_id": "4"
},
{
"id": "1109",
"name": "FC 08 Villingen",
"country_id": "4"
},
{
"id": "1110",
"name": "FV Ravensburg",
"country_id": "4"
},
{
"id": "1111",
"name": "Stuttgarter Kickers",
"country_id": "4"
},
{
"id": "1112",
"name": "SSV Reutlingen 1905",
"country_id": "4"
},
{
"id": "1113",
"name": "SV Oberachern",
"country_id": "4"
},
{
"id": "1114",
"name": "FSV 08 Bissingen",
"country_id": "4"
},
{
"id": "1115",
"name": "SV Sandhausen II",
"country_id": "4"
},
{
"id": "1116",
"name": "Neckarsulm",
"country_id": "4"
},
{
"id": "1119",
"name": "SGV Freiberg",
"country_id": "4"
},
{
"id": "1120",
"name": "VfB Stuttgart II",
"country_id": "4"
},
{
"id": "1121",
"name": "FC Nottingen",
"country_id": "4"
},
{
"id": "1122",
"name": "Freiburger FC",
"country_id": "4"
},
{
"id": "1123",
"name": "1. FC Pforzheim 1896",
"country_id": "4"
},
{
"id": "1124",
"name": "1. FC Rielasingen-Arlen",
"country_id": "4"
},
{
"id": "1128",
"name": "FC Strausberg",
"country_id": "4"
},
...
Teams by Season #back to top
The Teams by Season ID endpoint returns a list of teams participants on a single season
GETGet Teams by Season ID
API Reference| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/teams/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=byseason&season_id={SEASON_ID} | |
| Example | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=byseason&season_id=406 | |
| Paginated | No, this endpoint is not paginated |
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | byseason |
| season_id | integer | SEASON_ID |
| id | integer | The id of the team |
| name | string | The name of the team |
| country_id | integer | id of the country |
{
"data": [
{
"id": "111",
"name": "B. Munich",
"country_id": "4"
},
{
"id": "101",
"name": "Leipzig",
"country_id": "4"
},
{
"id": "98",
"name": "Dortmund",
"country_id": "4"
},
{
"id": "2815",
"name": "M´gladbach",
"country_id": "4"
},
{
"id": "114",
"name": "Leverkusen",
"country_id": "4"
},
{
"id": "2816",
"name": "Schalke",
"country_id": "4"
},
{
"id": "2808",
"name": "Wolfsburg",
"country_id": "4"
},
{
"id": "2818",
"name": "Hoffenheim",
"country_id": "4"
},
{
"id": "2812",
"name": "Freiburg",
"country_id": "4"
},
{
"id": "2819",
"name": "Union Berlin",
"country_id": "4"
},
{
"id": "2817",
"name": "Frankfurt",
"country_id": "4"
},
{
"id": "2814",
"name": "Augsburg",
"country_id": "4"
},
{
"id": "2809",
"name": "Cologne",
"country_id": "4"
},
{
"id": "2806",
"name": "Hertha",
"country_id": "4"
},
...
Team by ID #back to top
The Team Info endpoint gives you data of a specific team.
GET Get Team Info By Id
API ReferenceDescription
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/teams/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id={TEAM_ID} | |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | TEAM_ID |
Response Attributes
| id | integer | The ID of the team |
| common_name | string | The common name of the team |
| name | string | The name of the team |
| short_code | string | Short code of the team |
| img | string | Logo of the team |
| leagues | object | ID, name, current_season |
| founded | string | Year of Foundation |
| string | Twitter account | |
| coach_id | integer | The ID of the current coach |
| venue_id | integer | venue ID |
| country | object | ID, name, cc |
Response Example
{
"data": {
"id": "111",
"common_name": "Bayern Munich",
"name": "FC Bayern Munich",
"short_code": "FCB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/100/111.png",
"leagues": [
{
"id": "539",
"name": "UEFA Champions League",
"current_season_id": "45"
},
{
"id": "594",
"name": "Bundesliga",
"current_season_id": "406"
},
{
"id": "595",
"name": "DFB Pokal",
"current_season_id": "1909"
},
{
"id": "539",
"name": "UEFA Champions League",
"current_season_id": "45"
},
{
"id": "3700",
"name": "MLS All Star Game",
"current_season_id": "9683"
},
{
"id": "596",
"name": "Super Cup",
"current_season_id": "8387"
},
{
"id": "515",
"name": "Audi Cup",
"current_season_id": "8694"
}
],
"founded": "1900",
"twitter": "",
"coach_id": "662",
"venue_id": "1446",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
...
Team Squad#back to top
The Team Squad endpoint gives you all players of a specific team of the current season or by Season ID
GET Get Squad By Team Id and Season ID
API ReferenceDescription
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/teams/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=squad&id={TEAM_ID}&season_id={SEASON_ID} | |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | squad |
| id | integer | TEAM_ID |
| season_id | integer | SEASON_ID |
Response Attributes
| formation | string | The standard team formation |
| squad | object | player |
| player | object | ID, name, common_name, firstname, lastname, weight, height, img, country |
| country | object | ID, name, cc |
| number | string | The number of the player |
| captain | boolean | If is captain |
| position | string | The player field position |
| order | string | The player order in formation |
{
"data": {
"formation": null,
"squad": [
{
"player": {
"id": "17322",
"name": null,
"common_name": "Neuer, Manuel",
"firstname": "Manuel Peter",
"lastname": "Neuer",
"weight": "92",
"height": "193",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/17322.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "1",
"captain": null,
"position": "G",
"order": null
},
{
"player": {
"id": "17331",
"name": null,
"common_name": "Martinez, Javi",
"firstname": "Javier",
"lastname": "Martinez Aguinaga",
"weight": "86",
"height": "192",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/17331.png",
"country": {
"id": "5",
"name": "Spain",
"cc": "es"
}
},
"number": "8",
"captain": null,
"position": "D",
"order": null
},
{
"player": {
"id": "17324",
"name": null,
"common_name": "Boateng, Jerome",
"firstname": "Jerome Agyenim",
"lastname": "Boateng",
"weight": "90",
"height": "192",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/17324.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "17",
"captain": null,
"position": "D",
"order": null
},
{
"player": {
"id": "17330",
"name": null,
"common_name": "Ulreich, Sven",
"firstname": "Sven",
"lastname": "Ulreich",
"weight": "87",
"height": "192",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/17330.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "26",
"captain": null,
"position": "G",
"order": null
},
{
"player": {
"id": "17327",
"name": null,
"common_name": "Muller, Thomas",
"firstname": "Thomas",
"lastname": "Muller",
"weight": "75",
"height": "186",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/17327.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "25",
"captain": null,
"position": "F",
"order": null
},
{
"player": {
"id": "19994",
"name": null,
"common_name": "Perisic, Ivan",
"firstname": "Ivan",
"lastname": "Perisic",
"weight": "81",
"height": "186",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/19994.png",
"country": {
"id": "34",
"name": "Croatia",
"cc": "hr"
}
},
"number": "14",
"captain": null,
"position": "M",
"order": null
},
{
"player": {
"id": "19988",
"name": null,
"common_name": "Lewandowski, Robert",
"firstname": "Robert",
"lastname": "Lewandowski",
"weight": "79",
"height": "185",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/19988.png",
"country": {
"id": "95",
"name": "Poland",
"cc": "pl"
}
},
"number": "9",
"captain": null,
"position": "F",
"order": null
},
{
"player": {
"id": "17328",
"name": null,
"common_name": "Alcantara, Thiago",
"firstname": "Thiago",
"lastname": "Alcantara do Nascimento",
"weight": "70",
"height": "174",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/17328.png",
"country": {
"id": "5",
"name": "Spain",
"cc": "es"
}
},
"number": "6",
"captain": null,
"position": "M",
"order": null
},
{
"player": {
"id": "17325",
"name": null,
"common_name": "Alaba, David",
"firstname": "David",
"lastname": "Alaba",
"weight": "78",
"height": "180",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/17325.png",
"country": {
"id": "15",
"name": "Austria",
"cc": "at"
}
},
"number": "27",
"captain": null,
"position": "D",
"order": null
},
{
"player": {
"id": "17329",
"name": null,
"common_name": "Coutinho, Philippe",
"firstname": "Philippe",
"lastname": "Coutinho Correia",
"weight": "68",
"height": "172",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/17329.png",
"country": {
"id": "25",
"name": "Brazil",
"cc": "br"
}
},
"number": "10",
"captain": null,
"position": "M",
"order": null
},
{
"player": {
"id": "23895",
"name": null,
"common_name": "Sule, Niklas",
"firstname": "Niklas",
"lastname": "Sule",
"weight": null,
"height": null,
"img": "https://cdn.soccersapi.com/images/soccer/players/50/23895.png",
"country": {
"id": null,
"name": null,
"cc": null
}
},
"number": "4",
"captain": null,
"position": "D",
"order": null
},
{
"player": {
"id": "14514",
"name": null,
"common_name": "Wriedt, Kwasi Okyere",
"firstname": "Kwasi Okyere",
"lastname": "Wriedt",
"weight": "82",
"height": "188",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/14514.png",
"country": {
"id": "48",
"name": "Ghana",
"cc": "gh"
}
},
"number": "38",
"captain": null,
"position": "F",
"order": null
},
...
Team Transfers#back to top
The Team Transfers endpoint returns the transfers (IN, OUT) of a specific team
GETGet Transfers By Team Id
API Reference| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/teams/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&transfers&id={TEAM_ID}&season_id={SEASON_ID} | |
| Example | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=transfers&id=52&season_id=16074 | |
| Paginated | No, this endpoint is not paginated |
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | transfers |
| id | integer | TEAM_ID |
| season_id | integer | SEASON_ID |
| player_id | integer | The id of the player |
| from_team_id | string | The team where it comes from |
| to_team_id | string | The team where it comes from |
| id_current_season | string | Current Season |
| id_current_stage | string | Current Stage |
| id_current_round | string | Current Round |
| ound | object | id, name, cc |
| seasons | object | id, name, is_current |
{
"data": {
"arrivals": [
{
"player": {
"id": null,
"name": "Lucas Hernández"
},
"team_left": {
"id": "107",
"name": "Atletico Madrid"
},
"type": null,
"date": null,
"fee": "$88.00m"
},
{
"player": {
"id": null,
"name": "Benjamin Pavard"
},
"team_left": {
"id": "2849",
"name": "VfB Stuttgart"
},
"type": null,
"date": null,
"fee": "$38.50m"
},
{
"player": {
"id": null,
"name": "Michaël Cuisance"
},
"team_left": {
"id": "2815",
"name": "Borussia Monchengladbach"
},
"type": null,
"date": null,
"fee": "$13.20m"
},
...
Team Sidelined#back to top
The Team Sidelined endpoint return data about injuried players.
GETGet Sidelined By Team Id
API Reference| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/teams/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=sidelined&id={TEAM_ID} |
| Example | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=sidelined&id=111 |
| Paginated | No, this endpoint is not paginated |
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | sidelined |
| id | integer | TEAM_ID |
{
"data": {
"id": "111",
"name": "Bayern Munich",
"types": {
"injuries": [
{
"player": {
"id": "8329",
"name": "Tolisso, Corentin"
},
"reason": "Ankle Surgery",
"since": "2020-04-20",
"expected_return": "2020-06-30"
},
{
"player": {
"id": "17329",
"name": "Coutinho, Philippe"
},
"reason": "Ankle problems",
"since": "2020-04-24",
"expected_return": "2020-06-07"
},
{
"player": {
"id": "23895",
"name": "Sule, Niklas"
},
"reason": "Fitness",
"since": "2020-05-18",
"expected_return": "2020-05-31"
}
]
}
},
...
Team Trophies#back to top
The Team Trophies endpoint returns data about how many and which trophies has won the specified team along his history.
GETGet Trophies By Team Id
API Reference| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/teams/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=trophies&id={TEAM_ID} |
| Example | https://api.soccersapi.com/v2.2/teams/?user=user1&token=Z5R9jArYsKZmHmP47&t=trophies&id=111 |
| Paginated | No, this endpoint is not paginated |
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | trophies |
| id | integer | TEAM_ID |
{
"data": {
"season_id": "111",
"trophies": [
{
"id": 19,
"name": "German Supercup Runner Up",
"seasons": [
"19/20",
"15/16",
"14/15",
"13/14",
"94/95",
"89/90"
]
},
{
"id": 20,
"name": "Champions League Participant",
"seasons": [
"19/20",
"18/19",
"17/18",
"16/17",
"15/16",
"14/15",
"13/14",
"12/13",
"11/12",
"10/11",
...
Livescores Today#back to top
The Livescores today Endpoint gives you a list of matches will play today. (From the leagues available in your plan)
GETGet Today Matches
API ReferenceDescription
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/livescores/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=today | |
| Example | https://api.soccersapi.com/v2.2/livescores/?user=user1&token=Z5R9jArYsKZmHmP47&t=today | |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | today |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| pitch | string | Pith of event |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| stage_id | integer | Pith of event |
| group_id | integer | Id of the group for Cups |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | Sometimes this parameter is needed |
| venue_id | integer | Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(playing), timestamp, timezone |
| teams | object | home(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors) |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| weather_report | object | Weather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...) |
Response Example
{
"data": [
{
"id": "21294795",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "30333",
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 00:15:00",
"date": "2020-05-20",
"time": "00:15:00",
"minute": 90,
"timestamp": 1589926500,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18966",
"name": "Colo Colo SRL",
"short_code": "COC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18966.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18967",
"name": "Penarol Montevideo SRL",
"short_code": "PEN",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18967.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": "2",
"away_score": "0",
"ht_score": "1-0",
"ft_score": "2-0",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21294798",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "30333",
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 00:15:00",
"date": "2020-05-20",
"time": "00:15:00",
"minute": 90,
"timestamp": 1589926500,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18968",
"name": "Defensa Justicia SRL",
"short_code": "DEF",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18968.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18969",
"name": "Delfin SC SRL",
"short_code": "DEL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18969.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": "3",
"away_score": "0",
"ht_score": "1-0",
"ft_score": "3-0",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21294802",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "30333",
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 00:15:00",
"date": "2020-05-20",
"time": "00:15:00",
"minute": 90,
"timestamp": 1589926500,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18970",
"name": "Jorge Wilstermann SRL",
"short_code": "WIL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18970.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18971",
"name": "CA Paranaense PR SRL",
"short_code": "PAR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18971.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": "0",
"away_score": "1",
"ht_score": "0-0",
"ft_score": "0-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
...
Livescores Tomorrow#back to top
The Livescores Tomorrow Endpoint gives you a list of matches will play tomorrow. (From the leagues available in your plan)
GETGet Tomorrow Matches
API ReferenceDescription
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/livescores/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=tomorrow | |
| Example | https://api.soccersapi.com/v2.2/livescores/?user=user1&token=Z5R9jArYsKZmHmP47&t=tomorrow | |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | tomorrow |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| pitch | string | Pith of event |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| stage_id | integer | Pith of event |
| group_id | integer | Id of the group for Cups |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | Sometimes this parameter is needed |
| venue_id | integer | Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(playing), timestamp, timezone |
| teams | object | home(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors) |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| weather_report | object | Weather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...) |
Response Example
{
"data": [
{
"id": "21498371",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-21 00:15:00",
"date": "2020-05-21",
"time": "00:15:00",
"minute": null,
"timestamp": 1590012900,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18978",
"name": "Estudiantes de Merida SRL",
"short_code": "MER",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18978.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18979",
"name": "Alianza Lima SRL",
"short_code": "ALI",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18979.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21498374",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-21 00:15:00",
"date": "2020-05-21",
"time": "00:15:00",
"minute": null,
"timestamp": 1590012900,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18980",
"name": "Racing Club Avellaneda SRL",
"short_code": "AVE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18980.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18981",
"name": "Club Nacional de Football SRL",
"short_code": "NAC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18981.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21498375",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-21 00:15:00",
"date": "2020-05-21",
"time": "00:15:00",
"minute": null,
"timestamp": 1590012900,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18982",
"name": "SC Internacional RS SRL",
"short_code": "INT",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18982.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18983",
"name": "America de Cali SRL",
"short_code": "AME",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18983.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21528970",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-21 02:30:00",
"date": "2020-05-21",
"time": "02:30:00",
"minute": null,
"timestamp": 1590021000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18984",
"name": "CD Universidad Catolica SRL",
"short_code": "CAT",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18984.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18985",
"name": "Gremio FB Porto Alegrense RS SRL",
"short_code": "GRE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18985.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21528972",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-21 02:30:00",
"date": "2020-05-21",
"time": "02:30:00",
"minute": null,
"timestamp": 1590021000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18986",
"name": "Club Bolivar SRL",
"short_code": "BOL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18986.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18987",
"name": "SE Palmeiras SP SRL",
"short_code": "PAL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18987.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21528975",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-21 02:30:00",
"date": "2020-05-21",
"time": "02:30:00",
"minute": null,
"timestamp": 1590021000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18988",
"name": "Independiente Medellin SRL",
"short_code": "MED",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18988.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18989",
"name": "Caracas FC SRL",
"short_code": "CAR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18989.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
...
Livescores Yesterday#back to top
The Livescores Yesterday Endpoint gives you a list of matches has play tomorrow. (From the leagues available in your plan)
GETGet yesterday Matches
API ReferenceDescription
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/livescores/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=yesterday | |
| Example | https://api.soccersapi.com/v2.2/livescores/?user=user1&token=Z5R9jArYsKZmHmP47&t=yesterday | |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | yesterday |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| pitch | string | Pith of event |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| stage_id | integer | Pith of event |
| group_id | integer | Id of the group for Cups |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | Sometimes this parameter is needed |
| venue_id | integer | Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(playing), timestamp, timezone |
| teams | object | home(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors) |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| weather_report | object | Weather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...) |
Response Example
{
"data": [
{
"id": "21498371",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-21 00:15:00",
"date": "2020-05-21",
"time": "00:15:00",
"minute": null,
"timestamp": 1590012900,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18978",
"name": "Estudiantes de Merida SRL",
"short_code": "MER",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18978.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18979",
"name": "Alianza Lima SRL",
"short_code": "ALI",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18979.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21498374",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-21 00:15:00",
"date": "2020-05-21",
"time": "00:15:00",
"minute": null,
"timestamp": 1590012900,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18980",
"name": "Racing Club Avellaneda SRL",
"short_code": "AVE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18980.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18981",
"name": "Club Nacional de Football SRL",
"short_code": "NAC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18981.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21498375",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-21 00:15:00",
"date": "2020-05-21",
"time": "00:15:00",
"minute": null,
"timestamp": 1590012900,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18982",
"name": "SC Internacional RS SRL",
"short_code": "INT",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18982.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18983",
"name": "America de Cali SRL",
"short_code": "AME",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18983.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21528970",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-21 02:30:00",
"date": "2020-05-21",
"time": "02:30:00",
"minute": null,
"timestamp": 1590021000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18984",
"name": "CD Universidad Catolica SRL",
"short_code": "CAT",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18984.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18985",
"name": "Gremio FB Porto Alegrense RS SRL",
"short_code": "GRE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18985.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21528972",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-21 02:30:00",
"date": "2020-05-21",
"time": "02:30:00",
"minute": null,
"timestamp": 1590021000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18986",
"name": "Club Bolivar SRL",
"short_code": "BOL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18986.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18987",
"name": "SE Palmeiras SP SRL",
"short_code": "PAL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18987.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
...
Livescores Inplay#back to top
The Livescores Inplay Endpoint gives you a list of matches playing now. (From the leagues available in your plan)
GETGet Inplay Matches
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/livescores/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=live |
| Example | https://api.soccersapi.com/v2.2/livescores/?user=user1&token=Z5R9jArYsKZmHmP47&t=live |
| Paginated | No, this endpoint is not paginated |
URI Paramters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | live |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| pitch | string | Pith of event |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| stage_id | integer | Pith of event |
| group_id | integer | Id of the group for Cups |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | Sometimes this parameter is needed |
| venue_id | integer | Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(playing), timestamp, timezone |
| teams | object | home(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors) |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| weather_report | object | Weather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...) |
Response Example
{
"data": [
{
"id": "21489676",
"status": 1,
"status_name": "Inplay",
"status_period": "1st Half",
"pitch": null,
"referee_id": null,
"round_id": "29445",
"season_id": "8579",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "569",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 16:00:00",
"date": "2020-05-20",
"time": "16:00:00",
"minute": "20",
"timestamp": 1589983200,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "1651",
"name": "SK Dynamo Ceske Budejovice",
"short_code": "BUD",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/1651.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "76",
"name": "FC Viktoria Plzen",
"short_code": "VIK",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/76.png",
"form": null,
"coach_id": "2350",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "520",
"name": "Club Friendly",
"type": "",
"country_id": "2",
"country_name": "International Clubs",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/.png"
},
"scores": {
"home_score": "1",
"away_score": "1",
"ht_score": "",
"ft_score": "1-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": "",
"away_position": ""
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
}
],
...
Livescores Not Started#back to top
The Livescores Not Started Endpoint gives you a list of matches will play today and have not started. (From the leagues available in your plan)
GETGet Not Started Matches
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/livescores/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=notstarted |
| Example | https://api.soccersapi.com/v2.2/livescores/?user=user1&token=Z5R9jArYsKZmHmP47&t=notstarted |
| Paginated | No, this endpoint is not paginated |
URI Paramters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | notstarted |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| pitch | string | Pith of event |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| stage_id | integer | Pith of event |
| group_id | integer | Id of the group for Cups |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | Sometimes this parameter is needed |
| venue_id | integer | Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(playing), timestamp, timezone |
| teams | object | home(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors) |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| weather_report | object | Weather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...) |
Response Example
{
"data": [
{
"id": "21489766",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "30333",
"season_id": "4600482",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 21:00:00",
"date": "2020-05-20",
"time": "21:00:00",
"minute": 90,
"timestamp": 1590001200,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18699",
"name": "FC Bayern Munich SRL",
"short_code": "FCB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18699.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18797",
"name": "Olympique Lyonnais",
"short_code": "OL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18797.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "UEFA Champions League SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "15163896",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": "371",
"round_id": "30152",
"season_id": "1186309",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "3340",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 18:00:00",
"date": "2020-05-20",
"time": "18:00:00",
"minute": 90,
"timestamp": 1589990400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2996",
"name": "FC Brest",
"short_code": "BRE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2996.png",
"form": "",
"coach_id": "1925",
"color": null,
"kit_colors": null
},
"away": {
"id": "62",
"name": "FC BATE Borisov",
"short_code": "BAT",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/62.png",
"form": "",
"coach_id": "1918",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "1080",
"name": "Vysshaya Liga",
"type": "Vysshaya League",
"country_id": "20",
"country_name": "Belarus",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/by.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
{
"id": "20315158",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "11442",
"season_id": "11157",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1104",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 23:00:00",
"date": "2020-05-20",
"time": "23:00:00",
"minute": 90,
"timestamp": 1590008400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "9191",
"name": "AD Municipal Grecia",
"short_code": "GRE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/9191.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "9195",
"name": "Perez Zeledon",
"short_code": "ZEL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/9195.png",
"form": null,
"coach_id": "1868",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "1518",
"name": "Primera Division - Clausura",
"type": "",
"country_id": "33",
"country_name": "Costa Rica",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/cr.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "20315161",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "11442",
"season_id": "11157",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1105",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 23:00:00",
"date": "2020-05-20",
"time": "23:00:00",
"minute": 90,
"timestamp": 1590008400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "9188",
"name": "Universidad de Costa Rica",
"short_code": "COR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/9188.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "9190",
"name": "Santos de Guapiles",
"short_code": "SDG",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/9190.png",
"form": null,
"coach_id": "1868",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "1518",
"name": "Primera Division - Clausura",
"type": "",
"country_id": "33",
"country_name": "Costa Rica",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/cr.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "15163330",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": "1770",
"round_id": "2969",
"season_id": "1366",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "3034",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 18:00:00",
"date": "2020-05-20",
"time": "18:00:00",
"minute": 90,
"timestamp": 1589990400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "3048",
"name": "JK Tallinna Kalev",
"short_code": "KAL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/3048.png",
"form": null,
"coach_id": "5666",
"color": null,
"kit_colors": null
},
"away": {
"id": "3045",
"name": "JK Narva Trans",
"short_code": "NAR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/3045.png",
"form": null,
"coach_id": "1738",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "1732",
"name": "Meistriliiga",
"type": "",
"country_id": "43",
"country_name": "Estonia",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/ee.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "15163326",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": "1552",
"round_id": "2969",
"season_id": "1366",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "2435",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 18:30:00",
"date": "2020-05-20",
"time": "18:30:00",
"minute": 90,
"timestamp": 1589992200,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "3043",
"name": "FC Flora Tallinn",
"short_code": "FLO",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/3043.png",
"form": null,
"coach_id": "1703",
"color": null,
"kit_colors": null
},
"away": {
"id": "3050",
"name": "Tartu JK Tammeka",
"short_code": "TAR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/3050.png",
"form": null,
"coach_id": "1848",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "1732",
"name": "Meistriliiga",
"type": "",
"country_id": "43",
"country_name": "Estonia",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/ee.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21632105",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "29445",
"season_id": "8579",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "4838",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 16:30:00",
"date": "2020-05-20",
"time": "16:30:00",
"minute": "22",
"timestamp": 1589985000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2006",
"name": "NK Istra 1961",
"short_code": "IST",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2006.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "2025",
"name": "HNK Gorica",
"short_code": "GOR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2025.png",
"form": null,
"coach_id": "2350",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "520",
"name": "Club Friendly",
"type": "",
"country_id": "2",
"country_name": "International Clubs",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21604047",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "29445",
"season_id": "8579",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "3013",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 17:00:00",
"date": "2020-05-20",
"time": "17:00:00",
"minute": "22",
"timestamp": 1589986800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "1326",
"name": "FC Hradec Kralove",
"short_code": "HRK",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/1326.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "1593",
"name": "FK Nachod",
"short_code": "FK ",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/1593.png",
"form": null,
"coach_id": "2350",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "520",
"name": "Club Friendly",
"type": "",
"country_id": "2",
"country_name": "International Clubs",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21489678",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "29445",
"season_id": "8579",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "436",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 17:30:00",
"date": "2020-05-20",
"time": "17:30:00",
"minute": 90,
"timestamp": 1589988600,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2108",
"name": "FK Vojvodina",
"short_code": "VOJ",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2108.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "2109",
"name": "OFK Backa Palanka",
"short_code": "BAP",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2109.png",
"form": null,
"coach_id": "2350",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "520",
"name": "Club Friendly",
"type": "",
"country_id": "2",
"country_name": "International Clubs",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21489721",
"status": 0,
"status_name": "Notstarted",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "30331",
"season_id": "4852790",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 18:00:00",
"date": "2020-05-20",
"time": "18:00:00",
"minute": 90,
"timestamp": 1589990400,
"timezone": "UTC"
},
...
Livescores Ended#back to top
The Livescores Ended Endpoint gives you a list of matches will play today and has ended. (From the leagues available in your plan)
GETGet Ended Matches
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/livescores/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=ended |
| Example | https://api.soccersapi.com/v2.2/livescores/?user=user1&token=Z5R9jArYsKZmHmP47&t=ended |
| Paginated | No, this endpoint is not paginated |
URI Paramters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | ended |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| pitch | string | Pith of event |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| stage_id | integer | Pith of event |
| group_id | integer | Id of the group for Cups |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | Sometimes this parameter is needed |
| venue_id | integer | Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(playing), timestamp, timezone |
| teams | object | home(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors) |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| weather_report | object | Weather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...) |
Response Example
{
"data": [
{
"id": "21294795",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "30333",
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 00:15:00",
"date": "2020-05-20",
"time": "00:15:00",
"minute": 90,
"timestamp": 1589926500,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18966",
"name": "Colo Colo SRL",
"short_code": "COC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18966.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18967",
"name": "Penarol Montevideo SRL",
"short_code": "PEN",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18967.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": "2",
"away_score": "0",
"ht_score": "1-0",
"ft_score": "2-0",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21294798",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "30333",
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 00:15:00",
"date": "2020-05-20",
"time": "00:15:00",
"minute": 90,
"timestamp": 1589926500,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18968",
"name": "Defensa Justicia SRL",
"short_code": "DEF",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18968.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18969",
"name": "Delfin SC SRL",
"short_code": "DEL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18969.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": "3",
"away_score": "0",
"ht_score": "1-0",
"ft_score": "3-0",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21294802",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "30333",
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 00:15:00",
"date": "2020-05-20",
"time": "00:15:00",
"minute": 90,
"timestamp": 1589926500,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18970",
"name": "Jorge Wilstermann SRL",
"short_code": "WIL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18970.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18971",
"name": "CA Paranaense PR SRL",
"short_code": "PAR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18971.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": "0",
"away_score": "1",
"ht_score": "0-0",
"ft_score": "0-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21317072",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "30333",
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 02:30:00",
"date": "2020-05-20",
"time": "02:30:00",
"minute": 90,
"timestamp": 1589934600,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18972",
"name": "EM Deportivo Binacional SRL",
"short_code": "BIN",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18972.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18973",
"name": "LDU Quito SRL",
"short_code": "LDU",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18973.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": "0",
"away_score": "3",
"ht_score": "0-2",
"ft_score": "0-3",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21317075",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "30333",
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 02:30:00",
"date": "2020-05-20",
"time": "02:30:00",
"minute": 90,
"timestamp": 1589934600,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18974",
"name": "Santos SRL",
"short_code": "SAN",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18974.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18975",
"name": "Olimpia SRL",
"short_code": "OLI",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18975.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": "1",
"away_score": "2",
"ht_score": "1-0",
"ft_score": "1-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21317078",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "30333",
"season_id": "17170743",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 02:30:00",
"date": "2020-05-20",
"time": "02:30:00",
"minute": 90,
"timestamp": 1589934600,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18976",
"name": "Sao Paulo FC SP SRL",
"short_code": "SAP",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18976.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18977",
"name": "CA River Plate SRL",
"short_code": "RIV",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18977.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": null,
"name": null,
"type": "Copa Libertadores SRL",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": "1",
"away_score": "2",
"ht_score": "1-0",
"ft_score": "1-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "20315155",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "11442",
"season_id": "11157",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1103",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 04:00:00",
"date": "2020-05-20",
"time": "04:00:00",
"minute": 90,
"timestamp": 1589940000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "9189",
"name": "CS Cartagines",
"short_code": "CAR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/9189.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "9194",
"name": "Liga Deportiva Alajuelense",
"short_code": "ALA",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/9194.png",
"form": null,
"coach_id": "1868",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "1518",
"name": "Primera Division - Clausura",
"type": "",
"country_id": "33",
"country_name": "Costa Rica",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/cr.png"
},
"scores": {
"home_score": "0",
"away_score": "2",
"ht_score": "0-1",
"ft_score": "0-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "21489675",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": "29445",
"season_id": "8579",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "2895",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-20 11:00:00",
"date": "2020-05-20",
"time": "11:00:00",
"minute": 90,
"timestamp": 1589965200,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "1324",
"name": "Zbrojovka Brno",
"short_code": "BRN",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/1324.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "1646",
"name": "FC Fastav Zlin",
"short_code": "FCZ",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/1646.png",
"form": null,
"coach_id": "2350",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "520",
"name": "Club Friendly",
"type": "",
"country_id": "2",
"country_name": "International Clubs",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/.png"
},
"scores": {
"home_score": "0",
"away_score": "5",
"ht_score": "0-1",
"ft_score": "0-5",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
}
],
...
Fixtures by Date#back to top
The Fixtures by Date Endpoint gives you fixtures from a specific date.
GETGet Fixtures By date
Description
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=schedule&d={YYYY-MM-DD} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | schedule |
| d | date | YYYY-MM-DD |
| page | integer | PAGE_NUMBER |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| pitch | string | pitch conditions |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| stage_id | integer | Pith of event |
| group_id | integer | Id of the group for Cups |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | Sometimes this parameter is needed |
| venue_id | integer | Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(playing), timestamp, timezone |
| teams | object | home(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors) |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| weather_report | object | Weather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...) |
Response Example
{
"data": [
{
"id": "15006764",
"status": "5",
"status_name": "Canceled",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "60501",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "3293",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 10:30:00",
"date": "2020-05-16",
"time": "10:30:00",
"minute": 90,
"timestamp": 1589617800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18410",
"name": "Asia Euro United FC",
"short_code": "AEU",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18410.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "14637",
"name": "Nagaworld FC",
"short_code": "NAG",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/14637.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": "4126",
"name": "Cambodian Premier League",
"type": "",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "15006766",
"status": "5",
"status_name": "Canceled",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "60501",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "2892",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 10:30:00",
"date": "2020-05-16",
"time": "10:30:00",
"minute": 90,
"timestamp": 1589617800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "18447",
"name": "Kirivong Soksen Chey",
"short_code": "KSC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18447.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18409",
"name": "National Defense Ministry FC",
"short_code": "NDM",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18409.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": "4126",
"name": "Cambodian Premier League",
"type": "",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "15006769",
"status": "5",
"status_name": "Canceled",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "60501",
"season_name": "2020",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "2892",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 13:00:00",
"date": "2020-05-16",
"time": "13:00:00",
"minute": 90,
"timestamp": 1589626800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "14643",
"name": "Phnom Penh",
"short_code": "PHN",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/14643.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
},
"away": {
"id": "18411",
"name": "Soltilo Angkor FC",
"short_code": "SOA",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/18411.png",
"form": null,
"coach_id": null,
"color": null,
"kit_colors": null
}
},
"league": {
"id": "4126",
"name": "Cambodian Premier League",
"type": "",
"country_id": null,
"country_name": null,
"country_flag": null
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "59455",
"status": "4",
"status_name": "Postponed",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "7991",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "628",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 15:00:00",
"date": "2020-05-16",
"time": "15:00:00",
"minute": 90,
"timestamp": 1589634000,
"timezone": "UTC"
},
...
Fixtures by Date / Country#back to top
The Fixtures by Date / Country Endpoint fixtures from a single country on a specific date
GETGet Fixtures By Date and Country ID
API Reference| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER}&token={YOUR_TOKEN}&t=schedule&d={YYYY-MM-DD}&country_id={COUNTRY_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | schedule |
| d | date | YYYY-MM-DD |
| country_id | integer | COUNTRY_ID |
| page | integer | PAGE_NUMBER |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| pitch | string | pitch conditions |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| stage_id | integer | Pith of event |
| group_id | integer | Id of the group for Cups |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | Sometimes this parameter is needed |
| venue_id | integer | Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(playing), timestamp, timezone |
| teams | object | home(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors) |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| weather_report | object | Weather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...) |
Response Example
{
"data": [
{
"id": "15006925",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "224",
"round_id": null,
"season_id": "613",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "791",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 13:00:00",
"date": "2020-05-16",
"time": "13:00:00",
"minute": 90,
"timestamp": 1589626800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2862",
"name": "Erzgebirge Aue",
"short_code": "AUE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2862.png",
"form": "3-4-1-2",
"coach_id": "694",
"color": null,
"kit_colors": null
},
"away": {
"id": "2854",
"name": "SV Sandhausen",
"short_code": "SVS",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2854.png",
"form": "4-5-1",
"coach_id": "693",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "592",
"name": "2. Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "3",
"away_score": "1",
"ht_score": "1-0",
"ft_score": "3-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
{
"id": "15006928",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "81",
"round_id": null,
"season_id": "613",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "789",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 13:00:00",
"date": "2020-05-16",
"time": "13:00:00",
"minute": 90,
"timestamp": 1589626800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2864",
"name": "Karlsruher SC",
"short_code": "KSC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2864.png",
"form": "4-2-3-1",
"coach_id": "690",
"color": null,
"kit_colors": null
},
"away": {
"id": "2858",
"name": "SV Darmstadt 1898",
"short_code": "DAR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2858.png",
"form": "4-5-1",
"coach_id": "692",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "592",
"name": "2. Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "2",
"away_score": "0",
"ht_score": "0-0",
"ft_score": "2-0",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
{
"id": "15006930",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "580",
"round_id": null,
"season_id": "613",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "286",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 13:00:00",
"date": "2020-05-16",
"time": "13:00:00",
"minute": 90,
"timestamp": 1589626800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2859",
"name": "SSV Jahn Regensburg",
"short_code": "JRE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2859.png",
"form": "",
"coach_id": "260",
"color": null,
"kit_colors": null
},
"away": {
"id": "2853",
"name": "Holstein Kiel",
"short_code": "HOK",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2853.png",
"form": "",
"coach_id": "695",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "592",
"name": "2. Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "2",
"away_score": "2",
"ht_score": "0-1",
"ft_score": "2-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
{
"id": "15006932",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "453",
"round_id": null,
"season_id": "613",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1171",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 13:00:00",
"date": "2020-05-16",
"time": "13:00:00",
"minute": 90,
"timestamp": 1589626800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2860",
"name": "VfL Bochum",
"short_code": "BOC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2860.png",
"form": "4-2-3-1",
"coach_id": "974",
"color": null,
"kit_colors": null
},
"away": {
"id": "2856",
"name": "1. FC Heidenheim 1846",
"short_code": "HEI",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2856.png",
"form": "4-3-1-2",
"coach_id": "1239",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "592",
"name": "2. Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "3",
"away_score": "0",
"ht_score": "2-0",
"ft_score": "3-0",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
{
"id": "48522",
"status": "4",
"status_name": "Postponed",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "3223",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1732",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 13:30:00",
"date": "2020-05-16",
"time": "13:30:00",
"minute": 90,
"timestamp": 1589628600,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "3162",
"name": "FC Wurzburger Kickers",
"short_code": "FWK",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/3162.png",
"form": "",
"coach_id": "1276",
"color": null,
"kit_colors": null
},
"away": {
"id": "3173",
"name": "Hallescher FC",
"short_code": "HFC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/3173.png",
"form": "",
"coach_id": "282",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "593",
"name": "3. Liga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
{
"id": "48523",
"status": "4",
"status_name": "Postponed",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "3223",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1733",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 13:30:00",
"date": "2020-05-16",
"time": "13:30:00",
"minute": 90,
"timestamp": 1589628600,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "3155",
"name": "1 FC Kaiserslautern",
"short_code": "FCK",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/3155.png",
"form": "",
"coach_id": "265",
"color": null,
"kit_colors": null
},
"away": {
"id": "3846",
"name": "FC Bayern Munich II",
"short_code": "FCB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/3846.png",
"form": "",
"coach_id": "985",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "593",
"name": "3. Liga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
{
"id": "48524",
"status": "4",
"status_name": "Postponed",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "3223",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1731",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 13:30:00",
"date": "2020-05-16",
"time": "13:30:00",
"minute": 90,
"timestamp": 1589628600,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "3172",
"name": "MSV Duisburg",
"short_code": "MSV",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/3172.png",
"form": "",
"coach_id": "785",
"color": null,
"kit_colors": null
},
"away": {
"id": "3841",
"name": "SpVgg Unterhaching",
"short_code": "UHA",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/3841.png",
"form": "",
"coach_id": "270",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "593",
"name": "3. Liga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
...
Fixtures by Date / League (Current Season)#back to top
The Fixtures by Date / League Endpoint return fixtures of the current season from a single league and specific date
GETGet Fixtures By Date and League ID
API Reference| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER}&token={YOUR_TOKEN}&t=schedule&d={YYYY-MM-DD}&league_id={LEAGUE_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | schedule |
| d | date | YYYY-MM-DD |
| country_id | integer | COUNTRY_ID |
| page | integer | PAGE_NUMBER |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| pitch | string | pitch conditions |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| stage_id | integer | Pith of event |
| group_id | integer | Id of the group for Cups |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | Sometimes this parameter is needed |
| venue_id | integer | Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(playing), timestamp, timezone |
| teams | object | home(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors) |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| weather_report | object | Weather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...) |
Response Example
{
"data": [
{
"id": "31459",
"status": "4",
"status_name": "Postponed",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1216",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 15:30:00",
"date": "2020-05-16",
"time": "15:30:00",
"minute": 90,
"timestamp": 1589635800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "98",
"name": "Borussia Dortmund",
"short_code": "BVB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/98.png",
"form": "3-4-3",
"coach_id": "1007",
"color": null,
"kit_colors": null
},
"away": {
"id": "2818",
"name": "TSG 1899 Hoffenheim",
"short_code": "TSG",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2818.png",
"form": "3-4-3",
"coach_id": "61",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
{
"id": "31460",
"status": "4",
"status_name": "Postponed",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1386",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 15:30:00",
"date": "2020-05-16",
"time": "15:30:00",
"minute": 90,
"timestamp": 1589635800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "114",
"name": "Bayer 04 Leverkusen",
"short_code": "B04",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/114.png",
"form": "4-2-3-1",
"coach_id": "54",
"color": null,
"kit_colors": null
},
"away": {
"id": "2813",
"name": "1. FSV Mainz 05",
"short_code": "M05",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2813.png",
"form": "3-4-3",
"coach_id": "663",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
{
"id": "31461",
"status": "4",
"status_name": "Postponed",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1622",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 15:30:00",
"date": "2020-05-16",
"time": "15:30:00",
"minute": 90,
"timestamp": 1589635800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2815",
"name": "Borussia Monchengladbach",
"short_code": "BMG",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2815.png",
"form": "4-2-3-1",
"coach_id": "64",
"color": null,
"kit_colors": null
},
"away": {
"id": "2806",
"name": "Hertha BSC",
"short_code": "BSC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
"form": "4-2-3-1",
"coach_id": "2681",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
...
Fixtures by Date / Season#back to top
The Fixtures by Date / Season Endpoint gives you fixtures from a single season on a specific date
GETGet Fixtures By Date and Season ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER}&token={YOUR_TOKEN}&t=schedule&d={YYYY-MM-DD}&season_id={SEASON_ID} |
| Example | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=schedule&d=2020-05-16&season_id=406 |
| Paginated | Yes, 100 per page |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | season |
| d | date | YYYY-MM-DD |
| id | integer | SEASON_ID |
| page | integer | PAGE_NUMBER |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| pitch | string | pitch conditions |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| stage_id | integer | Pith of event |
| group_id | integer | Id of the group for Cups |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | Sometimes this parameter is needed |
| venue_id | integer | Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(playing), timestamp, timezone |
| teams | object | home(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors) |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| weather_report | object | Weather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...) |
Response Example
{
"data": [
{
"id": "31459",
"status": "4",
"status_name": "Postponed",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1216",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 15:30:00",
"date": "2020-05-16",
"time": "15:30:00",
"minute": 90,
"timestamp": 1589635800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "98",
"name": "Borussia Dortmund",
"short_code": "BVB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/98.png",
"form": "3-4-3",
"coach_id": "1007",
"color": null,
"kit_colors": null
},
"away": {
"id": "2818",
"name": "TSG 1899 Hoffenheim",
"short_code": "TSG",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2818.png",
"form": "3-4-3",
"coach_id": "61",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
{
"id": "31460",
"status": "4",
"status_name": "Postponed",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1386",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 15:30:00",
"date": "2020-05-16",
"time": "15:30:00",
"minute": 90,
"timestamp": 1589635800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "114",
"name": "Bayer 04 Leverkusen",
"short_code": "B04",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/114.png",
"form": "4-2-3-1",
"coach_id": "54",
"color": null,
"kit_colors": null
},
"away": {
"id": "2813",
"name": "1. FSV Mainz 05",
"short_code": "M05",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2813.png",
"form": "3-4-3",
"coach_id": "663",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
{
"id": "31461",
"status": "4",
"status_name": "Postponed",
"status_period": null,
"pitch": null,
"referee_id": null,
"round_id": null,
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1622",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 15:30:00",
"date": "2020-05-16",
"time": "15:30:00",
"minute": 90,
"timestamp": 1589635800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2815",
"name": "Borussia Monchengladbach",
"short_code": "BMG",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2815.png",
"form": "4-2-3-1",
"coach_id": "64",
"color": null,
"kit_colors": null
},
"away": {
"id": "2806",
"name": "Hertha BSC",
"short_code": "BSC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
"form": "4-2-3-1",
"coach_id": "2681",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": null,
"away_score": null,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
...
Fixtures by Date / Stage#back to top
The Fixtures by Date / Stage Endpoint gives you fixtures from a single stage on a specific date
GETGet Fixtures By Date and Stage ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER}&token={YOUR_TOKEN}&t=schedule&d={YYYY-MM-DD}&stage_id={STAGE_ID} |
| Example | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=schedule&d=2019-11-19&stage_id=77443631 |
| Paginated | Yes, 100 per page |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | stages |
| d | date | YYYY-MM-DD |
| id | integer | STAGE_ID |
| page | integer | PAGE_NUMBER |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| pitch | string | pitch conditions |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| stage_id | integer | Pith of event |
| group_id | integer | Id of the group for Cups |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | Sometimes this parameter is needed |
| venue_id | integer | Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(playing), timestamp, timezone |
| teams | object | home(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors) |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| weather_report | object | Weather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...) |
Response Example
{
"data": [
{
"id": 11900655,
"status": 0,
"pitch": null,
"referee_id": 15280,
"round_id": 169707,
"season_id": 16074,
"stage_id": 77443900,
"group_id": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": 50,
"leg": "1/1",
"deleted": false,
"time": {
"datetime": "2019-12-21 12:30:00",
"date": "2019-12-21",
"time": "12:30:00",
"minute": null,
"timestamp": 1576931400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 51,
"name": "Everton",
"short_code": "EVE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/150/51.png",
"form": null,
"coach_id": 6971142,
"color": null,
"kit_colors": null
},
"away": {
"id": 57,
"name": "Arsenal",
"short_code": "ARS",
"img": "https://cdn.soccersapi.com/images/soccer/teams/150/57.png",
"form": null,
"coach_id": 186,
"color": null,
"kit_colors": null
}
},
"league": {
"id": 46,
"name": "Premier League",
"type": "domestic",
"country_id": 500,
"country_name": "England",
"country_flag": ""
},
"scores": {
"home_score": 0,
"away_score": 0,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 16,
"away_position": 10
},
"assistants": {
"first_assistant_id": 12749,
"second_assistant_id": 12056,
"fourth_assistant_id": null
},
"weather_report": null
},
{
"id": 11900652,
"status": 0,
"pitch": null,
"referee_id": 15307,
"round_id": 169707,
"season_id": 16074,
"stage_id": 77443900,
"group_id": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": 418,
"leg": "1/1",
"deleted": false,
"time": {
"datetime": "2019-12-21 15:00:00",
"date": "2019-12-21",
"time": "15:00:00",
"minute": null,
"timestamp": 1576940400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 90,
"name": "AFC Bournemouth",
"short_code": "BOU",
"img": "https://cdn.soccersapi.com/images/soccer/teams/150/90.png",
"form": null,
"coach_id": 523949,
"color": null,
"kit_colors": null
},
"away": {
"id": 65,
"name": "Burnley",
"short_code": "BUR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/150/65.png",
"form": null,
"coach_id": 455499,
"color": null,
"kit_colors": null
}
},
"league": {
"id": 46,
"name": "Premier League",
"type": "domestic",
"country_id": 500,
"country_name": "England",
"country_flag": ""
},
"scores": {
"home_score": 0,
"away_score": 0,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 14,
"away_position": 12
},
"assistants": {
"first_assistant_id": 12121,
"second_assistant_id": 12125,
"fourth_assistant_id": null
},
"weather_report": null
},
{
"id": 11900653,
"status": 0,
"pitch": null,
"referee_id": 15331,
"round_id": 169707,
"season_id": 16074,
"stage_id": 77443900,
"group_id": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": 43,
"leg": "1/1",
"deleted": false,
"time": {
"datetime": "2019-12-21 15:00:00",
"date": "2019-12-21",
"time": "15:00:00",
"minute": null,
"timestamp": 1576940400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 53,
"name": "Aston Villa",
"short_code": "AVA",
"img": "https://cdn.soccersapi.com/images/soccer/teams/150/53.png",
"form": null,
"coach_id": 524275,
"color": null,
"kit_colors": null
},
"away": {
"id": 103,
"name": "Southampton",
"short_code": "SOU",
"img": "https://cdn.soccersapi.com/images/soccer/teams/150/103.png",
"form": null,
"coach_id": 524335,
"color": null,
"kit_colors": null
}
},
"league": {
"id": 46,
"name": "Premier League",
"type": "domestic",
"country_id": 500,
"country_name": "England",
"country_flag": ""
},
"scores": {
"home_score": 0,
"away_score": 0,
"ht_score": null,
"ft_score": null,
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 17,
"away_position": 18
},
"assistants": {
"first_assistant_id": 12064,
"second_assistant_id": 12128,
"fourth_assistant_id": null
},
"weather_report": null
},
...
Fixtures by Date / Round#back to top
The Fixtures by Date / Round Endpoint gives you fixtures from a single round on a specific date
GETGet Fixtures By Date and Round ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER}&token={YOUR_TOKEN}&t=schedule&d={YYYY-MM-DD}&round_id={ROUND_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | rounds |
| d | date | YYYY-MM-DD |
| id | integer | ROUND_ID |
| page | integer | PAGE_NUMBER |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| pitch | string | pitch conditions |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| stage_id | integer | Pith of event |
| group_id | integer | Id of the group for Cups |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | Sometimes this parameter is needed |
| venue_id | integer | Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(playing), timestamp, timezone |
| teams | object | home(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors) |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| weather_report | object | Weather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...) |
Response Example
{
"data": [
{
"id": "32851",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "272",
"round_id": "2202",
"season_id": "613",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1636",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-07-28 11:30:00",
"date": "2019-07-28",
"time": "11:30:00",
"minute": 90,
"timestamp": 1564306200,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2857",
"name": "Hamburger SV",
"short_code": "HSV",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2857.png",
"form": null,
"coach_id": "259",
"color": null,
"kit_colors": null
},
"away": {
"id": "2858",
"name": "SV Darmstadt 1898",
"short_code": "DAR",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2858.png",
"form": null,
"coach_id": "692",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "592",
"name": "2. Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "1",
"away_score": "1",
"ht_score": "0-0",
"ft_score": "1-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "32852",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "1249",
"round_id": "2202",
"season_id": "613",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "286",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-07-28 13:30:00",
"date": "2019-07-28",
"time": "13:30:00",
"minute": 90,
"timestamp": 1564313400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2859",
"name": "SSV Jahn Regensburg",
"short_code": "JRE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2859.png",
"form": null,
"coach_id": "260",
"color": null,
"kit_colors": null
},
"away": {
"id": "2860",
"name": "VfL Bochum",
"short_code": "BOC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2860.png",
"form": null,
"coach_id": "4493",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "592",
"name": "2. Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "3",
"away_score": "1",
"ht_score": "1-0",
"ft_score": "3-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "32853",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "27",
"round_id": "2202",
"season_id": "613",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "284",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-07-28 13:30:00",
"date": "2019-07-28",
"time": "13:30:00",
"minute": 90,
"timestamp": 1564313400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2861",
"name": "Greuther Furth",
"short_code": "SGF",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2861.png",
"form": null,
"coach_id": "256",
"color": null,
"kit_colors": null
},
"away": {
"id": "2862",
"name": "Erzgebirge Aue",
"short_code": "AUE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2862.png",
"form": null,
"coach_id": "4567",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "592",
"name": "2. Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "0",
"away_score": "2",
"ht_score": "0-1",
"ft_score": "0-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
...
Fixtures by Season#back to top
The Fixtures Season Endpoint gives you fixtures from a specific Season by ID
GETGet Fixtures By Season ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER}&token={YOUR_TOKEN}&t=season&season_id={SEASON_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | season |
| season_id | integer | SEASON_ID |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| status_name | string | The name of the status |
| status_period | string | The name of the period |
| pitch | string | pitch conditions |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| season_name | string | The name of season |
| stage_id | integer | ID of the stage |
| stage_name | string | The name of stage |
| group_id | integer | Id of the group for Cups |
| group_name | string | The name of the group |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | The team that win on this event |
| venue_id | integer | The Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(inplay), timestamp, timezone |
| teams | object | home(id), away(id) |
| home | object | id, name, short_code, img, form, coach_id, color, kit_colors |
| away | object | id, name, short_code, img, form, coach_id, color, kit_colors |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| coverage | object | has_lineups, has_tvs |
| weather_report | string | Weather conditions |
Response Example
{
"data": [
{
"id": "31162",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "22",
"round_id": "1994",
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1446",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-08-16 18:30:00",
"date": "2019-08-16",
"time": "18:30:00",
"minute": 90,
"timestamp": 1565973000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "111",
"name": "FC Bayern Munich",
"short_code": "FCB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
"form": null,
"coach_id": "3757",
"color": null,
"kit_colors": null
},
"away": {
"id": "2806",
"name": "Hertha BSC",
"short_code": "BSC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
"form": null,
"coach_id": "3189",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "2",
"away_score": "2",
"ht_score": "1-2",
"ft_score": "2-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "31163",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "80",
"round_id": "1994",
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1386",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-08-17 13:30:00",
"date": "2019-08-17",
"time": "13:30:00",
"minute": 90,
"timestamp": 1566041400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "114",
"name": "Bayer 04 Leverkusen",
"short_code": "B04",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/114.png",
"form": null,
"coach_id": "54",
"color": null,
"kit_colors": null
},
"away": {
"id": "2807",
"name": "SC Paderborn 07",
"short_code": "PAD",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2807.png",
"form": null,
"coach_id": "59",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "3",
"away_score": "2",
"ht_score": "2-2",
"ft_score": "3-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "31164",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "434",
"round_id": "1994",
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1388",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-08-17 13:30:00",
"date": "2019-08-17",
"time": "13:30:00",
"minute": 90,
"timestamp": 1566041400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2808",
"name": "VfL Wolfsburg",
"short_code": "WOB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2808.png",
"form": null,
"coach_id": "62",
"color": null,
"kit_colors": null
},
"away": {
"id": "2809",
"name": "1. FC Cologne",
"short_code": "KOE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2809.png",
"form": null,
"coach_id": "663",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "2",
"away_score": "1",
"ht_score": "1-0",
"ft_score": "2-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
...
Fixtures by Season / Team#back to top
The Fixtures Season Endpoint gives you fixtures from a specific Season by ID and Team ID
GETGet Fixtures By Season ID and Team ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER}&token={YOUR_TOKEN}&t=season&season_id={SEASON_ID}&team_id={TEAM_ID} |
| Example | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=season&season_id=406&team_id=111 |
| Paginated | Not paginated yet, but will be |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | season |
| season_id | integer | SEASON_ID |
| team_id | integer | TEAM_ID |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| status_name | string | The name of the status |
| status_period | string | The name of the period |
| pitch | string | pitch conditions |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| season_name | string | The name of season |
| stage_id | integer | ID of the stage |
| stage_name | string | The name of stage |
| group_id | integer | Id of the group for Cups |
| group_name | string | The name of the group |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | The team that win on this event |
| venue_id | integer | The Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(inplay), timestamp, timezone |
| teams | object | home(id), away(id) |
| home | object | id, name, short_code, img, form, coach_id, color, kit_colors |
| away | object | id, name, short_code, img, form, coach_id, color, kit_colors |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| coverage | object | has_lineups, has_tvs |
| weather_report | string | Weather conditions |
Response Example
{
"data": [
{
"id": "31162",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "22",
"round_id": "1994",
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1446",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-08-16 18:30:00",
"date": "2019-08-16",
"time": "18:30:00",
"minute": 90,
"timestamp": 1565973000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "111",
"name": "FC Bayern Munich",
"short_code": "FCB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
"form": null,
"coach_id": "3757",
"color": null,
"kit_colors": null
},
"away": {
"id": "2806",
"name": "Hertha BSC",
"short_code": "BSC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
"form": null,
"coach_id": "3189",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "2",
"away_score": "2",
"ht_score": "1-2",
"ft_score": "2-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "31177",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "403",
"round_id": "1995",
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1626",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-08-24 16:30:00",
"date": "2019-08-24",
"time": "16:30:00",
"minute": 90,
"timestamp": 1566657000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2816",
"name": "FC Schalke 04",
"short_code": "S04",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2816.png",
"form": null,
"coach_id": "664",
"color": null,
"kit_colors": null
},
"away": {
"id": "111",
"name": "FC Bayern Munich",
"short_code": "FCB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
"form": null,
"coach_id": "3757",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "0",
"away_score": "3",
"ht_score": "0-1",
"ft_score": "0-3",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "31185",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "473",
"round_id": "1996",
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1446",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-08-31 13:30:00",
"date": "2019-08-31",
"time": "13:30:00",
"minute": 90,
"timestamp": 1567251000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "111",
"name": "FC Bayern Munich",
"short_code": "FCB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
"form": null,
"coach_id": "3757",
"color": null,
"kit_colors": null
},
"away": {
"id": "2813",
"name": "1. FSV Mainz 05",
"short_code": "M05",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2813.png",
"form": null,
"coach_id": "3577",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "6",
"away_score": "1",
"ht_score": "2-1",
"ft_score": "6-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "31195",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "405",
"round_id": "1997",
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "91",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-09-14 16:30:00",
"date": "2019-09-14",
"time": "16:30:00",
"minute": 90,
"timestamp": 1568471400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "101",
"name": "RB Leipzig",
"short_code": "RBL",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/101.png",
"form": null,
"coach_id": "57",
"color": null,
"kit_colors": null
},
"away": {
"id": "111",
"name": "FC Bayern Munich",
"short_code": "FCB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
"form": null,
"coach_id": "3757",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "1",
"away_score": "1",
"ht_score": "1-1",
"ft_score": "1-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
...
Fixtures by Stage#back to top
The Fixtures by Stage Endpoint gives you fixtures from a single stage
GETGet Fixtures By Stage ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=stage&stage_id={STAGE_ID} |
| Example | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=stage&stage_id=77441847 |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | stage |
| id | integer | STAGE_ID |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| status_name | string | The name of the status |
| status_period | string | The name of the period |
| pitch | string | pitch conditions |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| season_name | string | The name of season |
| stage_id | integer | ID of the stage |
| stage_name | string | The name of stage |
| group_id | integer | Id of the group for Cups |
| group_name | string | The name of the group |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | The team that win on this event |
| venue_id | integer | The Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(inplay), timestamp, timezone |
| teams | object | home(id), away(id) |
| home | object | id, name, short_code, img, form, coach_id, color, kit_colors |
| away | object | id, name, short_code, img, form, coach_id, color, kit_colors |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| coverage | object | has_lineups, has_tvs |
| weather_report | string | Weather conditions |
Response Example
{
"data": [
{
"id": 11352866,
"status": 3,
"pitch": null,
"referee_id": 16716,
"round_id": 159790,
"season_id": 15512,
"stage_id": 77441847,
"group_id": 207832,
"aggregate_id": null,
"winner_team_id": 18683,
"venue_id": 1353,
"leg": "1/1",
"deleted": false,
"time": {
"datetime": "2019-03-22 19:45:00",
"date": "2019-03-22",
"time": "19:45:00",
"minute": 90,
"timestamp": 1553283900,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 18683
},
"away": {
"id": 18756
}
},
"league": {
"id": 1363
},
"scores": {
"home_score": 5,
"away_score": 0,
"ht_score": "2-0",
"ft_score": "5-0",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 3,
"away_position": 2
},
"assistants": {
"first_assistant_id": 12895,
"second_assistant_id": 12899,
"fourth_assistant_id": null
}
},
{
"id": 11352867,
"status": 3,
"pitch": null,
"referee_id": 11767,
"round_id": 159790,
"season_id": 15512,
"stage_id": 77441847,
"group_id": 207832,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": null,
"leg": "1/1",
"deleted": false,
"time": {
"datetime": "2019-03-22 17:00:00",
"date": "2019-03-22",
"time": "17:00:00",
"minute": 90,
"timestamp": 1553274000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 18728
},
"away": {
"id": 18874
}
},
"league": {
"id": 1363
},
"scores": {
"home_score": 1,
"away_score": 1,
"ht_score": "0-0",
"ft_score": "1-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 1,
"away_position": 5
},
"assistants": {
"first_assistant_id": 12166,
"second_assistant_id": 15971,
"fourth_assistant_id": null
}
},
{
"id": 11352868,
"status": 3,
"pitch": null,
"referee_id": 17830,
"round_id": 159791,
"season_id": 15512,
"stage_id": 77441847,
"group_id": 207832,
"aggregate_id": null,
"winner_team_id": 18683,
"venue_id": 3638,
"leg": "1/1",
"deleted": false,
"time": {
"datetime": "2019-03-25 19:45:00",
"date": "2019-03-25",
"time": "19:45:00",
"minute": 90,
"timestamp": 1553543100,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 18874
},
"away": {
"id": 18683
}
},
"league": {
"id": 1363
},
"scores": {
"home_score": 1,
"away_score": 5,
"ht_score": "1-2",
"ft_score": "1-5",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 3,
"away_position": 1
},
"assistants": {
"first_assistant_id": 17832,
"second_assistant_id": 17834,
"fourth_assistant_id": null
}
},
...
Fixtures by Stage / Team#back to top
The Fixtures by Stage Endpoint gives you fixtures from a single stage and Team
GETGet Fixtures By Stage ID and Team
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=stage&stage_id={STAGE_ID}&team_id={TEAM_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | stage |
| id | integer | STAGE_ID |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| status_name | string | The name of the status |
| status_period | string | The name of the period |
| pitch | string | pitch conditions |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| season_name | string | The name of season |
| stage_id | integer | ID of the stage |
| stage_name | string | The name of stage |
| group_id | integer | Id of the group for Cups |
| group_name | string | The name of the group |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | The team that win on this event |
| venue_id | integer | The Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(inplay), timestamp, timezone |
| teams | object | home(id), away(id) |
| home | object | id, name, short_code, img, form, coach_id, color, kit_colors |
| away | object | id, name, short_code, img, form, coach_id, color, kit_colors |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| coverage | object | has_lineups, has_tvs |
| weather_report | string | Weather conditions |
Response Example
{
"data": [
{
"id": 11352866,
"status": 3,
"pitch": null,
"referee_id": 16716,
"round_id": 159790,
"season_id": 15512,
"stage_id": 77441847,
"group_id": 207832,
"aggregate_id": null,
"winner_team_id": 18683,
"venue_id": 1353,
"leg": "1/1",
"deleted": false,
"time": {
"datetime": "2019-03-22 19:45:00",
"date": "2019-03-22",
"time": "19:45:00",
"minute": 90,
"timestamp": 1553283900,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 18683
},
"away": {
"id": 18756
}
},
"league": {
"id": 1363
},
"scores": {
"home_score": 5,
"away_score": 0,
"ht_score": "2-0",
"ft_score": "5-0",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 3,
"away_position": 2
},
"assistants": {
"first_assistant_id": 12895,
"second_assistant_id": 12899,
"fourth_assistant_id": null
}
},
{
"id": 11352868,
"status": 3,
"pitch": null,
"referee_id": 17830,
"round_id": 159791,
"season_id": 15512,
"stage_id": 77441847,
"group_id": 207832,
"aggregate_id": null,
"winner_team_id": 18683,
"venue_id": 3638,
"leg": "1/1",
"deleted": false,
"time": {
"datetime": "2019-03-25 19:45:00",
"date": "2019-03-25",
"time": "19:45:00",
"minute": 90,
"timestamp": 1553543100,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 18874
},
"away": {
"id": 18683
}
},
"league": {
"id": 1363
},
"scores": {
"home_score": 1,
"away_score": 5,
"ht_score": "1-2",
"ft_score": "1-5",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 3,
"away_position": 1
},
"assistants": {
"first_assistant_id": 17832,
"second_assistant_id": 17834,
"fourth_assistant_id": null
}
},
{
"id": 11352875,
"status": 3,
"pitch": null,
"referee_id": 14381,
"round_id": 159794,
"season_id": 15512,
"stage_id": 77441847,
"group_id": 207832,
"aggregate_id": null,
"winner_team_id": 18683,
"venue_id": 1353,
"leg": "1/1",
"deleted": false,
"time": {
"datetime": "2019-09-07 16:00:00",
"date": "2019-09-07",
"time": "16:00:00",
"minute": 90,
"timestamp": 1567872000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": 18683
},
"away": {
"id": 18728
}
},
"league": {
"id": 1363
},
"scores": {
"home_score": 4,
"away_score": 0,
"ht_score": "1-0",
"ft_score": "4-0",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": 1,
"away_position": 4
},
"assistants": {
"first_assistant_id": 12785,
"second_assistant_id": 17901,
"fourth_assistant_id": null
}
},
...
Fixtures by Round#back to top
The Fixtures by Round Endpoint gives you fixtures from a single round
GETGet Fixtures By Round ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=round&round_id={ROUND_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | round |
| round_id | integer | ROUND_ID |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| status_name | string | The name of the status |
| status_period | string | The name of the period |
| pitch | string | pitch conditions |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| season_name | string | The name of season |
| stage_id | integer | ID of the stage |
| stage_name | string | The name of stage |
| group_id | integer | Id of the group for Cups |
| group_name | string | The name of the group |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | The team that win on this event |
| venue_id | integer | The Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(inplay), timestamp, timezone |
| teams | object | home(id), away(id) |
| home | object | id, name, short_code, img, form, coach_id, color, kit_colors |
| away | object | id, name, short_code, img, form, coach_id, color, kit_colors |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| coverage | object | has_lineups, has_tvs |
| weather_report | string | Weather conditions |
Response Example
{
"data": [
{
"id": "31162",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "22",
"round_id": "1994",
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1446",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-08-16 18:30:00",
"date": "2019-08-16",
"time": "18:30:00",
"minute": 90,
"timestamp": 1565973000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "111",
"name": "FC Bayern Munich",
"short_code": "FCB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
"form": null,
"coach_id": "3757",
"color": null,
"kit_colors": null
},
"away": {
"id": "2806",
"name": "Hertha BSC",
"short_code": "BSC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
"form": null,
"coach_id": "3189",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "2",
"away_score": "2",
"ht_score": "1-2",
"ft_score": "2-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "31163",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "80",
"round_id": "1994",
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1386",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-08-17 13:30:00",
"date": "2019-08-17",
"time": "13:30:00",
"minute": 90,
"timestamp": 1566041400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "114",
"name": "Bayer 04 Leverkusen",
"short_code": "B04",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/114.png",
"form": null,
"coach_id": "54",
"color": null,
"kit_colors": null
},
"away": {
"id": "2807",
"name": "SC Paderborn 07",
"short_code": "PAD",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2807.png",
"form": null,
"coach_id": "59",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "3",
"away_score": "2",
"ht_score": "2-2",
"ft_score": "3-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
{
"id": "31164",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "434",
"round_id": "1994",
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1388",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-08-17 13:30:00",
"date": "2019-08-17",
"time": "13:30:00",
"minute": 90,
"timestamp": 1566041400,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "2808",
"name": "VfL Wolfsburg",
"short_code": "WOB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2808.png",
"form": null,
"coach_id": "62",
"color": null,
"kit_colors": null
},
"away": {
"id": "2809",
"name": "1. FC Cologne",
"short_code": "KOE",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2809.png",
"form": null,
"coach_id": "663",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "2",
"away_score": "1",
"ht_score": "1-0",
"ft_score": "2-1",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
},
...
Fixtures by Round / Team#back to top
The Fixtures by Round Endpoint gives you fixtures from a single round and Team
GETGet Fixtures By Round ID and Team ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=round&round_id={ROUND_ID}&team_id={TEAM_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | round |
| round_id | integer | ROUND_ID |
| team_id | integer | TEAM_ID |
Response
| id | integer | The id for this match |
| status | integer | The status for this match |
| status_name | string | The name of the status |
| status_period | string | The name of the period |
| pitch | string | pitch conditions |
| referee_id | referee_id | Referee's id |
| round_id | integer | Id of round for this match (if have) |
| season_id | integer | Id of season for this match |
| season_name | string | The name of season |
| stage_id | integer | ID of the stage |
| stage_name | string | The name of stage |
| group_id | integer | Id of the group for Cups |
| group_name | string | The name of the group |
| aggregate_id | aggregate_id | Aggregate id |
| winner_team_id | integer | The team that win on this event |
| venue_id | integer | The Venue id |
| leg | string | Example 1/1 |
| deleted | boolean | If there's a mistake in this event, response will be true |
| time | object | datetime, date, time, minute(inplay), timestamp, timezone |
| teams | object | home(id), away(id) |
| home | object | id, name, short_code, img, form, coach_id, color, kit_colors |
| away | object | id, name, short_code, img, form, coach_id, color, kit_colors |
| league | object | id, name, type, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score, ps_score |
| standings | object | home_position, away_position |
| assistants | object | first_assistant_id, second_assistant_id, fourth_assistant_id |
| coverage | object | has_lineups, has_tvs |
| weather_report | string | Weather conditions |
Response Example
{
"data": [
{
"id": "31162",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "22",
"round_id": "1994",
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1446",
"leg": null,
"deleted": null,
"time": {
"datetime": "2019-08-16 18:30:00",
"date": "2019-08-16",
"time": "18:30:00",
"minute": 90,
"timestamp": 1565973000,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "111",
"name": "FC Bayern Munich",
"short_code": "FCB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
"form": null,
"coach_id": "3757",
"color": null,
"kit_colors": null
},
"away": {
"id": "2806",
"name": "Hertha BSC",
"short_code": "BSC",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
"form": null,
"coach_id": "3189",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "2",
"away_score": "2",
"ht_score": "1-2",
"ft_score": "2-2",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "0",
"has_tvs": "0"
},
"weather_report": false
}
],
...
Match by ID#back to top
The Match by ID Endpoint gives you information from a specific match
GETGet Match By ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id={ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | MATCH_ID |
Response
| id | integer | The id of the event |
| status | integer | The id of status (check Statuses and Explanation in this doc for see the reference for this number) |
| time | object | datetime, date, time, timestamp, timezone, minute playing |
| teams | object | home(id, name, img, form, coach_id),away(id, name, img, form,coach_id) |
| league | object | id, name, country_id, country_name, country_flag |
| scores | object | home_score, away_score, ht_score, ft_score, et_score |
| venue_id | integer | Id of venue |
| referee_id | integer | Id of referee |
| season_id | integer | Id of season for this match |
| stage_id | integer | Id of stage for this match |
| round_id | integer | Id of round for this match (if have) |
Response Example
{
"data": {
"id": "15006543",
"status": "3",
"status_name": "Finished",
"status_period": null,
"pitch": null,
"referee_id": "372",
"round_id": null,
"season_id": "406",
"season_name": "19/20",
"stage_id": null,
"stage_name": null,
"group_id": null,
"group_name": null,
"aggregate_id": null,
"winner_team_id": null,
"venue_id": "1216",
"leg": null,
"deleted": null,
"time": {
"datetime": "2020-05-16 15:30:00",
"date": "2020-05-16",
"time": "15:30:00",
"minute": 90,
"timestamp": 1589635800,
"timezone": "UTC"
},
"teams": {
"home": {
"id": "98",
"name": "Borussia Dortmund",
"short_code": "BVB",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/98.png",
"form": "3-4-3",
"coach_id": "1007",
"color": null,
"kit_colors": null
},
"away": {
"id": "2816",
"name": "FC Schalke 04",
"short_code": "S04",
"img": "https://cdn.soccersapi.com/images/soccer/teams/80/2816.png",
"form": "3-4-3",
"coach_id": "664",
"color": null,
"kit_colors": null
}
},
"league": {
"id": "594",
"name": "Bundesliga",
"type": "",
"country_id": "4",
"country_name": "Germany",
"country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
},
"scores": {
"home_score": "4",
"away_score": "0",
"ht_score": "2-0",
"ft_score": "4-0",
"et_score": null,
"ps_score": null
},
"standings": {
"home_position": null,
"away_position": null
},
"assistants": {
"first_assistant_id": null,
"second_assistant_id": null,
"fourth_assistant_id": null
},
"coverage": {
"has_lineups": "1",
"has_tvs": "1"
},
"weather_report": false
},
...
Match Commentary#back to top
The Match Commentary Endpoint gives you commentaries by Match ID
GETGet Commentary By Match ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=match_comments&id={MATCH_ID} |
| Example | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_comments&id=15006543 |
| Extra | Add (&order=desc) for have new lines first |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | match_comments |
| id | integer | MATCH_ID |
| order | string | asc / desc |
Response
| important | boolean | If is important (goals, cards,..) |
| order | integer | Order of the commentary (if you add &order=desc on call, you'll have on the top the newests) |
| goal | boolean | If is goal |
| minute | integer | In wich minute happened |
| extra_minute | integer | If happened in extra time |
| comment | string | What happened |
Response Example
{
"data": [
{
"important": 0,
"order": 47,
"goal": 0,
"minute": -1,
"extra_minute": 0,
"comment": "[59] spectators have come along to [24] today."
},
{
"important": 0,
"order": 2,
"goal": 0,
"minute": 0,
"extra_minute": 0,
"comment": "Today's referee, Deniz Aytekin, has blown to start the match."
},
{
"important": 0,
"order": 1,
"goal": 0,
"minute": 1,
"extra_minute": 0,
"comment": "Today's referee, Deniz Aytekin, has blown to start the match."
},
{
"important": 0,
"order": 3,
"goal": 0,
"minute": 4,
"extra_minute": 0,
"comment": "Dortmund awarded a free kick in their own half."
},
{
"important": 0,
"order": 4,
"goal": 0,
"minute": 6,
"extra_minute": 0,
"comment": "Deniz Aytekin signals a free kick to Schalke."
},
{
"important": 0,
"order": 5,
"goal": 0,
"minute": 7,
"extra_minute": 0,
"comment": "Schalke's Daniel Caligiuri gets in a shot but it is blocked by a Dortmund defender."
},
{
"important": 0,
"order": 6,
"goal": 0,
"minute": 7,
"extra_minute": 0,
"comment": "Thorgan Hazard for Dortmund gets in a strike but fails to hit the target."
},
{
"important": 0,
"order": 7,
"goal": 0,
"minute": 7,
"extra_minute": 0,
"comment": "It's a goal kick for the away team in Dortmund."
},
{
"important": 0,
"order": 8,
"goal": 0,
"minute": 8,
"extra_minute": 0,
"comment": "Can Dortmund get the ball into an attacking position from this throw-in in Schalke's half?"
},
{
"important": 0,
"order": 9,
"goal": 0,
"minute": 8,
"extra_minute": 0,
"comment": "Throw-in for Schalke in their own half."
},
{
"important": 0,
"order": 10,
"goal": 0,
"minute": 9,
"extra_minute": 0,
"comment": "Schalke awarded a throw-in in their own half."
},
{
"important": 0,
"order": 11,
"goal": 0,
"minute": 10,
"extra_minute": 0,
"comment": "Free kick Dortmund."
},
{
"important": 0,
"order": 12,
"goal": 0,
"minute": 11,
"extra_minute": 0,
"comment": "Deniz Aytekin awards Schalke a goal kick."
},
{
"important": 0,
"order": 13,
"goal": 0,
"minute": 12,
"extra_minute": 0,
"comment": "Throw-in for Schalke at Signal Iduna Park."
},
{
"important": 0,
"order": 14,
"goal": 0,
"minute": 13,
"extra_minute": 0,
"comment": "Ball safe as Schalke is awarded a throw-in in their half."
},
{
"important": 0,
"order": 15,
"goal": 0,
"minute": 15,
"extra_minute": 0,
"comment": "Raphael Guerreiro (Dortmund) gets in a strike but the shot is blocked by a defender."
},
{
"important": 0,
"order": 16,
"goal": 0,
"minute": 16,
"extra_minute": 0,
"comment": "Corner awarded to Dortmund."
},
{
"important": 0,
"order": 17,
"goal": 0,
"minute": 16,
"extra_minute": 0,
"comment": "A throw-in for the home team on the opposite half."
},
{
"important": 0,
"order": 18,
"goal": 0,
"minute": 17,
"extra_minute": 0,
"comment": "Free kick for Schalke in their own half."
},
{
"important": 0,
"order": 19,
"goal": 0,
"minute": 18,
"extra_minute": 0,
"comment": "Dortmund have a goal kick."
},
{
"important": 0,
"order": 20,
"goal": 0,
"minute": 18,
"extra_minute": 0,
"comment": "Throw-in Dortmund."
},
{
"important": 0,
"order": 21,
"goal": 0,
"minute": 19,
"extra_minute": 0,
"comment": "Deniz Aytekin awards the away team a throw-in."
},
{
"important": 0,
"order": 22,
"goal": 0,
"minute": 20,
"extra_minute": 0,
"comment": "Deniz Aytekin signals a free kick to Dortmund in their own half."
},
{
"important": 0,
"order": 23,
"goal": 0,
"minute": 20,
"extra_minute": 0,
"comment": "Dortmund to take a throw-in in Schalke territory."
},
{
"important": 0,
"order": 24,
"goal": 0,
"minute": 21,
"extra_minute": 0,
"comment": "Throw-in for Schalke in their own half."
},
{
"important": 0,
"order": 25,
"goal": 0,
"minute": 22,
"extra_minute": 0,
"comment": "Deniz Aytekin signals a Dortmund throw-in in Schalke's half."
},
{
"important": 0,
"order": 26,
"goal": 0,
"minute": 22,
"extra_minute": 0,
"comment": "Deniz Aytekin signals a free kick to Dortmund just outside Schalke's area."
},
{
"important": 0,
"order": 27,
"goal": 0,
"minute": 23,
"extra_minute": 0,
"comment": "Dortmund push forward at Signal Iduna Park and Achraf Hakimi gets in a strike. This is blocked, however, by a determined Schalke defence."
},
{
"important": 0,
"order": 28,
"goal": 0,
"minute": 24,
"extra_minute": 0,
"comment": "Dortmund have been awarded a corner by Deniz Aytekin."
},
{
"important": 0,
"order": 29,
"goal": 0,
"minute": 24,
"extra_minute": 0,
"comment": "Erling Haaland of Dortmund gets in a strike, but is off target."
},
{
"important": 0,
"order": 30,
"goal": 0,
"minute": 24,
"extra_minute": 0,
"comment": "Goal kick for Schalke at Signal Iduna Park."
},
{
"important": 0,
"order": 31,
"goal": 0,
"minute": 26,
"extra_minute": 0,
"comment": "Schalke pushes forward through Daniel Caligiuri, whose finish on goal is saved."
},
...
Match Events#back to top
The Match Events Endpoint gives the list ofevents / occurrences by Match ID
GETGet Events By Match ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=match_events&id={MATCH_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | match_events |
| id | string | MATCH_ID |
Response
| team_id | integer | Id of the team |
| player_id | integer | Id of the player |
| player_name | string | Name of the player |
| related_player_id | integer | Id of the player in relation |
| related_player_name | string | Name of the player |
| minute | integer | Minute |
| extra_minute | integer | If happened in extra time |
| reason | string | Happen in cards |
| injuried | string | If was injuried |
| result | string | Current result if goal |
Response Example
{
"data": [
{
"team_id": "98",
"type": "goal",
"player_id": "13201",
"player_name": "Haaland, Erling",
"related_player_id": 94286,
"related_player_name": "Hazard, Thorgan",
"minute": 29,
"extra_minute": null,
"reason": null,
"injuried": null,
"result": "1-0"
},
{
"team_id": "2816",
"type": "injury",
"player_id": "12115",
"player_name": "Todibo, Jean-Clair",
"related_player_id": null,
"related_player_name": null,
"minute": 36,
"extra_minute": null,
"reason": null,
"injuried": true,
"result": null
},
{
"team_id": "98",
"type": "goal",
"player_id": "13190",
"player_name": "Guerreiro, Raphael",
"related_player_id": 226978,
"related_player_name": "Brandt, Julian",
"minute": 45,
"extra_minute": null,
"reason": null,
"injuried": null,
"result": "2-0"
},
{
"team_id": "2816",
"type": "substitution",
"player_id": "8269",
"player_name": "Raman, Benito",
"related_player_id": "8325",
"related_player_name": "Matondo, Rabbi",
"minute": 46,
"extra_minute": null,
"reason": null,
"injuried": null,
"result": null
},
{
"team_id": "2816",
"type": "substitution",
"player_id": "12115",
"player_name": "Todibo, Jean-Clair",
"related_player_id": "8274",
"related_player_name": "Burgstaller, Guido",
"minute": 46,
"extra_minute": null,
"reason": null,
"injuried": null,
"result": null
},
{
"team_id": "2816",
"type": "yellowcard",
"player_id": "19999",
"player_name": "Sane, Salif",
"related_player_id": null,
"related_player_name": null,
"minute": 48,
"extra_minute": null,
"reason": null,
"injuried": null,
"result": null
},
{
"team_id": "98",
"type": "goal",
"player_id": "13191",
"player_name": "Hazard, Thorgan",
"related_player_id": 226978,
"related_player_name": "Brandt, Julian",
"minute": 48,
"extra_minute": null,
"reason": null,
"injuried": null,
"result": "3-0"
},
{
"team_id": "98",
"type": "injury",
"player_id": "13201",
"player_name": "Haaland, Erling",
"related_player_id": null,
"related_player_name": null,
"minute": 49,
"extra_minute": null,
"reason": null,
"injuried": true,
"result": null
},
{
"team_id": "98",
"type": "yellowcard",
"player_id": "22763",
"player_name": "Delaney, Thomas",
"related_player_id": null,
"related_player_name": null,
"minute": 53,
"extra_minute": null,
"reason": null,
"injuried": null,
"result": null
},
...
Match Lineups#back to top
The Lineups Endpoint gives you starting Lineups by Match ID
GETGet Lineups By Match ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=match_lineups&id={MATCH_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | match_lineups |
| id | string | MATCH_ID |
Response
| team_id | integer | The id for the team |
| player_id | integer | The id of the player |
| player_name | string | The name of the player |
| number | string | The number of the player |
| position | string | The position of the player |
| formation_position | string | The formation position of the player |
| posx | string | The posx (position X-axis) in formation of the player |
| posy | string | The posy (position Y-axis) in formation of the player |
| stats | object | shots, goals, fouls, cards, passing, other |
| shots | object | shots_total, shots_on_goal |
| goals | object | scored, conceded |
| fouls | object | drawn, committed |
| cards | object | yellowcards, redcards |
| passing | object | total_crosses, crosses_accuracy, passes, passes_accuracy |
| other | object | assists, offsides, saves, pen_scored, pen_missed, pen_saved, tackles, blocks, interceptions, clearances, minutes_played |
Response Example
{
"data": {
"home": {
"formation": "3-4-3",
"confirmed_formation": 1,
"squad": [
{
"player": {
"id": "13183",
"name": null,
"common_name": "Burki, Roman",
"firstname": "Roman",
"lastname": "Burki",
"weight": "85",
"height": "187",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13183.png",
"country": {
"id": "114",
"name": "Switzerland",
"cc": "ch"
}
},
"number": "1",
"captain": null,
"position": "G",
"order": 1
},
{
"player": {
"id": "13184",
"name": null,
"common_name": "Piszczek, Lukasz",
"firstname": "Lukasz",
"lastname": "Piszczek",
"weight": "79",
"height": "184",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13184.png",
"country": {
"id": "95",
"name": "Poland",
"cc": "pl"
}
},
"number": "26",
"captain": null,
"position": "D",
"order": 2
},
{
"player": {
"id": "13185",
"name": null,
"common_name": "Hummels, Mats",
"firstname": "Mats Julian",
"lastname": "Hummels",
"weight": "94",
"height": "191",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13185.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "15",
"captain": null,
"position": "D",
"order": 3
},
{
"player": {
"id": "13199",
"name": null,
"common_name": "Akanji, Manuel",
"firstname": "Manuel Obafemi",
"lastname": "Akanji",
"weight": "91",
"height": "187",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13199.png",
"country": {
"id": "114",
"name": "Switzerland",
"cc": "ch"
}
},
"number": "16",
"captain": null,
"position": "D",
"order": 4
},
{
"player": {
"id": "13187",
"name": null,
"common_name": "Hakimi, Achraf",
"firstname": "Achraf",
"lastname": "Hakimi",
"weight": "73",
"height": "181",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13187.png",
"country": {
"id": "79",
"name": "Morocco",
"cc": "ma"
}
},
"number": "5",
"captain": null,
"position": "D",
"order": 5
},
{
"player": {
"id": "13198",
"name": null,
"common_name": "Dahoud, Mahmoud",
"firstname": "Mahmoud",
"lastname": "Dahoud",
"weight": "68",
"height": "178",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13198.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "8",
"captain": null,
"position": "M",
"order": 6
},
{
"player": {
"id": "22763",
"name": null,
"common_name": "Delaney, Thomas",
"firstname": "Thomas",
"lastname": "Delaney",
"weight": null,
"height": null,
"img": "https://cdn.soccersapi.com/images/soccer/players/50/22763.png",
"country": {
"id": null,
"name": null,
"cc": null
}
},
"number": "6",
"captain": null,
"position": "M",
"order": 7
},
{
"player": {
"id": "13190",
"name": null,
"common_name": "Guerreiro, Raphael",
"firstname": "Raphael Adelino",
"lastname": "Jose Guerreiro",
"weight": "71",
"height": "170",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13190.png",
"country": {
"id": "96",
"name": "Portugal",
"cc": "pt"
}
},
"number": "13",
"captain": null,
"position": "D",
"order": 8
},
{
"player": {
"id": "13192",
"name": null,
"common_name": "Brandt, Julian",
"firstname": "Julian",
"lastname": "Brandt",
"weight": "83",
"height": "185",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13192.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "19",
"captain": null,
"position": "M",
"order": 9
},
{
"player": {
"id": "13201",
"name": null,
"common_name": "Haaland, Erling",
"firstname": "Erling Braut",
"lastname": "Haaland",
"weight": "87",
"height": "194",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13201.png",
"country": {
"id": "87",
"name": "Norway",
"cc": "no"
}
},
"number": "17",
"captain": null,
"position": "F",
"order": 10
},
{
"player": {
"id": "13191",
"name": null,
"common_name": "Hazard, Thorgan",
"firstname": "Thorgan Ganael Francis",
"lastname": "Hazard",
"weight": "71",
"height": "175",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13191.png",
"country": {
"id": "21",
"name": "Belgium",
"cc": "be"
}
},
"number": "23",
"captain": null,
"position": "M",
"order": 11
}
]
},
"away": {
"formation": "3-4-3",
"confirmed_formation": 1,
"squad": [
{
"player": {
"id": "12113",
"name": null,
"common_name": "Schubert, Markus",
"firstname": "Markus",
"lastname": "Schubert",
"weight": "81",
"height": "184",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/12113.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "23",
"captain": null,
"position": "G",
"order": 1
},
{
"player": {
"id": "12115",
"name": null,
"common_name": "Todibo, Jean-Clair",
"firstname": "Jean-Clair",
"lastname": "Todibo",
"weight": "81",
"height": "190",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/12115.png",
"country": {
"id": "7",
"name": "France",
"cc": "fr"
}
},
"number": "21",
"captain": null,
"position": "D",
"order": 2
},
{
"player": {
"id": "19999",
"name": null,
"common_name": "Sane, Salif",
"firstname": "Salif",
"lastname": "Sane",
"weight": "84",
"height": "196",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/19999.png",
"country": {
"id": "105",
"name": "Senegal",
"cc": "sn"
}
},
"number": "26",
"captain": null,
"position": "D",
"order": 3
},
{
"player": {
"id": "8273",
"name": null,
"common_name": "Nastasic, Matija",
"firstname": "Matija",
"lastname": "Nastasic",
"weight": "83",
"height": "188",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/8273.png",
"country": {
"id": "106",
"name": "Serbia",
"cc": "rs"
}
},
"number": "5",
"captain": null,
"position": "D",
"order": 4
},
...
Match Bench#back to top
The Match Bench Endpoint gives you the bench of both teams
GETGet Bench By Match ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=match_bench&id={MATCH_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | match_bench |
| id | string | MATCH_ID |
Response
| team_id | integer | The id for the team |
| player_id | integer | The id of the player |
| player_name | string | The name of the player |
| number | string | The number of the player |
| position | string | The position of the player |
| formation_position | string | The formation position of the player |
| posx | string | The posx (position X-axis) in formation of the player |
| posy | string | The posy (position Y-axis) in formation of the player |
| stats | object | shots, goals, fouls, cards, passing, other |
| shots | object | shots_total, shots_on_goal |
| goals | object | scored, conceded |
| fouls | object | drawn, committed |
| cards | object | yellowcards, redcards |
| passing | object | total_crosses, crosses_accuracy, passes, passes_accuracy |
| other | object | assists, offsides, saves, pen_scored, pen_missed, pen_saved, tackles, blocks, interceptions, clearances, minutes_played |
Response Example
{
"data": {
"home": [
{
"player": {
"id": "13193",
"name": null,
"common_name": "Hitz, Marwin",
"firstname": "Marwin",
"lastname": "Hitz",
"weight": "89",
"height": "194",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13193.png",
"country": {
"id": "114",
"name": "Switzerland",
"cc": "ch"
}
},
"number": "35",
"position": "G"
},
{
"player": {
"id": "21924",
"name": null,
"common_name": "Fuhrich, Chris",
"firstname": "Chris",
"lastname": "Fuhrich",
"weight": "0",
"height": "178",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/21924.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "33",
"position": "M"
},
{
"player": {
"id": "6260",
"name": null,
"common_name": "Sancho, Jadon",
"firstname": "Jadon Malik",
"lastname": "Sancho",
"weight": "76",
"height": "180",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/6260.png",
"country": {
"id": "3",
"name": "England",
"cc": "en"
}
},
"number": "7",
"position": "M"
},
{
"player": {
"id": "21995",
"name": null,
"common_name": "Raschl, Tobias",
"firstname": "Tobias",
"lastname": "Raschl",
"weight": "75",
"height": "177",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/21995.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "37",
"position": "M"
},
{
"player": {
"id": "13194",
"name": null,
"common_name": "Morey, Mateu",
"firstname": "Mateu Jaume",
"lastname": "Morey Bauza",
"weight": "67",
"height": "173",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13194.png",
"country": {
"id": "5",
"name": "Spain",
"cc": "es"
}
},
"number": "22",
"position": "D"
},
{
"player": {
"id": "13195",
"name": null,
"common_name": "Balerdi, Leonardo",
"firstname": "Leonardo Julian",
"lastname": "Balerdi Rosa",
"weight": "76",
"height": "187",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13195.png",
"country": {
"id": "12",
"name": "Argentina",
"cc": "ar"
}
},
"number": "18",
"position": "D"
},
{
"player": {
"id": "13196",
"name": null,
"common_name": "Reyna, Giovanni",
"firstname": "Giovanni Alejandro",
"lastname": "Reyna",
"weight": "0",
"height": "183",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13196.png",
"country": {
"id": "124",
"name": "USA",
"cc": "us"
}
},
"number": "32",
"position": "F"
},
{
"player": {
"id": "13197",
"name": null,
"common_name": "Schmelzer,Marcel",
"firstname": "Marcel",
"lastname": "Schmelzer",
"weight": "74",
"height": "180",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13197.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "29",
"position": "D"
},
{
"player": {
"id": "16623",
"name": null,
"common_name": "Gotze, Mario",
"firstname": "Mario",
"lastname": "Gotze",
"weight": "75",
"height": "176",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/16623.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "10",
"position": "M"
}
],
"away": [
{
"player": {
"id": "12107",
"name": null,
"common_name": "Nubel, Alexander",
"firstname": "Alexander",
"lastname": "Nubel",
"weight": "85",
"height": "193",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/12107.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "10",
"position": "M"
},
{
"player": {
"id": "30464",
"name": null,
"common_name": "Miranda, Juan",
"firstname": "Juan",
"lastname": "Miranda",
"weight": null,
"height": null,
"img": "https://cdn.soccersapi.com/images/soccer/players/50/30464.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "10",
"position": "M"
},
{
"player": {
"id": "8336",
"name": null,
"common_name": "Gregoritsch, Michael",
"firstname": "Michael",
"lastname": "Gregoritsch",
"weight": "87",
"height": "193",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/8336.png",
"country": {
"id": "15",
"name": "Austria",
"cc": "at"
}
},
"number": "10",
"position": "M"
},
{
"player": {
"id": "242",
"name": null,
"common_name": "Kutucu, Ahmed",
"firstname": "Ahmed",
"lastname": "Kutucu",
"weight": "76",
"height": "181",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/242.png",
"country": {
"id": "118",
"name": "Turkey",
"cc": "tr"
}
},
"number": "10",
"position": "M"
},
{
"player": {
"id": "12114",
"name": null,
"common_name": "Mercan, Munir Levent",
"firstname": "Munir Levent",
"lastname": "Mercan",
"weight": "69",
"height": "176",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/12114.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
"number": "10",
"position": "M"
},
{
"player": {
"id": "12111",
"name": null,
"common_name": "Schopf, Alessandro",
"firstname": "Alessandro",
"lastname": "Schopf",
"weight": "73",
"height": "178",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/12111.png",
"country": {
"id": "15",
"name": "Austria",
"cc": "at"
}
},
"number": "10",
"position": "M"
},
...
Match Stats#back to top
The Match Stats endpoint gives you the statistics of a single event
GETGet Match Statistics By Match ID
API Reference| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/stats/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=match&id={FIXTURE_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | match |
| id | integer | MATCH_ID |
| team_id | integer | The id of the team |
| shots | object | total,ongoal,offgoal,blocked,insidebox,outsidebox |
| passes | object | total,accurate,percentage |
| attacks | object | attacks,dangerous_attacks |
| fouls | integer | Number of fouls |
| corners | integer | Number of corners |
| offsides | integer | Number of offsides |
| possessiontime | integer | Percentatge of possessiontime |
| yellowcards | integer | Number of yellowcards |
| redcards | integer | Number of redcards |
| yellowredcards | integer | Number of yellowredcards |
| saves | integer | Number of saves |
| substitutions | integer | Number of substitutions |
| goal_kick | integer | Number of kicks to goal |
| goal_attempts | integer | Number of goals attempts |
| free_kick | integer | Number of free kicks |
| throw_in | integer | Number of throw in |
| ball_safe | integer | Number of balls safe |
| goals | integer | Number of goals |
| penalties | integer | Number of penalties |
| injuries | integer | Number of injuries |
Response Example
{
"data": [
{
"team_id": "98",
"passes": {
"total": null,
"accurate": null,
"percentage": null
},
"fouls": 9,
"injuries": 3,
"corners": 4,
"offsides": 0,
"shots_blocked": 4,
"possessiontime": null,
"possessionpercent": 57,
"yellowcards": 2,
"yellowredcards": 0,
"redcards": 0,
"substitutions": 4,
"goal_kick": 7,
"goal_attempts": 7,
"free_kick": 9,
"throw_in": 15,
"ball_safe": 51,
"goals": 4,
"penalties": "0/0",
"attacks": 22,
"dangerous_attacks": 27
},
{
"team_id": "2816",
"passes": {
"total": null,
"accurate": null,
"percentage": null
},
"fouls": 9,
"injuries": 1,
"corners": 1,
"offsides": 4,
"shots_blocked": 3,
"possessiontime": null,
"possessionpercent": 43,
"yellowcards": 2,
"yellowredcards": 0,
"redcards": 0,
"substitutions": 5,
"goal_kick": 5,
"goal_attempts": 7,
"throw_in": 16,
"ball_safe": 46,
"goals": 0,
"penalties": "0/0",
"attacks": 29,
"dangerous_attacks": 25
}
],
...
Match Trend Analyses#back to top
The Match Trend Analyses endpoint returns detailed information about on what minute a single statistic has happened
GETGet Stats Trend Analyses by Match ID
API Reference| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=match_trends&id={MATCH_ID} |
| Example | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_trends&id=4227583 |
| Paginated | No, this endpoint is not paginated |
URI Paramters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | match_trends |
| id | integer | MATCH_ID |
Response
| team_id | integer | The id of the team |
| type | integer | The type of trend |
| analyses | object | minute, amount |
| minute | integer | The minute of the trend |
| amount | integer | The amount of the trend |
Response Example
{
"data": [
{
"team_id": 121,
"type": "possession",
"analyses": [
{
"minute": "0",
"amount": "0"
},
{
"minute": "1",
"amount": "21"
},
{
"minute": "2",
"amount": "55"
},
{
"minute": "3",
"amount": "66"
},
{
"minute": "4",
"amount": "57"
},
{
"minute": "5",
"amount": "63"
},
{
"minute": "6",
"amount": "58"
},
{
"minute": "7",
"amount": "55"
},
{
"minute": "8",
"amount": "58"
},
{
"minute": "9",
"amount": "56"
},
{
"minute": "10",
"amount": "53"
},
{
"minute": "11",
"amount": "52"
},
{
"minute": "12",
"amount": "55"
},
{
"minute": "13",
"amount": "59"
},
{
"minute": "14",
"amount": "58"
},
{
"minute": "16",
"amount": "61"
},
{
"minute": "17",
"amount": "59"
},
{
"minute": "18",
"amount": "62"
},
{
"minute": "19",
"amount": "61"
},
{
"minute": "20",
"amount": "63"
},
{
"minute": "21",
"amount": "65"
},
{
"minute": "22",
"amount": "64"
},
{
"minute": "23",
"amount": "62"
},
{
"minute": "24",
"amount": "59"
},
{
"minute": "25",
"amount": "59"
},
{
"minute": "27",
"amount": "58"
},
{
"minute": "28",
"amount": "59"
},
{
"minute": "29",
"amount": "60"
},
{
"minute": "30",
"amount": "59"
},
{
"minute": "31",
"amount": "61"
},
{
"minute": "32",
"amount": "60"
},
{
"minute": "33",
"amount": "59"
},
{
"minute": "34",
"amount": "59"
},
{
"minute": "36",
"amount": "58"
},
{
"minute": "37",
"amount": "56"
},
{
"minute": "39",
"amount": "58"
},
{
"minute": "40",
"amount": "58"
},
{
"minute": "41",
"amount": "59"
},
{
"minute": "42",
"amount": "58"
},
{
"minute": "44",
"amount": "57"
},
{
"minute": "45",
"amount": "59"
},
{
"minute": "47",
"amount": "58"
},
{
"minute": "46",
"amount": "57"
},
{
"minute": "48",
"amount": "58"
},
{
"minute": "49",
"amount": "56"
},
{
"minute": "50",
"amount": "57"
},
{
"minute": "51",
"amount": "58"
},
{
"minute": "53",
"amount": "57"
},
{
"minute": "60",
"amount": "58"
},
{
"minute": "63",
"amount": "59"
},
{
"minute": "64",
"amount": "57"
},
{
"minute": "66",
"amount": "55"
},
{
"minute": "67",
"amount": "56"
},
{
"minute": "68",
"amount": "55"
},
{
"minute": "70",
"amount": "56"
},
{
"minute": "71",
"amount": "55"
},
{
"minute": "73",
"amount": "56"
},
{
"minute": "74",
"amount": "56"
},
{
"minute": "76",
"amount": "57"
},
{
"minute": "77",
"amount": "56"
},
{
"minute": "78",
"amount": "56"
},
{
"minute": "80",
"amount": "55"
},
{
"minute": "81",
"amount": "56"
},
{
"minute": "82",
"amount": "55"
},
{
"minute": "85",
"amount": "54"
},
{
"minute": "88",
"amount": "53"
},
{
"minute": "89",
"amount": "54"
},
{
"minute": "90",
"amount": "53"
},
{
"minute": "94",
"amount": "52"
}
]
},
{
"team_id": 3506,
"type": "possession",
"analyses": [
{
"minute": "0",
"amount": "100"
},
{
"minute": "1",
"amount": "79"
},
{
"minute": "2",
"amount": "45"
},
{
"minute": "3",
"amount": "34"
},
{
"minute": "4",
"amount": "43"
},
{
"minute": "5",
"amount": "37"
},
{
"minute": "6",
"amount": "42"
},
{
"minute": "7",
"amount": "45"
},
{
"minute": "8",
"amount": "42"
},
{
"minute": "9",
"amount": "44"
},
{
"minute": "10",
"amount": "47"
},
{
"minute": "11",
"amount": "48"
},
{
"minute": "12",
"amount": "45"
},
{
"minute": "13",
"amount": "41"
},
{
"minute": "14",
"amount": "42"
},
{
"minute": "16",
"amount": "39"
},
{
"minute": "17",
"amount": "41"
},
{
"minute": "18",
"amount": "38"
},
{
"minute": "19",
"amount": "39"
},
{
"minute": "20",
"amount": "37"
},
{
"minute": "21",
"amount": "35"
},
{
"minute": "22",
"amount": "36"
},
{
"minute": "23",
"amount": "38"
},
{
"minute": "24",
"amount": "41"
},
{
"minute": "25",
"amount": "41"
},
{
"minute": "27",
"amount": "42"
},
{
"minute": "28",
"amount": "41"
},
{
"minute": "29",
"amount": "40"
},
{
"minute": "30",
"amount": "41"
},
{
"minute": "31",
"amount": "39"
},
{
"minute": "32",
"amount": "40"
},
{
"minute": "33",
"amount": "41"
},
{
"minute": "34",
"amount": "41"
},
{
"minute": "36",
"amount": "42"
},
{
"minute": "37",
"amount": "44"
},
{
"minute": "39",
"amount": "42"
},
{
"minute": "40",
"amount": "42"
},
{
"minute": "41",
"amount": "41"
},
{
"minute": "42",
"amount": "42"
},
{
"minute": "44",
"amount": "43"
},
{
"minute": "45",
"amount": "41"
},
{
"minute": "47",
"amount": "42"
},
{
"minute": "46",
"amount": "43"
},
{
"minute": "48",
"amount": "42"
},
{
"minute": "49",
"amount": "44"
},
{
"minute": "50",
"amount": "43"
},
{
"minute": "51",
"amount": "42"
},
{
"minute": "53",
"amount": "43"
},
{
"minute": "60",
"amount": "42"
},
{
"minute": "63",
"amount": "41"
},
{
"minute": "64",
"amount": "43"
},
{
"minute": "66",
"amount": "45"
},
{
"minute": "67",
"amount": "44"
},
{
"minute": "68",
"amount": "45"
},
{
"minute": "70",
"amount": "44"
},
{
"minute": "71",
"amount": "45"
},
{
"minute": "73",
"amount": "44"
},
{
"minute": "74",
"amount": "44"
},
{
"minute": "76",
"amount": "43"
},
{
"minute": "77",
"amount": "44"
},
{
"minute": "78",
"amount": "44"
},
{
"minute": "80",
"amount": "45"
},
{
"minute": "81",
"amount": "44"
},
{
"minute": "82",
"amount": "45"
},
{
"minute": "85",
"amount": "46"
},
{
"minute": "88",
"amount": "47"
},
{
"minute": "89",
"amount": "46"
},
{
"minute": "90",
"amount": "47"
},
{
"minute": "94",
"amount": "48"
}
]
},
{
"team_id": 121,
"type": "attacks",
"analyses": [
{
"minute": "0",
"amount": "0"
},
{
"minute": "1",
"amount": "3"
},
{
"minute": "2",
"amount": "5"
},
{
"minute": "3",
"amount": "6"
},
{
"minute": "5",
"amount": "7"
},
{
"minute": "6",
"amount": "8"
},
{
"minute": "8",
"amount": "10"
},
{
"minute": "9",
"amount": "11"
},
{
"minute": "12",
"amount": "12"
},
{
"minute": "13",
"amount": "14"
},
{
"minute": "16",
"amount": "15"
},
{
"minute": "17",
"amount": "16"
},
{
"minute": "18",
"amount": "20"
},
{
"minute": "19",
"amount": "22"
},
{
"minute": "20",
"amount": "24"
},
{
"minute": "21",
"amount": "25"
},
{
"minute": "23",
"amount": "26"
},
{
"minute": "24",
"amount": "28"
},
{
"minute": "26",
"amount": "29"
},
{
"minute": "27",
"amount": "30"
},
{
"minute": "28",
"amount": "31"
},
{
"minute": "29",
"amount": "32"
},
{
"minute": "30",
"amount": "33"
},
{
"minute": "31",
"amount": "34"
},
{
"minute": "32",
"amount": "35"
},
{
"minute": "33",
"amount": "37"
},
{
"minute": "34",
"amount": "40"
},
{
"minute": "35",
"amount": "41"
},
{
"minute": "38",
"amount": "42"
},
{
"minute": "39",
"amount": "44"
},
{
"minute": "40",
"amount": "46"
},
{
"minute": "42",
"amount": "47"
},
{
"minute": "45",
"amount": "51"
},
{
"minute": "47",
"amount": "52"
},
{
"minute": "48",
"amount": "55"
},
{
"minute": "51",
"amount": "61"
},
{
"minute": "54",
"amount": "63"
},
{
"minute": "55",
"amount": "64"
},
{
"minute": "58",
"amount": "65"
},
{
"minute": "59",
"amount": "67"
},
{
"minute": "60",
"amount": "68"
},
{
"minute": "61",
"amount": "70"
},
{
"minute": "62",
"amount": "72"
},
{
"minute": "63",
"amount": "74"
},
{
"minute": "67",
"amount": "76"
},
{
"minute": "68",
"amount": "77"
},
{
"minute": "69",
"amount": "78"
},
{
"minute": "70",
"amount": "79"
},
{
"minute": "71",
"amount": "80"
},
{
"minute": "73",
"amount": "82"
},
{
"minute": "74",
"amount": "84"
},
{
"minute": "75",
"amount": "85"
},
{
"minute": "76",
"amount": "86"
},
{
"minute": "79",
"amount": "87"
},
{
"minute": "80",
"amount": "88"
},
{
"minute": "81",
"amount": "90"
},
{
"minute": "84",
"amount": "91"
},
{
"minute": "85",
"amount": "92"
},
{
"minute": "87",
"amount": "93"
},
{
"minute": "89",
"amount": "94"
},
{
"minute": "90",
"amount": "95"
},
{
"minute": "92",
"amount": "96"
},
{
"minute": "93",
"amount": "97"
}
]
},
{
"team_id": 3506,
"type": "attacks",
"analyses": [
{
"minute": "0",
"amount": "0"
},
{
"minute": "2",
"amount": "1"
},
{
"minute": "4",
"amount": "2"
},
{
"minute": "5",
"amount": "4"
},
{
"minute": "6",
"amount": "6"
},
{
"minute": "7",
"amount": "8"
},
{
"minute": "8",
"amount": "9"
},
{
"minute": "9",
"amount": "10"
},
{
"minute": "10",
"amount": "12"
},
{
"minute": "11",
"amount": "14"
},
{
"minute": "16",
"amount": "15"
},
{
"minute": "17",
"amount": "17"
},
{
"minute": "19",
"amount": "18"
},
{
"minute": "22",
"amount": "21"
},
{
"minute": "23",
"amount": "22"
},
{
"minute": "24",
"amount": "23"
},
{
"minute": "25",
"amount": "24"
},
{
"minute": "26",
"amount": "26"
},
{
"minute": "27",
"amount": "27"
},
{
"minute": "28",
"amount": "28"
},
{
"minute": "30",
"amount": "29"
},
{
"minute": "32",
"amount": "30"
},
{
"minute": "33",
"amount": "32"
},
{
"minute": "34",
"amount": "33"
},
{
"minute": "36",
"amount": "34"
},
{
"minute": "37",
"amount": "35"
},
{
"minute": "39",
"amount": "36"
},
{
"minute": "44",
"amount": "37"
},
{
"minute": "46",
"amount": "41"
},
{
"minute": "45",
"amount": "39"
},
{
"minute": "47",
"amount": "42"
},
{
"minute": "48",
"amount": "43"
},
{
"minute": "49",
"amount": "45"
},
{
"minute": "51",
"amount": "46"
},
{
"minute": "53",
"amount": "48"
},
{
"minute": "55",
"amount": "50"
},
{
"minute": "58",
"amount": "51"
},
{
"minute": "60",
"amount": "54"
},
{
"minute": "63",
"amount": "55"
},
{
"minute": "64",
"amount": "56"
},
{
"minute": "65",
"amount": "59"
},
{
"minute": "66",
"amount": "62"
},
{
"minute": "68",
"amount": "64"
},
{
"minute": "69",
"amount": "65"
},
{
"minute": "71",
"amount": "67"
},
{
"minute": "74",
"amount": "68"
},
{
"minute": "75",
"amount": "69"
},
{
"minute": "77",
"amount": "70"
},
{
"minute": "78",
"amount": "71"
},
{
"minute": "79",
"amount": "73"
},
{
"minute": "80",
"amount": "74"
},
{
"minute": "82",
"amount": "75"
},
{
"minute": "85",
"amount": "77"
},
{
"minute": "87",
"amount": "78"
},
{
"minute": "88",
"amount": "80"
},
{
"minute": "89",
"amount": "81"
},
{
"minute": "90",
"amount": "83"
},
{
"minute": "93",
"amount": "86"
}
]
},
{
"team_id": 121,
"type": "dangerous_attacks",
"analyses": [
{
"minute": "0",
"amount": "0"
},
{
"minute": "1",
"amount": "2"
},
{
"minute": "2",
"amount": "4"
},
{
"minute": "3",
"amount": "6"
},
{
"minute": "4",
"amount": "7"
},
{
"minute": "6",
"amount": "8"
},
{
"minute": "8",
"amount": "10"
},
{
"minute": "9",
"amount": "11"
},
{
"minute": "12",
"amount": "12"
},
{
"minute": "13",
"amount": "13"
},
{
"minute": "18",
"amount": "17"
},
{
"minute": "19",
"amount": "18"
},
{
"minute": "21",
"amount": "19"
},
{
"minute": "29",
"amount": "21"
},
{
"minute": "32",
"amount": "22"
},
{
"minute": "34",
"amount": "23"
},
{
"minute": "35",
"amount": "25"
},
{
"minute": "39",
"amount": "27"
},
{
"minute": "41",
"amount": "29"
},
{
"minute": "42",
"amount": "30"
},
{
"minute": "45",
"amount": "31"
},
{
"minute": "51",
"amount": "34"
},
{
"minute": "54",
"amount": "35"
},
{
"minute": "58",
"amount": "36"
},
{
"minute": "61",
"amount": "37"
},
{
"minute": "63",
"amount": "38"
},
{
"minute": "69",
"amount": "39"
},
{
"minute": "70",
"amount": "42"
},
{
"minute": "73",
"amount": "44"
},
{
"minute": "77",
"amount": "45"
},
{
"minute": "81",
"amount": "47"
},
{
"minute": "82",
"amount": "48"
},
{
"minute": "92",
"amount": "50"
},
{
"minute": "93",
"amount": "52"
}
]
},
{
"team_id": 3506,
"type": "dangerous_attacks",
"analyses": [
{
"minute": "0",
"amount": "0"
},
{
"minute": "4",
"amount": "1"
},
{
"minute": "5",
"amount": "2"
},
{
"minute": "7",
"amount": "4"
},
{
"minute": "13",
"amount": "5"
},
{
"minute": "17",
"amount": "6"
},
{
"minute": "22",
"amount": "7"
},
{
"minute": "23",
"amount": "8"
},
{
"minute": "25",
"amount": "9"
},
{
"minute": "26",
"amount": "11"
},
{
"minute": "27",
"amount": "12"
},
{
"minute": "30",
"amount": "13"
},
{
"minute": "33",
"amount": "14"
},
{
"minute": "34",
"amount": "15"
},
{
"minute": "37",
"amount": "17"
},
{
"minute": "39",
"amount": "18"
},
{
"minute": "47",
"amount": "19"
},
{
"minute": "48",
"amount": "20"
},
{
"minute": "46",
"amount": "22"
},
{
"minute": "49",
"amount": "24"
},
{
"minute": "51",
"amount": "26"
},
{
"minute": "53",
"amount": "27"
},
{
"minute": "56",
"amount": "28"
},
{
"minute": "58",
"amount": "29"
},
{
"minute": "60",
"amount": "30"
},
{
"minute": "63",
"amount": "31"
},
{
"minute": "64",
"amount": "33"
},
{
"minute": "65",
"amount": "35"
},
{
"minute": "66",
"amount": "37"
},
{
"minute": "68",
"amount": "39"
},
{
"minute": "74",
"amount": "40"
},
{
"minute": "75",
"amount": "41"
},
{
"minute": "77",
"amount": "42"
},
{
"minute": "78",
"amount": "43"
},
{
"minute": "79",
"amount": "47"
},
{
"minute": "80",
"amount": "48"
},
{
"minute": "82",
"amount": "49"
},
{
"minute": "83",
"amount": "50"
},
{
"minute": "84",
"amount": "53"
},
{
"minute": "85",
"amount": "54"
},
{
"minute": "88",
"amount": "57"
},
{
"minute": "89",
"amount": "58"
},
{
"minute": "91",
"amount": "59"
},
{
"minute": "94",
"amount": "63"
}
]
},
{
"team_id": 121,
"type": "off_target",
"analyses": [
{
"minute": "0",
"amount": "0"
},
{
"minute": "3",
"amount": "1"
},
{
"minute": "18",
"amount": "2"
},
{
"minute": "41",
"amount": "3"
},
{
"minute": "62",
"amount": "4"
},
{
"minute": "81",
"amount": "5"
},
{
"minute": "82",
"amount": "6"
}
]
},
{
"team_id": 3506,
"type": "off_target",
"analyses": [
{
"minute": "0",
"amount": "0"
},
{
"minute": "24",
"amount": "1"
},
{
"minute": "25",
"amount": "2"
},
{
"minute": "27",
"amount": "3"
},
{
"minute": "38",
"amount": "4"
},
{
"minute": "40",
"amount": "5"
},
{
"minute": "48",
"amount": "6"
},
{
"minute": "46",
"amount": "7"
},
{
"minute": "64",
"amount": "8"
},
{
"minute": "80",
"amount": "9"
},
{
"minute": "94",
"amount": "10"
}
]
},
{
"team_id": 121,
"type": "on_target",
"analyses": [
{
"minute": "0",
"amount": "0"
},
{
"minute": "9",
"amount": "1"
},
{
"minute": "51",
"amount": "2"
},
{
"minute": "54",
"amount": "3"
},
{
"minute": "69",
"amount": "4"
},
{
"minute": "81",
"amount": "5"
}
]
},
{
"team_id": 3506,
"type": "on_target",
"analyses": [
{
"minute": "0",
"amount": "0"
},
{
"minute": "7",
"amount": "1"
},
{
"minute": "14",
"amount": "2"
},
{
"minute": "26",
"amount": "3"
},
{
"minute": "51",
"amount": "4"
},
{
"minute": "71",
"amount": "5"
}
]
},
{
"team_id": 121,
"type": "corners",
"analyses": [
{
"minute": "3",
"amount": "1"
},
{
"minute": "29",
"amount": "2"
},
{
"minute": "69",
"amount": "3"
},
{
"minute": "70",
"amount": "4"
},
{
"minute": "81",
"amount": "5"
},
{
"minute": "92",
"amount": "6"
}
]
},
{
"team_id": 121,
"type": "goals",
"analyses": [
{
"minute": "9",
"amount": "1"
},
{
"minute": "51",
"amount": "2"
},
{
"minute": "54",
"amount": "2"
}
]
},
{
"team_id": 3506,
"type": "goals",
"analyses": [
{
"minute": "14",
"amount": "1"
},
{
"minute": "71",
"amount": "2"
}
]
},
{
"team_id": 3506,
"type": "corners",
"analyses": [
{
"minute": "79",
"amount": "1"
},
{
"minute": "83",
"amount": "3"
},
{
"minute": "94",
"amount": "5"
}
]
},
...
League Stats#back to top
This endpoint allows you to get league stats by ID. By default it will return the current Season of the league
GET Get League Statistics by League ID (Current Season)
API Reference| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/stats/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=league&id={LEAGUE_ID} | |
| Example | https://api.soccersapi.com/v2.2/stats/?user=user1&token=Z5R9jArYsKZmHmP47&t=league&id=594 | |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | league |
| id | integer | LEAGUE_ID |
| season_id | integer | The id of the season |
| number_of_teams | integer | Number of teams |
| number_of_matches | integer | Number of matches |
| number_of_matches_played | integer | Number of matches played |
| number_of_goals | integer | Number of goals scored |
| matches_both_teams_scored | integer | Number of matches on both teams scored |
| number_of_yellowcards | integer | Number of yellow cards |
| number_of_yellowredcards | integer | Number of yellowred cards |
| number_of_redcards | integer | Number of redcards |
| avg_goals_per_match | integer | Average goals per match |
| avg_yellowcards_per_match | integer | Average yellowreds per match |
| avg_redcards_per_match | integer | Average redcards per match |
| team_with_most_goals_id | integer | Team with most goals ID |
| team_with_most_conceded_goals_id | integer | Team with most conceded goals ID |
| team_with_most_goals_per_match_id | integer | Team with most goals per match ID |
| season_topscorer_id | integer | Season topscorer ID |
| team_most_cleansheets_id | integer | Team most cleansheets ID |
| team_most_cleansheets_number | integer | Team most cleansheets number |
| goals_scored_minutes | object | 0-15, 15-30, 30-45, 45-60, 60-75, 75-90 |
| goalkeeper_most_cleansheets_id | integer | Goalkeeper most cleansheets ID |
| goalkeeper_most_cleansheets_number | integer | Goalkeeper most cleansheets number |
| goal_scored_every_minutes | integer | Goal scored every minutes |
| btts | integer | Both teams to score |
| goal_line | object | over, under |
| over | integer | 0_5, 1_5, 2_5, 3_5, 4_5, 5_5 |
| under | integer | 0_5, 1_5, 2_5, 3_5, 4_5, 5_5 |
{
"data": {
"season_id": 406,
"league_id": 594,
"number_of_teams": 18,
"number_of_matches": 502,
"team_most_scored": {
"id": "111",
"total_goals": 81
},
"player_most_scored": {
"id": "19988",
"total_goals": 27
},
"substituted_in": {
"total": 862,
"avg_per_match": 1.72,
"avg_every_minutes": 52
},
"assists": {
"total": 587,
"avg_per_match": 1.17,
"avg_every_minutes": 77
},
"cards": {
"total": {
"total": 978,
"avg_per_match": 1.95,
"avg_every_minutes": 46
},
"yellow": {
"total": 932,
"avg_per_match": 1.86,
"avg_every_minutes": 48
},
"yellowred": {
"total": 28,
"avg_per_match": 0.06,
"avg_every_minutes": 1614
},
"red": {
"total": 18,
"avg_per_match": 0.04,
"avg_every_minutes": 2510
}
},
"goals": {
"overall": {
"total": 812,
"percentage_total_goals": 100,
"avg_per_match": 1.62,
"avg_every_minutes": 56
},
"home": {
"total": 426,
"percentage_total_goals": 52.46,
"avg_per_match": 0.85,
"avg_every_minutes": 106
},
"away": {
"total": 386,
"percentage_total_goals": 47.54,
"avg_per_match": 0.77,
"avg_every_minutes": 117
}
},
"clean_sheets": {
"overall": {
"total": 115,
"avg_total_goals": 22.91
},
"home": {
"total": 65,
"avg_total_goals": 12.95
},
"away": {
"total": 50,
"avg_total_goals": 9.96
}
},
"goals_scored_range": {
"0-15": {
"total": 115,
"percentage_total_goals": 14.16
},
"15-30": {
"total": 89,
"percentage_total_goals": 10.96
},
"30-45": {
"total": 135,
"percentage_total_goals": 16.63
},
"45-60": {
"total": 147,
"percentage_total_goals": 18.1
},
"60-75": {
"total": 131,
"percentage_total_goals": 16.13
},
"75-90": {
"total": 195,
"percentage_total_goals": 24.01
},
"90-120": {
"total": 0,
"percentage_total_goals": 0
}
},
"goal_line": {
"over": {
"0.5": {
"total": 478,
"percentage_total_matches": 95.22
},
"1.5": {
"total": 436,
"percentage_total_matches": 86.85
},
"2.5": {
"total": 334,
"percentage_total_matches": 66.53
},
"3.5": {
"total": 210,
"percentage_total_matches": 41.83
},
"4.5": {
"total": 102,
"percentage_total_matches": 20.32
},
"5.5": {
"total": 48,
"percentage_total_matches": 9.56
}
},
"under": {
"0.5": {
"total": 24,
"percentage_total_matches": 4.78
},
"1.5": {
"total": 24,
"percentage_total_matches": 13.15
},
"2.5": {
"total": 24,
"percentage_total_matches": 33.47
},
"3.5": {
"total": 24,
"percentage_total_matches": 58.17
},
"4.5": {
"total": 24,
"percentage_total_matches": 79.68
},
"5.5": {
"total": 24,
"percentage_total_matches": 90.44
}
}
}
},
...
Season Stats#back to top
This endpoint allows you to get Season stats by ID.
GET Get Season Statistics by Season ID
API Reference| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/stats/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=season&id={SEASON_ID} | |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | season |
| id | integer | SEASON_ID |
| season_id | integer | The id of the season |
| number_of_teams | integer | Number of teams |
| number_of_matches | integer | Number of matches |
| number_of_matches_played | integer | Number of matches played |
| number_of_goals | integer | Number of goals scored |
| matches_both_teams_scored | integer | Number of matches on both teams scored |
| number_of_yellowcards | integer | Number of yellow cards |
| number_of_yellowredcards | integer | Number of yellowred cards |
| number_of_redcards | integer | Number of redcards |
| avg_goals_per_match | integer | Average goals per match |
| avg_yellowcards_per_match | integer | Average yellowreds per match |
| avg_redcards_per_match | integer | Average redcards per match |
| team_with_most_goals_id | integer | Team with most goals ID |
| team_with_most_conceded_goals_id | integer | Team with most conceded goals ID |
| team_with_most_goals_per_match_id | integer | Team with most goals per match ID |
| season_topscorer_id | integer | Season topscorer ID |
| team_most_cleansheets_id | integer | Team most cleansheets ID |
| team_most_cleansheets_number | integer | Team most cleansheets number |
| goals_scored_minutes | object | 0-15, 15-30, 30-45, 45-60, 60-75, 75-90 |
| goalkeeper_most_cleansheets_id | integer | Goalkeeper most cleansheets ID |
| goalkeeper_most_cleansheets_number | integer | Goalkeeper most cleansheets number |
| goal_scored_every_minutes | integer | Goal scored every minutes |
| btts | integer | Both teams to score |
| goal_line | object | over, under |
| over | integer | 0_5, 1_5, 2_5, 3_5, 4_5, 5_5 |
| under | integer | 0_5, 1_5, 2_5, 3_5, 4_5, 5_5 |
{
"data": {
"season_id": 406,
"league_id": 594,
"number_of_teams": 18,
"number_of_matches": 502,
"team_most_scored": {
"id": "111",
"total_goals": 81
},
"player_most_scored": {
"id": "19988",
"total_goals": 27
},
"substituted_in": {
"total": 862,
"avg_per_match": 1.72,
"avg_every_minutes": 52
},
"assists": {
"total": 587,
"avg_per_match": 1.17,
"avg_every_minutes": 77
},
"cards": {
"total": {
"total": 978,
"avg_per_match": 1.95,
"avg_every_minutes": 46
},
"yellow": {
"total": 932,
"avg_per_match": 1.86,
"avg_every_minutes": 48
},
"yellowred": {
"total": 28,
"avg_per_match": 0.06,
"avg_every_minutes": 1614
},
"red": {
"total": 18,
"avg_per_match": 0.04,
"avg_every_minutes": 2510
}
},
"goals": {
"overall": {
"total": 812,
"percentage_total_goals": 100,
"avg_per_match": 1.62,
"avg_every_minutes": 56
},
"home": {
"total": 426,
"percentage_total_goals": 52.46,
"avg_per_match": 0.85,
"avg_every_minutes": 106
},
"away": {
"total": 386,
"percentage_total_goals": 47.54,
"avg_per_match": 0.77,
"avg_every_minutes": 117
}
},
"clean_sheets": {
"overall": {
"total": 115,
"avg_total_goals": 22.91
},
"home": {
"total": 65,
"avg_total_goals": 12.95
},
"away": {
"total": 50,
"avg_total_goals": 9.96
}
},
"goals_scored_range": {
"0-15": {
"total": 115,
"percentage_total_goals": 14.16
},
"15-30": {
"total": 89,
"percentage_total_goals": 10.96
},
"30-45": {
"total": 135,
"percentage_total_goals": 16.63
},
"45-60": {
"total": 147,
"percentage_total_goals": 18.1
},
"60-75": {
"total": 131,
"percentage_total_goals": 16.13
},
"75-90": {
"total": 195,
"percentage_total_goals": 24.01
},
"90-120": {
"total": 0,
"percentage_total_goals": 0
}
},
"goal_line": {
"over": {
"0.5": {
"total": 478,
"percentage_total_matches": 95.22
},
"1.5": {
"total": 436,
"percentage_total_matches": 86.85
},
"2.5": {
"total": 334,
"percentage_total_matches": 66.53
},
"3.5": {
"total": 210,
"percentage_total_matches": 41.83
},
"4.5": {
"total": 102,
"percentage_total_matches": 20.32
},
"5.5": {
"total": 48,
"percentage_total_matches": 9.56
}
},
"under": {
"0.5": {
"total": 24,
"percentage_total_matches": 4.78
},
"1.5": {
"total": 24,
"percentage_total_matches": 13.15
},
"2.5": {
"total": 24,
"percentage_total_matches": 33.47
},
"3.5": {
"total": 24,
"percentage_total_matches": 58.17
},
"4.5": {
"total": 24,
"percentage_total_matches": 79.68
},
"5.5": {
"total": 24,
"percentage_total_matches": 90.44
}
}
}
},
...
Team Stats#back to top
This endpoint allows you to get Team stats by Team ID and season ID.
GET Get Team Statistics by Team ID and Season ID
API Reference| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/stats/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=team&id={TEAM_ID}&season_id={SEASON_ID} | |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | team |
| id | integer | TEAM_ID |
| season_id | integer | SEASON_ID |
| stage_id | integer | The id of the stage |
| win | object | total, home, away |
| draw | object | total, home, away |
| lost | object | total, home, away |
| goals_for | object | total, home, away |
| goals_against | object | total, home, away |
| clean_sheet | object | total, home, away |
| failed_to_score | object | total, home, away |
| scoring_minutes | object | period |
| period | object | minute, count, percentage |
| avg_goals_per_game_scored | integer | The id of the stage |
| avg_goals_per_game_conceded | integer | The id of the stage |
| avg_first_goal_scored | integer | The id of the stage |
| avg_first_goal_conceded | integer | The id of the stage |
| attacks | integer | The number of attacks |
| dangerous_attacks | integer | The number of dangerous attacks |
| avg_ball_possession_percentage | integer | The percentaje of ball possesion |
| fouls | integer | The number of fouls |
| avg_fouls_per_game | integer | The average of fouls per game |
| offsides | integer | The number of offsides |
| redcards | integer | The number of redcards |
| yellowcards | integer | The number of yellowcards |
| shots_blocked | integer | The number of shots blocked |
| shots_off_target | integer | The number of shots off target |
| avg_shots_off_target_per_game | integer | The average of shots off target per game |
| shots_on_target | integer | The number of shots on target |
| avg_shots_on_target_per_game | integer | The average of shots on target per game |
| avg_corners | integer | The average of corners per game |
| total_corners | integer | The number of corners |
| btts | integer | The number of games on both teams to score |
{
"data": {
"98": {
"id": "98",
"league_id": "594",
"season_id": "406",
"total_matches": 26,
"assists": 65,
"substituted_in": 52,
"penalties": 2,
"goals_scored": {
"overall": {
"total": 72,
"avg": 2.77
},
"home": {
"total": 45,
"avg": 3.46
},
"away": {
"total": 27,
"avg": 2.08
}
},
"goals_conceded": {
"overall": {
"total": 33,
"avg": 1.27
},
"home": {
"total": 10,
"avg": 0.77
},
"away": {
"total": 23,
"avg": 1.77
}
},
"clean_sheets": {
"overall": {
"total": 11,
"avg": 33.33
},
"home": {
"total": 8,
"avg": 80
},
"away": {
"total": 3,
"avg": 13.04
}
},
"cards": {
"total": 28,
"yellow": {
"total": 27,
"avg": 96.43
},
"yellowred": {
"total": 1,
"avg": 3.57
},
"redcards": {
"total": 0,
"avg": 0
}
},
"goal_line": {
"over": {
"0.5": {
"overall": {
"total": 25,
"avg": 96.15
},
"home": {
"total": 13,
"avg": 50
},
"away": {
"total": 12,
"avg": 46.15
}
},
"1.5": {
"overall": {
"total": 23,
"avg": 88.46
},
"home": {
"total": 11,
"avg": 42.31
},
"away": {
"total": 12,
"avg": 46.15
}
},
"2.5": {
"overall": {
"total": 22,
"avg": 84.62
},
"home": {
"total": 11,
"avg": 42.31
},
"away": {
"total": 11,
"avg": 42.31
}
},
"3.5": {
"overall": {
"total": 18,
"avg": 69.23
},
"home": {
"total": 10,
"avg": 38.46
},
"away": {
"total": 8,
"avg": 30.77
}
},
"4.5": {
"overall": {
"total": 8,
"avg": 30.77
},
"home": {
"total": 6,
"avg": 23.08
},
"away": {
"total": 2,
"avg": 7.69
}
},
"5.5": {
"overall": {
"total": 6,
"avg": 23.08
},
"home": {
"total": 4,
"avg": 15.38
},
"away": {
"total": 2,
"avg": 7.69
}
}
},
"under": {
"0.5": {
"overall": {
"total": 1,
"avg": 3.85
},
"home": {
"total": 0,
"avg": 0
},
"away": {
"total": 1,
"avg": 3.85
}
},
"1.5": {
"overall": {
"total": 3,
"avg": 11.54
},
"home": {
"total": 2,
"avg": 7.69
},
"away": {
"total": 1,
"avg": 3.85
}
},
"2.5": {
"overall": {
"total": 4,
"avg": 15.38
},
"home": {
"total": 2,
"avg": 7.69
},
"away": {
"total": 2,
"avg": 7.69
}
},
"3.5": {
"overall": {
"total": 8,
"avg": 30.77
},
"home": {
"total": 3,
"avg": 11.54
},
"away": {
"total": 5,
"avg": 19.23
}
},
"4.5": {
"overall": {
"total": 18,
"avg": 69.23
},
"home": {
"total": 7,
"avg": 26.92
},
"away": {
"total": 11,
"avg": 42.31
}
},
"5.5": {
"overall": {
"total": 20,
"avg": 76.92
},
"home": {
"total": 9,
"avg": 26.92
},
"away": {
"total": 11,
"avg": 42.31
}
}
}
}
}
},
...
Player Stats / Season#back to top
The Player Stats Endpoint gives you singular player statistics by season ID
GET Get Player Statistics by Player ID and Season ID
Description
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/stats/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=player&id={PLAYER_ID}&season_id={SEASON_ID} |
| Example | https://api.soccersapi.com/v2.2/stats/?user=user1&token=Z5R9jArYsKZmHmP47&t=player&id=13185&season_id=406 |
| No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | player |
| id | integer | PLAYER_ID |
| season_id | integer | SEASON_ID |
Response Attributes
| player_id | integer | The id of the player |
| number | string | The number of the player |
| captain | boolean | Boolean if the player is captain |
| position_id | integer | The id of the position |
| injured | boolean | true or false |
| minutes_played | integer | The amount of minutes played in the current season |
| appearences | integer | Number of appearences |
| lineups | integer | Number of lineups |
| substitute_in | integer | Number of substitutes in |
| substitute_out | integer | Number of substitutes out |
| substitutes_on_bench | integer | Number of substitutes on bench |
| goals | integer | Number of goals |
| assists | integer | Number of assists |
| saves | integer | Number of saves |
| inside_box_saves | integer | Number of inside box saves |
| dispossesed | boolean | Number of dispossesed |
| interceptions | integer | Number of interceptions |
| yellowcards | integer | Number of yellowcards |
| yellowred | integer | Number of yellowreds |
| redcards | integer | Number of redcards |
| tackles | integer | Number of tackles |
| blocks | integer | Number of blocks |
| hit_post | integer | Number of hit post |
| fouls | object | commited, drawn |
| crosses | object | total, accurate |
| dribbles | object | attempts, success, dribbled_past |
| duels | object | total, won |
| passes | object | total, accuracy, key_passes |
| penalties | object | won, scores, missed, committed, saves |
Response Example
{
"data": {
"id": "13185",
"name": "Hummels, Mats",
"matches": {
"played": {
"total": 24,
"avg": 100
},
"starting": {
"total": 24,
"avg": 100
}
},
"minutes_played": 1998,
"assists": {
"total": 4,
"avg": 16.67
},
"penalties": {
"total": null,
"avg": 0
},
"offsides": {
"total": 1,
"avg": 4.17
},
"corners": {
"total": null,
"avg": 0
},
"substitutions": {
"in": {
"total": null,
"avg": 0
},
"out": {
"total": 3,
"avg": 12.5
}
},
"cards": {
"yellow": {
"total": 3,
"avg": 12.5
},
"yellowred": {
"total": 0,
"avg": 0
},
"redcards": {
"total": 0,
"avg": 0
}
},
"goals": {
"total": 1,
"avg": 4.17
},
"shots": {
"total": 19,
"on_target": {
"total": 5,
"avg": 26.32
},
"off_target": {
"total": 13,
"avg": 68.42
},
"blocked": {
"total": 1,
"avg": 5.26
}
}
},
...
Match H2H#back to top
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.
GETGet Match Head to Head
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/h2h/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=match&id={MATCH_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | match |
| id | string | MATCH_ID |
Response
Response Example
{
"data": {
"home": {
"id": "111",
"name": "FC Bayern Munich",
"events": {
"overall": [
{
"id": "15244112",
"startdate": "2020-06-16 20:30:00",
"league": {
"id": "594",
"name": "Bundesliga",
"country": {
"id": "4",
"name": "Germany",
"cc": "DEU"
}
},
"teams": {
"home": {
"id": "2810",
"name": "Werder Bremen"
},
"away": {
"id": "111",
"name": "FC Bayern Munich"
}
},
"ft_score": "0-1",
"form": "L"
},
{
"id": "15237670",
"startdate": "2020-06-13 18:30:00",
"league": {
"id": "594",
"name": "Bundesliga",
"country": {
"id": "4",
"name": "Germany",
"cc": "DEU"
}
},
"teams": {
"home": {
"id": "111",
"name": "FC Bayern Munich"
},
"away": {
"id": "2815",
"name": "Borussia Monchengladbach"
}
},
"ft_score": "2-1",
"form": "W"
},
{
"id": "15222964",
"startdate": "2020-06-10 20:45:00",
"league": {
"id": "595",
"name": "DFB Pokal",
"country": {
"id": "4",
"name": "Germany",
"cc": "DEU"
}
},
"teams": {
"home": {
"id": "111",
"name": "FC Bayern Munich"
},
"away": {
"id": "2817",
"name": "Eintracht Frankfurt"
}
},
"ft_score": "2-1",
"form": "W"
},
...
H2H Team vs Team#back to top
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.
GETGet team vs team Head to Head
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/h2h/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=teams&team1={TEAM1_ID}&team2={TEAM2_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | match |
| team1 | int | TEAM1_ID |
| team2 | int | TEAM2_ID |
Response
Response Example
{
"data": {
"home": {
"id": "99",
"name": "FC Barcelona",
"events": {
"overall": [
{
"id": "31198879",
"startdate": "2020-06-16 22:00:00",
"league": {
"id": "637",
"name": "LaLiga",
"country": {
"id": "5",
"name": "Spain",
"cc": "ESP"
}
},
"teams": {
"home": {
"id": "99",
"name": "FC Barcelona"
},
"away": {
"id": "121",
"name": "CD Leganes"
}
},
"ft_score": "2-0",
"form": "W"
},
{
"id": "28055364",
"startdate": "2020-06-13 22:00:00",
"league": {
"id": "637",
"name": "LaLiga",
"country": {
"id": "5",
"name": "Spain",
"cc": "ESP"
}
},
"teams": {
"home": {
"id": "119",
"name": "RCD Mallorca"
},
"away": {
"id": "99",
"name": "FC Barcelona"
}
},
"ft_score": "0-4",
"form": "L"
},
...
Topscorers (Leaders)#back to top
The Topscorers Endpoint gives you a list of players leaders in goals, assists and cards by season.
GET Get Topscorers By Season ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/topscorers/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=topscorers&season_id={SEASON_ID} |
| Example | https://api.soccersapi.com/v2.2/topscorers/?user=user1&token=Z6R9jArYsKZmHmP47&t=topscorers&season_id=406 |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | topscorers |
| season_id | integer | SEASON_ID |
| goalscorers | object | position, season_id, player_id, team_id, stage_id, goals, penalty_goals, type |
| position | integer | Player position |
| season_id | integer | Season ID |
| player_id | integer | Player ID |
| team_id | integer | Team ID |
| stage_id | integer | Stage ID |
| goals | integer | Number of goals |
| penalty_goals | integer | number of penalty goals |
| type | integer | goals |
| cardscorers | object | position, season_id, player_id, team_id, stage_id, yellowcards, redcards, type |
| position | integer | Player position |
| season_id | integer | Season ID |
| player_id | integer | Player ID |
| team_id | integer | Team ID |
| stage_id | integer | Stage ID |
| yellowcards | integer | Number of yellowcards |
| redcards | integer | number of redcards |
| type | integer | cards |
| assistscorers | object | position, season_id, player_id, team_id, stage_id, assists, type |
| position | integer | Player position |
| season_id | integer | Season ID |
| player_id | integer | Player ID |
| team_id | integer | Team ID |
| stage_id | integer | Stage ID |
| assists | integer | Number of assists |
| type | integer | assists |
Response Example
{
"data": [
{
"pos": 1,
"player": {
"id": "1572",
"name": "Bailey, Leon"
},
"team": {
"id": "114",
"name": "Leverkusen"
},
"league_id": "594",
"season_id": "406",
"matches_played": 22,
"minutes_played": 1094,
"substituted_in": 10,
"yellowcards": null,
"yellowredcards": null,
"redcards": 2
},
{
"pos": 2,
"player": {
"id": "12119",
"name": "Hubner, Benjamin"
},
"team": {
"id": "2818",
"name": "Hoffenheim"
},
"league_id": "594",
"season_id": "406",
"matches_played": 25,
"minutes_played": 2075,
"substituted_in": 0,
"yellowcards": 4,
"yellowredcards": 1,
"redcards": 1
},
...
Topassists (Leaders)#back to top
The Topassists Endpoint gives you a list of players leaders by season.
GET Get Topassists By Season ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/topscorers/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=topscorers&season_id={SEASON_ID} |
| Example | https://api.soccersapi.com/v2.2/topscorers/?user=user1&token=Z6R9jArYsKZmHmP47&t=topscorers&season_id=406 |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | topassists |
| season_id | integer | SEASON_ID |
| goalscorers | object | position, season_id, player_id, team_id, stage_id, goals, penalty_goals, type |
| position | integer | Player position |
| season_id | integer | Season ID |
| player_id | integer | Player ID |
| team_id | integer | Team ID |
| stage_id | integer | Stage ID |
| goals | integer | Number of goals |
| penalty_goals | integer | number of penalty goals |
| type | integer | goals |
| cardscorers | object | position, season_id, player_id, team_id, stage_id, yellowcards, redcards, type |
| position | integer | Player position |
| season_id | integer | Season ID |
| player_id | integer | Player ID |
| team_id | integer | Team ID |
| stage_id | integer | Stage ID |
| yellowcards | integer | Number of yellowcards |
| redcards | integer | number of redcards |
| type | integer | cards |
| assistscorers | object | position, season_id, player_id, team_id, stage_id, assists, type |
| position | integer | Player position |
| season_id | integer | Season ID |
| player_id | integer | Player ID |
| team_id | integer | Team ID |
| stage_id | integer | Stage ID |
| assists | integer | Number of assists |
| type | integer | assists |
Response Example
{
"data": [
{
"pos": 1,
"player": {
"id": "17327",
"name": "Muller, Thomas"
},
"team": {
"id": "111",
"name": "Bayern Munich"
},
"league_id": "594",
"season_id": "406",
"matches_played": 33,
"minutes_played": 0,
"substituted_in": 7,
"assists": 20
},
{
"pos": 2,
"player": {
"id": "6260",
"name": "Sancho, Jadon"
},
"team": {
"id": "98",
"name": "Dortmund"
},
"league_id": "594",
"season_id": "406",
"matches_played": 32,
"minutes_played": 0,
"substituted_in": 7,
"assists": 16
},
...
Topcards (Leaders)#back to top
The Topcards Endpoint gives you a list of players leaders in cards by season.
GET Get Topscorers By Season ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/topscorers/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=topcards&season_id={SEASON_ID} |
| Example | https://api.soccersapi.com/v2.2/topscorers/?user=user1&token=Z6R9jArYsKZmHmP47&t=topcards&season_id=406 |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | topcards |
| season_id | integer | SEASON_ID |
| goalscorers | object | position, season_id, player_id, team_id, stage_id, goals, penalty_goals, type |
| position | integer | Player position |
| season_id | integer | Season ID |
| player_id | integer | Player ID |
| team_id | integer | Team ID |
| stage_id | integer | Stage ID |
| goals | integer | Number of goals |
| penalty_goals | integer | number of penalty goals |
| type | integer | goals |
| cardscorers | object | position, season_id, player_id, team_id, stage_id, yellowcards, redcards, type |
| position | integer | Player position |
| season_id | integer | Season ID |
| player_id | integer | Player ID |
| team_id | integer | Team ID |
| stage_id | integer | Stage ID |
| yellowcards | integer | Number of yellowcards |
| redcards | integer | number of redcards |
| type | integer | cards |
| assistscorers | object | position, season_id, player_id, team_id, stage_id, assists, type |
| position | integer | Player position |
| season_id | integer | Season ID |
| player_id | integer | Player ID |
| team_id | integer | Team ID |
| stage_id | integer | Stage ID |
| assists | integer | Number of assists |
| type | integer | assists |
Response Example
{
"data": [
{
"pos": 1,
"player": {
"id": "1572",
"name": "Bailey, Leon"
},
"team": {
"id": "114",
"name": "Leverkusen"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 719,
"yellowcards": null,
"yellowredcards": null,
"redcards": 2
},
{
"pos": 2,
"player": {
"id": "9101",
"name": "Schlotterbeck, Keven"
},
"team": {
"id": "2819",
"name": "Union Berlin"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1313,
"yellowcards": 5,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 3,
"player": {
"id": "10342",
"name": "Ehizibue, Kingsley"
},
"team": {
"id": "2809",
"name": "Cologne"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1826,
"yellowcards": 5,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 4,
"player": {
"id": "9123",
"name": "Kohr, Dominik"
},
"team": {
"id": "2817",
"name": "Frankfurt"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 906,
"yellowcards": 5,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 5,
"player": {
"id": "17324",
"name": "Boateng, Jerome"
},
"team": {
"id": "111",
"name": "Bayern Munich"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1193,
"yellowcards": 5,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 6,
"player": {
"id": "1617",
"name": "Baku, Ridle"
},
"team": {
"id": "2813",
"name": "Mainz"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1764,
"yellowcards": 4,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 7,
"player": {
"id": "10358",
"name": "Mere, Jorge"
},
"team": {
"id": "2809",
"name": "Cologne"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 513,
"yellowcards": 4,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 8,
"player": {
"id": "1554",
"name": "Tah, Jonathan"
},
"team": {
"id": "114",
"name": "Leverkusen"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1763,
"yellowcards": 4,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 9,
"player": {
"id": "5624",
"name": "Abraham, David"
},
"team": {
"id": "2817",
"name": "Frankfurt"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1242,
"yellowcards": 2,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 10,
"player": {
"id": "9108",
"name": "Polter, Sebastian"
},
"team": {
"id": "2819",
"name": "Union Berlin"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 308,
"yellowcards": 1,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 11,
"player": {
"id": "16616",
"name": "Pongracic, Marin"
},
"team": {
"id": "2808",
"name": "Wolfsburg"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 228,
"yellowcards": 1,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 12,
"player": {
"id": "12107",
"name": "Nubel, Alexander"
},
"team": {
"id": "2816",
"name": "Schalke"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1776,
"yellowcards": 1,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 13,
"player": {
"id": "10337",
"name": "Holtmann, Gerrit"
},
"team": {
"id": "2807",
"name": "Paderborn"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 767,
"yellowcards": 1,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 14,
"player": {
"id": "12099",
"name": "Grifo, Vincenzo"
},
"team": {
"id": "2818",
"name": "Hoffenheim"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 953,
"yellowcards": 1,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 15,
"player": {
"id": "12062",
"name": "Jarstein, Rune"
},
"team": {
"id": "2806",
"name": "Hertha"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1918,
"yellowcards": 1,
"yellowredcards": null,
"redcards": 1
},
{
"pos": 16,
"player": {
"id": "1607",
"name": "Tisserand, Marcel"
},
"team": {
"id": "2808",
"name": "Wolfsburg"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1204,
"yellowcards": 6,
"yellowredcards": 1,
"redcards": null
},
{
"pos": 17,
"player": {
"id": "10327",
"name": "Collins, Jamilu"
},
"team": {
"id": "2807",
"name": "Paderborn"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1949,
"yellowcards": 6,
"yellowredcards": 1,
"redcards": null
},
{
"pos": 18,
"player": {
"id": "14737",
"name": "Laimer, Konrad"
},
"team": {
"id": "101",
"name": "Leipzig"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1799,
"yellowcards": 6,
"yellowredcards": 1,
"redcards": null
},
{
"pos": 19,
"player": {
"id": "12061",
"name": "Darida, Vladimir"
},
"team": {
"id": "2806",
"name": "Hertha"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1597,
"yellowcards": 5,
"yellowredcards": 1,
"redcards": null
},
{
"pos": 20,
"player": {
"id": "6802",
"name": "Friedrich, Marvin"
},
"team": {
"id": "2819",
"name": "Union Berlin"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 2070,
"yellowcards": 5,
"yellowredcards": 1,
"redcards": null
},
{
"pos": 21,
"player": {
"id": "1630",
"name": "Fernandes, Edimilson"
},
"team": {
"id": "2813",
"name": "Mainz"
},
"league_id": "594",
"season_id": "406",
"minutes_played": 1267,
"yellowcards": 4,
"yellowredcards": 1,
"redcards": null
},
...
Bookmakers#back to top
The Bookmakers Endpoint gives you a list of all Bookmakers available in your plan
GETGet Bookmakers
API ReferenceDescription
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/bookmakers/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=list | |
| Example | https://api.soccersapi.com/v2.2/bookmakers/?user=user1&token=Z5R9jArYsKZmHmP47&t=list | |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | list |
Response
| id | integer | The id of the bookmaker |
| name | integer | The name of the bookmaker |
| img | object | The logo of the bookmaker |
Response Example
{
"data": [
{
"id": "1",
"name": "10Bet",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/1.png"
},
{
"id": "2",
"name": "bet365",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/2.png"
},
{
"id": "3",
"name": "188Bet",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/3.png"
},
{
"id": "5",
"name": "888Sport",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/5.png"
},
{
"id": "6",
"name": "Bet Fred",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/6.png"
},
{
"id": "7",
"name": "Bet-At-Home",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/7.png"
},
{
"id": "9",
"name": "Betfair",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/9.png"
},
{
"id": "14",
"name": "Dafabet",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/14.png"
},
{
"id": "15",
"name": "Intertops",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/15.png"
},
{
"id": "16",
"name": "Marathonbet",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/16.png"
},
{
"id": "20",
"name": "Pinnacle",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/20.png"
},
{
"id": "23",
"name": "Unibet",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/23.png"
},
{
"id": "26",
"name": "Betsson",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/26.png"
},
{
"id": "27",
"name": "Interwetten",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/27.png"
},
{
"id": "28",
"name": "BWin",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/28.png"
},
{
"id": "31",
"name": "TitanBet",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/31.png"
},
{
"id": "32",
"name": "Ladbrokes",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/32.png"
},
{
"id": "35",
"name": "1xbet",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/35.png"
},
{
"id": "36",
"name": "Betway",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/36.png"
},
{
"id": "37",
"name": "WilliamHill",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/37.png"
},
{
"id": "38",
"name": "Betclic",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/38.png"
},
{
"id": "39",
"name": "CloudBet",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/39.png"
},
{
"id": "40",
"name": "SBOBET",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/40.png"
}
],
...
Bookmaker by ID#back to top
The Bookmaker by ID Endpoint gives you information of a specific bookmaker by ID
GETGet Bookmaker by ID
API ReferenceDescription
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/bookmakers/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id=BOOKMAKER_ID | |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | BOOKMAKER_ID |
Response
| id | integer | The id of the bookmaker |
| name | integer | The name of the bookmaker |
| img | object | The logo of the bookmaker |
Response Example
{
"data": {
"id": "2",
"name": "bet365",
"img": "https://cdn.soccersapi.com/images/soccer/bookmakers/2.png"
},
...
Markets#back to top
The Markets Endpoint gives a list of all available markets
GETGet Markets
API ReferenceDescription
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/markets/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=list | |
| Example | https://api.soccersapi.com/v2.2/markets/?user=user1&token=Z5R9jArYsKZmHmP47&t=list | |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | list |
Response
| id | integer | The id of the market |
| name | integer | The name of the market |
Response Example
{
"data": [
{
"id": "1",
"name": "1X2, Full Time Result"
},
{
"id": "2",
"name": "Over/Under, Goal Line"
},
{
"id": "3",
"name": "Asian Handicap"
},
{
"id": "4",
"name": "1st Half Asian Handicap"
},
{
"id": "5",
"name": "Asian Corners"
},
{
"id": "6",
"name": "1st Half Goal Line"
},
{
"id": "7",
"name": "1st Half Asian Corners"
},
{
"id": "8",
"name": "Half Time Result"
}
],
...
Market by ID#back to top
The Market by ID Endpoint gives you information of a specific market
GETGet Market by ID
API ReferenceDescription
| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/markets/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id=MARKET_ID | |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | MARKET_ID |
Response
| id | integer | The id of the market |
| name | integer | The name of the market |
Response Example
{
"data": {
"id": "1",
"name": "1X2, Full Time Result"
},
...
Pre-Match Odds#back to top
The Pre-Match Odds Endpoint gives you Pre-match odds for a specific match
GETGet Pre-Match Odds
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=match_odds&id={MATCH_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | match_odds |
| id | integer | MATCH_ID |
Response
| id | integer | The id of the market |
| name | string | The name of the market |
| bookmakers | object | id, name, odds |
| id | integer | The id of the bookmaker |
| name | string | The name of the bookmaker |
| odds | object | label, value, wining, handicap, total, bookmaker_event_id, last_update |
| last_update | object | date, timezone_type, timezone |
Response Example
{
"data": [
{
"id": 1,
"name": "1X2, Full Time Result",
"bookmakers": {
"data": [
{
"id": 2,
"name": "Bet365",
"odds": {
"data": [
{
"label": 1,
"value": "1.002",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": "X",
"value": "51.000",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": 2,
"value": "151.000",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
}
]
}
},
{
"id": 1,
"name": "10Bet",
"odds": {
"data": [
{
"label": 1,
"value": "0",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": "X",
"value": "0",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": 2,
"value": "0",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
}
]
}
},
{
"id": 32,
"name": "Ladbrokes",
"odds": {
"data": [
{
"label": 1,
"value": "1.57",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": "X",
"value": "4.20",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": 2,
"value": "5.75",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
}
]
}
},
{
"id": 37,
"name": "WilliamHill",
"odds": {
"data": [
{
"label": 1,
"value": "1.53",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": "X",
"value": "4.33",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": 2,
"value": "6",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
}
]
}
},
{
"id": 3,
"name": "188Bet",
"odds": {
"data": [
{
"label": 1,
"value": "1.02",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": "X",
"value": "21.0",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": 2,
"value": "41.0",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
}
]
}
},
{
"id": 23,
"name": "UniBet",
"odds": {
"data": [
{
"label": 1,
"value": "1",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": "X",
"value": "1001",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": 2,
"value": "1",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
}
]
}
},
{
"id": 28,
"name": "BWin",
"odds": {
"data": [
{
"label": 1,
"value": "1",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": "X",
"value": "1",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": 2,
"value": "1",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
}
]
}
},
{
"id": 9,
"name": "BetFair",
"odds": {
"data": [
{
"label": 1,
"value": "1",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
...
In-Play Odds#back to top
The In-Play Odds Endpoint gives you Live odds while the match is playing
GETGet In-Play Odds
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=match_oddsinplay&id={MATCH_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | match_oddsinplay |
| id | integer | MATCH_ID |
Response
| id | integer | The id of the market |
| name | string | The name of the market |
| bookmakers | object | id, name, odds |
| id | integer | The id of the bookmaker |
| name | string | The name of the bookmaker |
| odds | object | label, value, american, fractional, suspend, description, handicap, total, bookmaker_event_id, last_update |
| last_update | object | date, timezone_type, timezone |
Response Example
{
"data": [
{
"id": 1,
"name": "1X2, Full Time Result",
"bookmakers": {
"data": [
{
"id": 2,
"name": "Bet365",
"odds": {
"data": [
{
"label": 1,
"value": "1.550",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": "X",
"value": "4.333",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": 2,
"value": "5.500",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
}
]
}
},
{
"id": 1,
"name": "10Bet",
"odds": {
"data": [
{
"label": 1,
"value": "1.541",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": "X",
"value": "4.250",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": 2,
"value": "5.600",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
}
]
}
},
{
"id": 32,
"name": "Ladbrokes",
"odds": {
"data": []
}
},
{
"id": 37,
"name": "WilliamHill",
"odds": {
"data": []
}
},
{
"id": 3,
"name": "188Bet",
"odds": {
"data": [
{
"label": 1,
"value": "1.58",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": "X",
"value": "4.30",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": 2,
"value": "5.40",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
}
]
}
},
{
"id": 23,
"name": "UniBet",
"odds": {
"data": [
{
"label": 1,
"value": "1.58",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": "X",
"value": "4.1",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": 2,
"value": "5.6",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
}
]
}
},
{
"id": 28,
"name": "BWin",
"odds": {
"data": [
{
"label": 1,
"value": "1.53",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": "X",
"value": "4.25",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
{
"label": 2,
"value": "5.5",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
}
]
}
},
{
"id": 9,
"name": "BetFair",
"odds": {
"data": [
{
"label": 1,
"value": "1.5",
"winning": null,
"handicap": null,
"total": null,
"bookmaker_event_id": null,
"last_update": {
"date": null,
"timezone_type": null,
"timezone": null
}
},
...
Match Odds by Bookmaker#back to top
The Match Odds by Bookmaker Endpoint returns all odds for a match in a more detailed way from a single bookmaker.
GETGet Match Odds by Bookmaker
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=match_odds_info&id={MATCH_ID}&bookmaker_id={BOOKMAKER_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | match_odds_info |
| bookmaker_id | integer | BOOKMAKER_ID |
Response
| id | integer | The id of the market |
| name | string | The name of the market |
| bookmakers | object | id, name, odds |
| id | integer | The id of the bookmaker |
| name | string | The name of the bookmaker |
| odds | object | label, value, american, fractional, suspend, description, handicap, total, bookmaker_event_id, last_update |
| last_update | object | date, timezone_type, timezone |
Response Example
{
"data": {
"id": "1",
"name": "10bet",
"markets": [
{
"id": 1,
"name": "1X2, Full Time Result",
"odds": [
{
"home": "0",
"draw": "0",
"away": "0",
"handicap": null,
"score": "1:0",
"minute": "93:38",
"bookmaker_event_id": null,
"last_update": {
"date": "2020-06-05 21:22",
"timezone": "UTC"
}
},
{
"home": "1.018",
"draw": "13.000",
"away": "48.500",
"handicap": null,
"score": "1:0",
"minute": "93:32",
"bookmaker_event_id": null,
"last_update": {
"date": "2020-06-05 21:22",
"timezone": "UTC"
}
},
{
"home": "1.021",
"draw": "12.500",
"away": "48.500",
"handicap": null,
"score": "1:0",
"minute": "93:09",
"bookmaker_event_id": null,
"last_update": {
"date": "2020-06-05 21:21",
"timezone": "UTC"
}
},
{
"home": "1.005",
"draw": "17.500",
"away": "48.500",
"handicap": null,
"score": "1:0",
"minute": "92:52",
"bookmaker_event_id": null,
"last_update": {
"date": "2020-06-05 21:21",
"timezone": "UTC"
}
},
{
"home": "1.010",
"draw": "15.250",
"away": "48.500",
"handicap": null,
"score": "1:0",
"minute": "92:46",
"bookmaker_event_id": null,
"last_update": {
"date": "2020-06-05 21:21",
"timezone": "UTC"
}
},
{
"home": "1.006",
"draw": "15.750",
"away": "48.500",
"handicap": null,
"score": "1:0",
"minute": "92:27",
"bookmaker_event_id": null,
"last_update": {
"date": "2020-06-05 21:20",
"timezone": "UTC"
}
},
{
"home": "1.010",
"draw": "15.250",
"away": "48.500",
"handicap": null,
"score": "1:0",
"minute": "92:21",
"bookmaker_event_id": null,
"last_update": {
"date": "2020-06-05 21:20",
"timezone": "UTC"
}
},
{
"home": "1.018",
"draw": "13.000",
"away": "48.500",
"handicap": null,
"score": "1:0",
"minute": "91:22",
"bookmaker_event_id": null,
"last_update": {
"date": "2020-06-05 21:19",
"timezone": "UTC"
}
},
{
"home": "1.040",
"draw": "10.000",
"away": "48.500",
"handicap": null,
"score": "1:0",
"minute": "90:47",
"bookmaker_event_id": null,
"last_update": {
"date": "2020-06-05 21:19",
"timezone": "UTC"
}
},
{
"home": "1.036",
"draw": "10.500",
"away": "48.500",
"handicap": null,
"score": "1:0",
"minute": "90:29",
"bookmaker_event_id": null,
"last_update": {
"date": "2020-06-05 21:18",
"timezone": "UTC"
}
},
{
"home": "1.021",
"draw": "12.500",
"away": "48.500",
"handicap": null,
"score": "1:0",
"minute": "90:17",
"bookmaker_event_id": null,
"last_update": {
"date": "2020-06-05 21:18",
"timezone": "UTC"
}
},
{
"home": "1.036",
"draw": "10.500",
"away": "48.500",
"handicap": null,
"score": "1:0",
"minute": "90:05",
"bookmaker_event_id": null,
"last_update": {
"date": "2020-06-05 21:18",
"timezone": "UTC"
}
},
...
Player by ID#back to top
The Player by ID endpoint returns information of a single player
GETGet player By ID
API Reference| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/players/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id={PLAYER_ID} | |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | PLAYER_ID |
| id | integer | The id of the player |
| name | string | The name of the player |
| common_name | string | Common name of the player |
| firstname | string | Firstname of the player |
| lastname | string | Lastname of the player |
| position | string | Position of the player |
| birthday | string | The birthday of the player |
| birthcountry | string | The birthcountry of the player |
| birthplace | string | The birthplace of the player |
| weight | string | The weight of the player |
| height | string | The height of the player |
| img | string | The image of the player |
| country | object | id, name, cc |
{
"data": {
"id": "13185",
"team_id": null,
"name": "Hummels, Mats Julian",
"common_name": "Hummels, Mats",
"position": "D",
"firstname": "Mats Julian",
"lastname": "Hummels",
"birthday": "16/12/88",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "15",
"weight": "94",
"height": "191",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/13185.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
...
Players by Country#back to top
The Players by Country ID Endpoint return all players from a specific country (Nationality)
GETGet player By ID
API Reference| Headers | application/json | |
| Endpoint | https://api.soccersapi.com/v2.2/players/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=list&country_id={COUNTRY_ID} | |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | list |
| country_id | integer | COUNTRY_ID |
| id | integer | The id of the player |
| name | string | The name of the player |
| common_name | string | Common name of the player |
| firstname | string | Firstname of the player |
| lastname | string | Lastname of the player |
| birthday | string | The birthday of the player |
| birthcountry | string | The birthcountry of the player |
| birthplace | string | The birthplace of the player |
| w | string | The weight of the player |
| h | string | The height of the player |
| img | string | The image of the player |
| country | object | id, name, cc |
{
"data": [
{
"id": "195",
"team_id": null,
"name": "",
"common_name": "Ristl, Mart",
"position": "M",
"firstname": "Mart",
"lastname": "Ristl",
"birthday": "07/07/96",
"birthcountry": null,
"birthplace": null,
"shirtnumber": null,
"weight": "74",
"height": "178",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/195.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "198",
"team_id": null,
"name": "",
"common_name": "Jastrzembski, Dennis",
"position": "F",
"firstname": "Dennis",
"lastname": "Jastrzembski",
"birthday": "20/02/00",
"birthcountry": null,
"birthplace": null,
"shirtnumber": null,
"weight": "77",
"height": "176",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/198.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "225",
"team_id": null,
"name": "",
"common_name": "Steinborn, Matthias",
"position": "F",
"firstname": "Matthias",
"lastname": "Steinborn",
"birthday": "05/03/89",
"birthcountry": null,
"birthplace": null,
"shirtnumber": null,
"weight": "0",
"height": "186",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/225.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "227",
"team_id": null,
"name": "",
"common_name": "Prokoph, Roman",
"position": "F",
"firstname": "Roman",
"lastname": "Prokoph",
"birthday": "06/08/85",
"birthcountry": null,
"birthplace": null,
"shirtnumber": null,
"weight": "76",
"height": "183",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/227.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "275",
"team_id": null,
"name": "",
"common_name": "Gondorf, Jerome",
"position": "M",
"firstname": "Jerome",
"lastname": "Gondorf",
"birthday": "26/06/88",
"birthcountry": null,
"birthplace": null,
"shirtnumber": null,
"weight": "76",
"height": "175",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/275.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "277",
"team_id": null,
"name": "",
"common_name": "Fetsch, Mathias",
"position": "F",
"firstname": "Mathias",
"lastname": "Fetsch",
"birthday": "30/09/88",
"birthcountry": null,
"birthplace": null,
"shirtnumber": null,
"weight": "85",
"height": "189",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/277.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "316",
"team_id": null,
"name": "",
"common_name": "Fahrmann, Ralf",
"position": "G",
"firstname": "Ralf",
"lastname": "Fahrmann",
"birthday": "27/09/88",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "21",
"weight": "95",
"height": "197",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/316.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "317",
"team_id": null,
"name": "",
"common_name": "Stiepermann, Marco",
"position": "M",
"firstname": "Marco",
"lastname": "Stiepermann",
"birthday": "09/02/91",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "18",
"weight": "75",
"height": "190",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/317.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "320",
"team_id": null,
"name": "",
"common_name": "Trybull, Tom",
"position": "M",
"firstname": "Tom",
"lastname": "Trybull",
"birthday": "09/03/93",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "19",
"weight": "72",
"height": "181",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/320.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "476",
"team_id": null,
"name": "",
"common_name": "Rupp, Lukas",
"position": "M",
"firstname": "Lukas",
"lastname": "Rupp",
"birthday": "08/01/91",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "7",
"weight": "73",
"height": "178",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/476.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "480",
"team_id": null,
"name": "",
"common_name": "Leno, Bernd",
"position": "G",
"firstname": "Bernd",
"lastname": "Leno",
"birthday": "04/03/92",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "1",
"weight": "83",
"height": "190",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/480.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "482",
"team_id": null,
"name": "",
"common_name": "Mustafi, Shkodran",
"position": "D",
"firstname": "Shkodran",
"lastname": "Mustafi",
"birthday": "17/04/92",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "20",
"weight": "82",
"height": "184",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/482.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "488",
"team_id": null,
"name": "",
"common_name": "Ozil, Mesut",
"position": "M",
"firstname": "Mesut",
"lastname": "Ozil",
"birthday": "15/10/88",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "10",
"weight": "70",
"height": "180",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/488.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "679",
"team_id": null,
"name": "",
"common_name": "Kehrer, Thilo",
"position": "D",
"firstname": "Thilo",
"lastname": "Kehrer",
"birthday": "21/09/96",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "4",
"weight": "76",
"height": "186",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/679.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "693",
"team_id": null,
"name": "",
"common_name": "Draxler, Julian",
"position": "M",
"firstname": "Julian",
"lastname": "Draxler",
"birthday": "20/09/93",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "23",
"weight": "74",
"height": "185",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/693.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "918",
"team_id": null,
"name": "Buyuksakarya, Marvin Sinan",
"common_name": "Buyuksakarya, Marvin",
"position": "D",
"firstname": "Marvin Sinan",
"lastname": "Buyuksakarya",
"birthday": "11/04/95",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "14",
"weight": "68",
"height": "173",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/918.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "934",
"team_id": null,
"name": "",
"common_name": "Sen, Utku",
"position": "F",
"firstname": "Utku",
"lastname": "Sen",
"birthday": "15/06/98",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "11",
"weight": "83",
"height": "178",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/934.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "1335",
"team_id": null,
"name": "",
"common_name": "Niepsuj, David",
"position": "D",
"firstname": "David",
"lastname": "Niepsuj",
"birthday": "16/08/95",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "19",
"weight": "76",
"height": "182",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/1335.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
{
"id": "1408",
"team_id": null,
"name": "",
"common_name": "Dahne, Thomas",
"position": "G",
"firstname": "Thomas",
"lastname": "Dahne",
"birthday": "04/01/94",
"birthcountry": null,
"birthplace": null,
"shirtnumber": "30",
"weight": "84",
"height": "193",
"img": "https://cdn.soccersapi.com/images/soccer/players/50/1408.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
...
Match TV Channels#back to top
The Match TV Channels Endpoint gives you a list of International TV Channels will cover the match
GETGet TV Channels By Match ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=match_tvs&id={MATCH_ID} |
| Example | https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_tvs&id=15006543 |
| Paginated | No, this endpoint is not paginated |
URI Parameters
| user | string | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | match_tvs |
| id | integer | MATCH_ID |
Response
| id | integer | The id of the TV Channel |
| name | string | The name of the TV Channel |
| country | object | id, name, cc (country_code) |
Response Example
{
"data": [
{
"id": "676",
"name": "Eurosport 2 Bulgaria",
"country": {
"id": "8",
"name": "Albania",
"cc": "al"
}
},
{
"id": "513",
"name": "beIN Sports HD 1",
"country": {
"id": "9",
"name": "Algeria",
"cc": "dz"
}
},
{
"id": "1381",
"name": "beIN Sports HD 11",
"country": {
"id": "9",
"name": "Algeria",
"cc": "dz"
}
},
{
"id": "55",
"name": "beIN SPORTS CONNECT",
"country": {
"id": "9",
"name": "Algeria",
"cc": "dz"
}
},
{
"id": "222",
"name": "ESPNPlay Caribbean",
"country": {
"id": null,
"name": "Anguilla",
"cc": null
}
},
{
"id": "224",
"name": "ESPN Caribbean",
"country": {
"id": null,
"name": "Anguilla",
"cc": null
}
},
{
"id": "225",
"name": "ESPNPlay Caribbean",
"country": {
"id": null,
"name": "Antigua and Barbuda",
"cc": null
}
},
{
"id": "227",
"name": "ESPN Caribbean",
"country": {
"id": null,
"name": "Antigua and Barbuda",
"cc": null
}
},
{
"id": "347",
"name": "ESPN2 Sur",
"country": {
"id": "12",
"name": "Argentina",
"cc": "ar"
}
},
{
"id": "62",
"name": "ESPN Play Sur",
"country": {
"id": "12",
"name": "Argentina",
"cc": "ar"
}
},
{
"id": "1548",
"name": "Setanta Sports 2",
"country": {
"id": "13",
"name": "Armenia",
"cc": "am"
}
},
{
"id": "231",
"name": "ESPNPlay Caribbean",
"country": {
"id": null,
"name": "Aruba",
"cc": null
}
},
{
"id": "230",
"name": "ESPN Caribbean",
"country": {
"id": null,
"name": "Aruba",
"cc": null
}
},
{
"id": "234",
"name": "Kayo Sports",
"country": {
"id": "14",
"name": "Australia",
"cc": "au"
}
},
{
"id": "232",
"name": "beIN Sports Connect",
"country": {
"id": "14",
"name": "Australia",
"cc": "au"
}
},
{
"id": "233",
"name": "beIN Sports 1",
"country": {
"id": "14",
"name": "Australia",
"cc": "au"
}
},
{
"id": "32",
"name": "Sky Sport Bundesliga 1",
"country": {
"id": "15",
"name": "Austria",
"cc": "at"
}
},
{
"id": "31",
"name": "Sky Go",
"country": {
"id": "15",
"name": "Austria",
"cc": "at"
}
},
{
"id": "813",
"name": "Sky Sport Bundesliga 2",
"country": {
"id": "15",
"name": "Austria",
"cc": "at"
}
},
{
"id": "1549",
"name": "Setanta Sports 2",
"country": {
"id": "17",
"name": "Azerbaijan",
"cc": "az"
}
},
{
"id": "237",
"name": "ESPN Caribbean",
"country": {
"id": null,
"name": "Bahamas",
"cc": null
}
},
{
"id": "1382",
"name": "beIN Sports HD 11",
"country": {
"id": "18",
"name": "Bahrain",
"cc": "bh"
}
},
{
"id": "514",
"name": "beIN Sports HD 1",
"country": {
"id": "18",
"name": "Bahrain",
"cc": "bh"
}
},
{
"id": "68",
"name": "beIN SPORTS CONNECT",
"country": {
"id": "18",
"name": "Bahrain",
"cc": "bh"
}
},
{
"id": "69",
"name": "Star Sports Select HD1",
"country": {
"id": "19",
"name": "Bangladesh",
"cc": "bd"
}
},
{
"id": "242",
"name": "ESPN Caribbean",
"country": {
"id": null,
"name": "Barbados",
"cc": null
}
},
{
"id": "240",
"name": "ESPNPlay Caribbean",
"country": {
"id": null,
"name": "Barbados",
"cc": null
}
},
{
"id": "1550",
"name": "Setanta Sports 2",
"country": {
"id": "20",
"name": "Belarus",
"cc": "by"
}
},
...
Coach by ID#back to top
The Coach by ID Endpoint give you information of a specific coach
GETGet coaches By ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/coaches/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id={COACH_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | COACH_ID |
Response
| id | integer | The id of the coach |
| team_id | integer | The id of the team |
| name | string | The name of the coach |
| common_name | string | The common name of the coach |
| firstname | string | The firstname of the coach |
| lastname | string | The lastname of the coach |
| birthday | string | The birthday of the coach |
| birthcountry | string | The birthcountry of the coach |
| birthplace | string | The birthplace of the coach |
| img | string | The img of the coach |
| country | object | id, name, cc |
Response Example
{
"data": {
"id": "1007",
"team_id": null,
"name": null,
"common_name": "Favre, Lucien",
"firstname": "Lucien",
"lastname": "Favre",
"birthday": "02/11/57",
"birthcountry": null,
"birthplace": null,
"img": "https://cdn.soccersapi.com/images/soccer/coaches/50/1007.png",
"country": {
"id": "114",
"name": "Switzerland",
"cc": "ch"
}
},
...
Venue by ID#back to top
The Venue by ID Endpoint give you information of a specific venue
GETGet Venue By ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/venues/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id={VENUE_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | VENUE_ID |
Response
| id | integer | The id of the venue |
| name | string | The name of the venue |
| capacity | string | The capacity of the venue |
| city | string | The city of the venue |
| address | string | The address of the venue |
| img | string | The img of the venue |
Response Example
{
"data": {
"id": "1216",
"name": "Signal Iduna Park",
"capacity": "81365",
"city": "Dortmund",
"address": "",
"img": "https://cdn.soccersapi.com/images/soccer/venues/1216.jpg",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
...
Referee by ID#back to top
The Referee by ID Endpoint give you information of a specific Referee
GETGet Referee By ID
API ReferenceDescription
| Headers | application/json |
| Endpoint | https://api.soccersapi.com/v2.2/referees/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=info&id={REFEREE_ID} |
| Example | 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 | YOUR_USER |
| token | string | YOUR_TOKEN |
| t | string | info |
| id | integer | REFEREE_ID |
Response
| id | integer | The id of the referee |
| name | string | The name of the referee |
| common_name | string | Common name of the referee |
| firstname | string | Firstname of the referee |
| lastname | string | Lastname of the referee |
Response Example
{
"data": {
"id": "372",
"name": "",
"common_name": "Aytekin, Deniz",
"firstname": "Deniz",
"lastname": "Aytekin",
"birthdate": "21/07/78",
"img": "https://cdn.soccersapi.com/images/soccer/referees/50/372.png",
"country": {
"id": "4",
"name": "Germany",
"cc": "de"
}
},
...