(https://soccersapi.com/)

Documentation

Soccer API (https://soccersapi.com/)

Coverage(https://soccersapi.com/page/coverage)

Plans Pricing(https://soccersapi.com/page/pricing)

Demos(https://demo.soccersapi.com/endpoints)

Contact Us(https://soccersapi.com/page/contact-info)

(https://soccersapi.com/search/) (https://soccersapi.com/login/)

SoccersAPI / Documentation Version 2.2Soccer's API

Prologue

Introduction

Authentication

Getting Started

Statuses and Explanation

Endpoints

All Countries

Country by ID

All Leagues

League by ID

League Stats

League Stats by Season

Standings

Seasons

Stages

Rounds

Topscorers We are online, chat with us!

Team Info

Team Squad

Team Stats

Team Transfers

API : Soccers' APIAPI Version : v 2.2API Contents : Football

SoccersAPI is a RESTful service for soccer data sport. It is a PAID service with low price (started with $50 per month). Notethat in order to access Soccer's API you must purchase related packages. Please contact us if you have any problem.

Introduction

To authorize, use this code: Make sure replace YOUR-TOKEN with your real token. curl "api_endpoint_here?user=YOUR-USER&token=YOUR-TOKEN" You will get a token from our support or Orders page. You should pass it as token= in GETquery.

Authentication #back to top

Status Description

1 The event is inplay.

11 The event is in half-time.

12 The event is in extra time.

13 The event is in penalties because extra time didn't determinate a winner.

14 Event is in break waiting for extra time or penalties.

15 Awarding of a victory to a contestant because there are no other contestants.

Check the following table to know what status number means.

Statuses and Explanation #back to top

# Introduction # Get a List of countries # Get Country Info by ID

Status Description2 Event will be updated later.

3 Event has ended after 90 minutes.

31 Event has ended after penalty shootout.

32 The event has finished after extra time.

4 The event has finished after extra time.

5 The event has been postponed.

6 The event has abandoned and will continue at a later time or day.

7 The event has been interrupted. Can be due to bad weather for example.

8 The event has been suspended.

9 Winner is beeing decided externally.

10 The event is delayed.

Countries #back to top

The Countries endpoint gives you Country data like its Name, Flag, IsoCode, Continent and other related Country data.The Countries endpoint also gives the chance to order Leagues under the same Country. On the off chance that forinstance, you need to demonstrate the Leagues per Country on your site/application, this may be a valuable endpoint foryou by use the Leagues Endpoint.

Introduction

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/countries/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=list

(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=2wsdasd$asdZ&t=list

(https://api.soccersapi.com/v2.2/countries/?user=user1&token=2wsdasd$asdZ&t=list)

Paginated Yes, 50 countries per page

Name Type Value

GETGet All

Countries

Demo (https://demo.soccersapi.com/endpoints/list-countries/)

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/list-countries)

URI Parameters

Name Type ValueName Type Valueuser string YOUR_USER

token string YOUR_TOKEN

t string list

page integer PAGE_NUMBER

Name Type Description

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 Attributes

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/country-info)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/countries/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=info&id=COUNTRY_ID (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=2wsdasd$asdZ&t=info&id=20

(https://api.soccersapi.com/v2.2/countries/?user=user1&token=2wsdasd$asdZ&t=info&id=20)

Paginated No, this endpoint is not paginated

Name Type Value

user string YOUR_USER

token string YOUR_TOKEN

t string info

id integer COUNTRY_ID

GET Get Country By Id

URI Parameters

Response Attributes

Name Type Description

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

# Introduction # Get All Leagues # Get Leagues by ID

Leagues #back to top

The Leagues endpoint would return a response with all Leagues available in your plan you are subscribed. The Leaguesendpoint give you League data for example ID, Name, Country, Coverage etc. The Leagues endpoint also is used incombination with the Season or Seasons Endpoints. The Seasons Endpoint show information about all seasons availablefor the specific Leagues.

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/leagues/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=list

(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=2wsdasd$asdZ&t=list

(https://api.soccersapi.com/v2.2/leagues/?user=user1&token=2wsdasd$asdZ&t=list)

Paginated Yes, 100 leagues per page

Name Type Value

user string YOUR_USER

# Introduction

GETGet All

Leagues

Demo (https://demo.soccersapi.com/endpoints/list-leagues/)

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/list-leagues)

URI Parameters

Name Type Valuetoken string YOUR_TOKEN

t string list

page integer PAGE_NUMBER

Name Type Description

id integer The id of the league

name string The name of the league

is_cup string Boolean if that league is cup

id_country integer Ccountry id

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/league-info)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/leagues/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=info&id=

LEAGUE_ID (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=2wsdasd$asdZ&t=info&id=240

(https://api.soccersapi.com/v2.2/leagues/?user=user1&token=2wsdasd$asdZ&t=info&id=240)

Paginated No, this endpoint is not paginated

Name Type Value

user string YOUR_USER

token string YOUR_TOKEN

t string info

id integer LEAGUE_ID

Name Type Description

id integer The id of the league

name string The name of the league

is_cup string Boolean if that league is cup

Response Attributes

GET Get League by ID

URI Parameters

Response Attributes

Name Type Descriptionid_current_season string Current Season

id_current_stage string Current Stage

id_current_round string Current Round

country object Shows id,name,cc of that country

seasons object Shows id,name,is_current for each season available

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/league-stats)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/stats/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=league&id=

LEAGUE_ID (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=2wsdasd$asdZ&t=league&id=240

(https://api.soccersapi.com/v2.2/stats/?user=user1&token=2wsdasd$asdZ&t=league&id=240)

Paginated No, this endpoint is not paginated

Name Type Value

user string YOUR_USER

token string YOUR_TOKEN

t string league

id integer LEAGUE_ID

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/league-stats-by-season)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/stats/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=season&id=

SEASON_ID (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=2wsdasd$asdZ&t=season&id=15378

(https://api.soccersapi.com/v2.2/stats/?user=user1&token=2wsdasd$asdZ&t=season&id=15378)

GET Get League Stats

URI Parameters

GETGet League Stats by

Season ID

Option DescriptionPaginated No, this endpoint is not paginated

Name Type Value

user string YOUR_USER

token string YOUR_TOKEN

t string season

id integer SEASON_ID

URI Parameters

# Introduction # Get Standings By League ID and Season ID

Standings #back to top

The Standings Endpoint show the rank of the teams of each League in which they are participating. The response of theStandings Endpoint can be returned in two formats, depending on the type of the League. For regular "normal" Leaguesthe response format is different compared to the "knockout" Cups. If you have "normal" Leagues and "knockout" Cups inyour Plan, make sure to verify the response in the correct way.

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/standings)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/leagues/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=standings&id_league=LEAGUE_ID&id_season=SEASON_ID

(https://api.soccersapi.com/v2.2/leagues/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=standings&id_league=LEAGUE_ID&id_season=SEASON_ID)

Example https://api.soccersapi.com/v2.2/leagues/?

user=user1&token=2wsdasd$asdZ&t=standings&id_league=874&id_season=12498

(https://api.soccersapi.com/v2.2/leagues/?

user=user1&token=2wsdasd$asdZ&t=standings&id_league=874&id_season=12498)

Paginated No, this endpoint is not paginated

Name Type Value

# Introduction

# Get Standings By League ID and

Season ID

URI Parameters

Name Type Valueuser string YOUR_USER

token string YOUR_TOKEN

t string standings

id_season integer SEASON_ID

id_league integer LEAGUE_ID

Name Type Description

name string The name of the season

league_id integer The id of the league

season_id integer The id of the season

stage_id integer The id of the stage

stage_name string The name of the stage

round_id integer The id of the current round

standings object Shows all standings postion, team_id, team_name, group_id, group_name, overall, home,away, total, result, recent_form

Response Attributes

# Introduction # Get Seasons by ID

Seasons #back to top

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/seasons)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/seasons/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=info&id=

SEASON_ID (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=2wsdasd$asdZ&t=info&id=12254

(https://api.soccersapi.com/v2.2/seasons/?user=user1&token=2wsdasd$asdZ&t=info&id=12254)

Paginated No, this endpoint is not paginated

# Introduction

GET Get Seasons By ID

URI Parameters

Name Type Value

user string YOUR_USER

token string YOUR_TOKEN

t string info

id integer SEASON_ID

Name Type Description

id integer The id of the season

name string The name of the season

league_id integer The id of the league associated

is_current boolean 1 if is the current one

stages object id,name of all stages associated to that season

Response Attributes

# Introduction # Get Stages by ID

Stages #back to top

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/stages)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/stages/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=info&id=

STAGE_ID (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=2wsdasd$asdZ&t=info&id=2317509

(https://api.soccersapi.com/v2.2/stages/?user=user1&token=2wsdasd$asdZ&t=info&id=2317509)

Paginated No, this endpoint is not paginated

Name Type Description

id integer The id of the stage

# Introduction

GET Get Stages By ID

Name Type Descriptionname string The name of the stage

league_id integer The id of the league associated

season_id integer The id of the season associated

is_current boolean 1 if is the current one

rounds object id,name,id_current of all rounds associated to that stage (if have)

# Introduction # Get Rounds by ID

Rounds #back to top

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/rounds)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/rounds/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=info&id=

STAGE_ID (https://api.soccersapi.com/v2.2/rounds/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=info&id=STAGE_ID)

Example https://api.soccersapi.com/v2.2/rounds/?user=user1&token=2wsdasd$asdZ&t=info&id=2317509

(https://api.soccersapi.com/v2.2/rounds/?user=user1&token=2wsdasd$asdZ&t=info&id=2317509)

Paginated No, this endpoint is not paginated

Name Type Description

id integer The id of the player

name integer The name of the round

start date The date of round start

end date The round of the round end

league_id integer The id of the league

season_id integer The if of the season

stage_id integer The id of stage

is_current boolean 1 if is the current one

# Introduction

GET Get Rounds By ID

# Introduction # Get Topscorers by Season ID

Topscorers #back to top

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/topscorers)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/topscorers/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=info&season_id=SEASON_ID (https://api.soccersapi.com/v2.2/topscorers/?user=

YOUR_USER_NAME&token=YOUR_TOKEN&t=info&id=SEASON_ID)

Example https://api.soccersapi.com/v2.2/topscorers/?

user=user1&token=2wsdasd$asdZ&t=info&season_id=12024

(https://api.soccersapi.com/v2.2/topscorers/?

user=user1&token=2wsdasd$asdZ&t=info&season_id=12024)

Paginated No, this endpoint is not paginated

Name Type Description

position integer The position of the player

season_id integer The id of the season

player_id integer The id of the player

team_id string The id of the team

stage_id string The id of the stage

gaols integer Number of goals

penalty_goals integer Number of penalty goals

type string Type of rank

# Introduction

GET Get Topscorers By Season ID

# Introduction # Get Info by Team ID # Get Squad By Team Id # Get Stats By Team Id # Get Sidelined By Team Id# Get Transfers By Team Id

Teams #back to top

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/team-info)

# Introduction

GET Get Team Info By Id

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/teams/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=info&id=

TEAM_ID (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=2wsdasd$asdZ&t=info&id=52

(https://api.soccersapi.com/v2.2/teams/?user=user1&token=2wsdasd$asdZ&t=info&id=52)

Paginated No, this endpoint is not paginated

Name Type Description

id integer The id of the team

name string The name of the stage

img string URL of team shield

founded integer Year of team foundation

twitter string Team's official twitter

current_season_id integer The id of current season playing

coach_id integer The id of current coach

venue_id integer The id of team's venue

country object id,name of country

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/team-squad)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/teams/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=squad&id=

TEAM_ID (https://api.soccersapi.com/v2.2/teams/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=squad&id=TEAM_ID)

Example https://api.soccersapi.com/v2.2/teams/?user=user1&token=2wsdasd$asdZ&t=squad&id=52

(https://api.soccersapi.com/v2.2/teams/?user=user1&token=2wsdasd$asdZ&t=squad&id=52)

Paginated No, this endpoint is not paginated

Name Type Description

GET Get Squad By Team Id

Name Type Descriptionplayer_id integer The id of the player

number integer Player number

captain boolean 1 if is captain of the team

position_id integer -----

injured boolean true if have any current injury

minutes_played integer Number of minutes played

appearences integer Number of appearences

lineups integer -----

substitute_in integer substitute in

substitute_out integer substitute out

substitutes_on_bench integer substitutes on bench

goals integer Number of goals

assists integer Number of assists

saves integer Number of saves

inside_box_saves integer Number of saves inside box

dispossesed integer Number of dispossesed

interceptions integer Number of interceptions

yellowcards integer Number of yellow cards

yellowred integer Number of yellow-red cards

redcards integer Number of red cards

tackles integer Number of tackles

hit_post integer Number of hit to post

fouls object committed,drawn,crosses(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

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/team-stats)

Option Description

GETGet Stats By Team ID and

Season ID

Option DescriptionHeaders 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 (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=2wsdasd$asdZ&t=team&id=52&season_id=16074

(https://api.soccersapi.com/v2.2/stats/?

user=user1&token=2wsdasd$asdZ&t=team&id=52&season_id=16074)

Paginated No, this endpoint is not paginated

Name Type Description

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_agains object total,home,away

clean_sheet integer number of clean sheet

failed_to_score object total,home,away

scoring_minutes object divided by time and percetatge

avg_goals_per_game_scored object total,home,away

avg_goals_per_game_conceded object total,home,away

avg_first_goal_scored object total,home,away

avg_first_goal_conceded object total,home,away

attacks integer number of attacks in this season

dangerous_attacks integer number of dangerous attacks in this season

avg_ball_possession_percentage float average of possession

fouls integer number of fouls

avg_fouls_per_game float average of fouls per game

offsides integer number of offsides

redcards integer number of redcards

yellowcards integer number of yellowcards

shots_blocked integer number of shots blocked

shots_off_target integer number of shots off target

avg_shots_off_target_per_game flot average of shots off target per game

Name Type Descriptionshots_on_target integer number of shots on target

avg_shots_on_target_per_game float average shots on target per game

btts float average

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/team-stats)

Option Description

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 (https://api.soccersapi.com/v2.2/teams/?user=

YOUR_USER_NAME&token=YOUR_TOKEN&t=transfers&id=TEAM_ID&season_id=SEASON_ID)

Example https://api.soccersapi.com/v2.2/teams/?

user=user1&token=2wsdasd$asdZ&t=transfers&id=52&season_id=16074

(https://api.soccersapi.com/v2.2/teams/?

user=user1&token=2wsdasd$asdZ&t=transfers&id=52&season_id=16074)

Paginated No, this endpoint is not paginated

Name Type Description

player_id integer The id of the player

from_team_id integer The id of the procedence team

to_team_id integer The id of the destination team

transfer string Type of transfer (sold,bought,free,..)

type string Transfer direction (IN, OUT)

date date The date of the transfer

amount string Amount of the transfer

GET Get Transfers By Team Id

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/team-stats)

Option Description

Headers application/json

GET Get Sidelined By Team Id

Option DescriptionEndpoint https://api.soccersapi.com/v2.2/teams/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=sidelined&id=

TEAM_ID (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=2wsdasd$asdZ&t=sidelined&id=52

(https://api.soccersapi.com/v2.2/teams/?user=user1&token=2wsdasd$asdZ&t=sidelined&id=52)

Paginated No, this endpoint is not paginated

Name Type Description

player_id integer The id of the player

team_id integer The id of the team

description string description of injury

start_date date The date start of sidelined

end_date date The date of end of sidelinedr

# Introduction # Get players by ID

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/player-info)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/players/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=info&id=

PLAYER_ID (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=2wsdasd$asdZ&t=info&id=671

(https://api.soccersapi.com/v2.2/players/?user=user1&token=2wsdasd$asdZ&t=info&id=671)

Paginated No, this endpoint is not paginated

Name Type Description

id integer The id of the player

name string The name of the player

common_name string Common name of the player

Players #back to top

# Introduction

GET Get players By ID

Name Type Descriptionfirstname string Firstname

lastname string Lastname

birthday date Birthday (dd/mm/yyyy)

birthcountry string Birthcountry

birthplace string Place of birth

w string Weight

h string Height

img string URL of player image

country object id,name,cc of country

# Introduction # Get coaches by ID

Coaches #back to top

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/coach-info)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/coaches/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=info&id=

COACH_ID (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=2wsdasd$asdZ&t=info&id=806

(https://api.soccersapi.com/v2.2/coaches/?user=user1&token=2wsdasd$asdZ&t=info&id=806)

Paginated No, this endpoint is not paginated

Name Type Description

id integer The id of the coach

name string The name of the coach

common_name string Common name of the coach

firstname string Firstname of the coach

lastname string Lastname of the coach

img string URL of the image of the coach

# Introduction

GET Get coaches By ID

Name Type Descriptioncountry object id,name,cc

# Introduction # Get Venues by ID

Venues #back to top

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/venue-info)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/venues/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=info&id=

VENUE_ID (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=2wsdasd$asdZ&t=info&id=99

(https://api.soccersapi.com/v2.2/venues/?user=user1&token=2wsdasd$asdZ&t=info&id=99)

Paginated No, this endpoint is not paginated

Name Type Description

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 URL of the image of the venue

# Introduction

GET Get Venues By ID

# Introduction # Get Fixtures by Date # Get Fixtures Playing (Livescores) # Get Fixtures Ended# Get Fixtures By Stage ID # Get Fixtures By Round ID # Get Match by ID # Get Statistics By Match ID# Get Commentary By Match ID # Get Events By Match ID # Get Trends By Match ID # Get Lineups By Match ID# Get Sidelined By Match ID # Get Bench By Match ID

Fixtures #back to top

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=schedule&d=

DATE yyyy-mm-dd (https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=schedule&d=DATE)

Example https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=schedule&d=2018-04-20

(https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=schedule&d=2018-04-20)

Paginated Yes, 100 leagues per page

Name Type Description

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),away(id,name)

league object id,name,country_id,country_name,country_flag

scores object home_score,away_score,ht_score,ft_score,et_score

stadium_id integer Id of stadium

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)

# Introduction

GETGet Fixtures

By date

Demo (https://demo.soccersapi.com/endpoints/fixtures/)

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixtures-by-date)

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixtures-live)

Option Description

GET Get Fixtures Live

Name Type Description

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)

Option DescriptionHeaders application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=live

(https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=live)

Example https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=live

(https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=live)

Paginated No, this endpoint is not paginated

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixtures-ended)

Name Type Description

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=ended&d=

DATE (https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=ended&d=DATE)

Example https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=ended&d=2018-05-04

(https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=ended&d=2018-05-04)

Paginated No, this endpoint is not paginated

GET Get Fixtures Ended

Name Type Descriptionid 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)

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixtures-by-stage)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=stage&id=

STAGE_ID (https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=stage&id=STAGE_ID)

Example https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=stage&id=53294

(https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=stage&id=53294)

Paginated No, this endpoint is not paginated

GET Get Fixtures By Stage ID

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixtures-by-round)

Option Description

Headers application/json

GET Get Fixtures By Round ID

Option DescriptionEndpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=round&id=

STAGE_ID (https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=round&id=ROUND_ID)

Example https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=round&id=53294

(https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=round&id=53294)

Paginated No, this endpoint is not paginated

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixture-by-id)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=event&id=

ID (https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=event&id=ID)

Example https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=event&id=10353539

(https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=event&id=10353539)

Paginated No, this endpoint is not paginated

Name Type Description

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)

GET Get Match By ID

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixture-stats)

Name Type Description

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

saves integer Number of saves

substitutions integer Number of substitutions

goal_kick integer Number of kicks to goal

free_kick integer Number of free kicks

throw_in integer Number of throw in

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/stats/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=match&id=

FIXTURE_ID (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=2wsdasd$asdZ&t=match&id=4227583

(https://api.soccersapi.com/v2.2/stats/?user=user1&token=2wsdasd$asdZ&t=match&id=4227583)

Paginated No, this endpoint is not paginated

GET Get Statistics By Fixture ID

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixture-commentary)

Option Description

GETGet Commentary By

Fixture ID

Name Type Description

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

Option DescriptionHeaders application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=match_comments&id=FIXTURES_ID (https://api.soccersapi.com/v2.2/fixtures/?user=

YOUR_USER_NAME&token=YOUR_TOKEN&t=match_comments&id=FIXTURES_ID)

Example https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_comments&id=4227583

(https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_comments&id=4227583)

Extra Add (&order=desc) for have new lines first

Paginated No, this endpoint is not paginated

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixture-events)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=match_events&id=FIXTURES_ID (https://api.soccersapi.com/v2.2/fixtures/?user=

YOUR_USER_NAME&token=YOUR_TOKEN&t=match_events&id=FIXTURES_ID)

Example https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=match_events&id=4227583

(https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_events&id=4227583)

Paginated No, this endpoint is not paginated

Name Type Description

team_id integer Id of the team

GET Get Events By Fixture ID

Name Type Descriptionplayer_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

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixture-trends)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=match_trends&id=FIXTURES_ID (https://api.soccersapi.com/v2.2/fixtures/?user=

YOUR_USER_NAME&token=YOUR_TOKEN&t=match_trends&id=FIXTURES_ID)

Example https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=match_trends&id=4227583

(https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_trends&id=4227583)

Paginated No, this endpoint is not paginated

GET Get Trends By Fixture ID

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixture-lineups)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=match_lineups&id=FIXTURES_ID (https://api.soccersapi.com/v2.2/fixtures/?user=

YOUR_USER_NAME&token=YOUR_TOKEN&t=match_lineups&id=FIXTURES_ID)

GET Get Lineups By Fixture ID

Option DescriptionExample https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_lineups&id=4227583

(https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_lineups&id=4227583)

Paginated No, this endpoint is not paginated

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixture-bench)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=match_bench&id=FIXTURES_ID (https://api.soccersapi.com/v2.2/fixtures/?user=

YOUR_USER_NAME&token=YOUR_TOKEN&t=match_bench&id=FIXTURES_ID)

Example https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=2wsdasd$asdZ&t=match_bench&id=4227583

(https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_bench&id=4227583)

Paginated No, this endpoint is not paginated

GET Get Bench By Fixture ID

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixture-sidelined)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=match_sidelined&id=FIXTURES_ID (https://api.soccersapi.com/v2.2/fixtures/?user=

YOUR_USER_NAME&token=YOUR_TOKEN&t=match_sidelined&id=FIXTURES_ID)

Example https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_sidelined&id=4227583

(https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_sidelined&id=4227583)

Paginated No, this endpoint is not paginated

GET Get Sidelined By Fixture ID

# Introduction # Get Odds by Match ID

Match Odds #back to top

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixture-odds)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=match_odds&id=FIXTURES_ID (https://api.soccersapi.com/v2.2/fixtures/?user=

YOUR_USER_NAME&token=YOUR_TOKEN&t=match_odds&id=FIXTURES_ID)

Example https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_odds&id=4227583

(https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_odds&id=4227583)

Paginated No, this endpoint is not paginated

Name Type Description

id integer The id of the odd type

name string The name of odd type

bookmakers object id,name,odds of every bookmaker

# Introduction

GET Get Odds By Fixture ID

# Introduction # Get Inplay Odds by Match ID

Match Inplay Odds #back to top

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixture-inplay-odds)

Option Description

Headers application/json

GETGet Inplay Odds By

Fixture ID

Option DescriptionEndpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=match_oddsinplay&id=FIXTURES_ID (https://api.soccersapi.com/v2.2/fixtures/?

user=YOUR_USER_NAME&token=YOUR_TOKEN&t=match_oddsinplay&id=FIXTURES_ID)

Example https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_oddsinplay&id=4227583

(https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_oddsinplay&id=4227583)

Paginated No, this endpoint is not paginated

Name Type Description

id integer The id of the odd type

name string The name of odd type

bookmakers object id,name,odds of every bookmaker

# Introduction# Get Tv channels by Match IDMatch TV Channels #back to top

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/fixture-tv)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/fixtures/?user=YOUR_USER_NAME&token=

YOUR_TOKEN&t=match_tvs&id=FIXTURES_ID (https://api.soccersapi.com/v2.2/fixtures/?user=

YOUR_USER_NAME&token=YOUR_TOKEN&t=match_tvs&id=FIXTURES_ID)

Example https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_tvs&id=11478332

(https://api.soccersapi.com/v2.2/fixtures/?

user=user1&token=2wsdasd$asdZ&t=match_tvs&id=11478332)

Paginated No, this endpoint is not paginated

Name Type Description

id integer The id of the tv

name string The name of tv

# Introduction

GETGet TV Coverage By Fixture

ID

<

Name Type Descriptioncountry object id,name,cc of tv country

# Introduction # Get referees by ID

Referees #back to top

API Reference (https://soccersapi.docs.apiary.io/#/reference/0/referee-info)

Option Description

Headers application/json

Endpoint https://api.soccersapi.com/v2.2/referees/?user=YOUR_USER_NAME&token=YOUR_TOKEN&t=info&id=

REFEREE_ID (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=2wsdasd$asdZ&t=info&id=33775

(https://api.soccersapi.com/v2.2/referees/?user=user1&token=2wsdasd$asdZ&t=info&id=33775)

Paginated No, this endpoint is not paginated

Name Type Description

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

# Introduction

GET Get referees By ID

Soccersapi.com has a reliable aroundthe clock customer support that will helpcustomers stay in touch andtroubleshoot any issues that may cropup. Get in touch by live chat or e-mail.

API

Coverage (/page/coverage)Documentation (/page/documentation)Plans Pricing (/page/pricing)Support (/page/contact-info)

About

About us (/page/about)

Privacy Policy (/privacy-policy)

Terms & Conditions (/page/terms)

Contact us (/page/contact-info)

Support 24/7

Email: support@soccersapi.com(mailto:support@soccersapi.com?subject=Customer Support)

Follow us:

(https://soccersapi.com)

Copyright ©2019 SoccersAPI

(https://soccersapi.com/sitemap/)

(https://soccersapi.com/rss.php)

(//https://www.facebook.com/Soccersapicom-

(//twitter.com/soccersapi)

(//instagram.com/soccersapi)