The Match resources let you access data about high-level match information, environmental conditions, and lineups.
Returns high-level data related to a football match. If matchID is passed, return data for the match the ID corresponds to.
If query parameters are passed, it returns the matches that match the specified filters.
Query and Response Parameters:
| Field | Type | Description |
|---|---|---|
| competition | integer | The unique ID of competition to which the league match corresponds. |
| competition_name | string | Name of competition. |
| season | integer | The unique ID of season to which the league match corresponds. |
| season_name | string | Season year(s). |
| matchday | integer | Matchday to which the league match corresponds. |
| home_team | integer | The unique ID of the home team. |
| home_team_name | string | The name of the home team. |
| away_team | integer | The unique ID of the away team. |
| away_team_name | string | The name of the away team. |
| home_manager | integer | The unique ID of the manager of the home team. |
| home_manager_name | string | The name of the manager of the home team. |
| away_manager | integer | The unique ID of the manager of the away team. |
| away_manager_name | string | The name of the manager of the away team. |
| referee | integer | The unique ID of the referee who began officiating the match. |
| referee_name | string | Full name of the referee. |
| venue | integer | The unique ID of the venue where the match was played. |
| venue_name | string | The name of the match venue. |
| match_date | date | The date of the match, in ISO format (YYYY-MM-DD). |
| kickoff_time | time | The time of the match kick-off, in 24-hr format (HH:MM). |
| firsthalf_length | integer | Length of the first half in minutes. |
| secondhalf_length | integer | Length of the second half in minutes. |
| attendance | integer | The estimated attendance at the match. |
Link Parameters:
| Field | URL Description |
|---|---|
| venue | Match Venues resource representation. |
| conditions | Match Conditions resource representation. |
| home_team | Home Teams resource representation. |
| away_team | Away Teams resource representation. |
| home_manager | Home Managers resource representation. |
| away_manager | Away Managers resource representation. |
| referee | Match Referees resource representation. |
| events | Match Events resource representations. |
| stats | Match Statistics resource representations. |
| analytics | Match Analytics resource representations. |
Example:
Retrieve high-level information on a specific match.
GET /v0/matches/1000003/info HTTP/1.1
Host: api-summary.soccermetrics.net
Accept: application/json
HTTP/1.1 200 OK
Server: gunicorn/0.15.0
Date: Mon, 02 Sep 2013 06:21:28 GMT
Connection: close
Content-Type: application/json
Content-Length: 4324
Access-Control-Allow-Origin: *
{
"meta": {
"totalPages": 1,
"records": 10,
"totalRecords": 1,
"page": 1,
"next": null,
"first": "/v0/matches/1000003/info?records=10&page=1",
"last": "/v0/matches/1000003/info?records=10&page=1",
"prev": null
},
"attribution": {
"html": "<a href=\"http://www.soccermetrics.net\"><img src=\"http://soccermetrics-mcfc.s3.amazonaws.com/logo/soccermetrics_logo.png\"/></a>",
"source": {
"html": "<a href=\"http://www.optasports.com\"><img src=\"http://soccermetrics-mcfc.s3.amazonaws.com/logo/opta_logo.png\"/></a>"
"logo": "http://soccermetrics-mcfc.s3.amazonaws.com/logo/opta_logo.png",
"url": "http://www.optasports.com",
"name": "Opta Sports"
},
"text": "Powered by Soccermetrics Research",
"url": "http://www.soccermetrics.net",
"logo": "http://soccermetrics-mcfc.s3.amazonaws.com/logo/soccermetrics_logo.png"
},
"result": [
{
"firsthalfLength": 46,
"awayManagerName": "Steve Bruce",
"seasonName": "2011-2012",
"competition": 100,
"awayTeamName": "Sunderland",
"id": 1000003,
"homeManager": 10003,
"awayTeam": 10014,
"homeTeamName": "Liverpool",
"venueName": "Anfield",
"matchday": 1,
"awayManager": 10000,
"matchDate": "2011-08-13",
"referee": 10004,
"homeManagerName": "Kenny Dalglish",
"season": 100,
"attendance": 45018,
"link": {
"homeManager": "/v0/personnel/managers/10003",
"homeTeam": "/v0/teams/10007",
"awayTeam": "/v0/teams/10014",
"stats": {
"setpieces": {
"corners": "/v0/stats/setpieces/corners?match=1000003",
"freekicks": "/v0/stats/setpieces/freekicks?match=1000003",
"throwins": "/v0/stats/setpieces/throwins?match=1000003",
"keyplays": "/v0/stats/setpieces/keyplays?match=1000003"
},
"passes": {
"directions": "/v0/stats/passes/directions?match=1000003",
"lengths": "/v0/stats/passes/lengths?match=1000003",
"locations": "/v0/stats/passes/locations?match=1000003",
"totals": "/v0/stats/passes/totals?match=1000003"
},
"touches": {
"duels": "/v0/stats/touches/duels?match=1000003",
"locations": "/v0/stats/touches/locations?match=1000003",
"totals": "/v0/stats/touches/totals?match=1000003"
},
"crosses": {
"corners": "/v0/stats/crosses/corners?match=1000003",
"totals": "/v0/stats/crosses/totals?match=1000003"
},
"fouls": {
"cards": "/v0/stats/fouls/cards?match=1000003",
"wins": "/v0/stats/fouls/wins?match=1000003"
},
"defense": {
"goalline": "/v0/stats/defense/goalline?match=1000003",
"blocks": "/v0/stats/defense/blocks?match=1000003",
"tackles": "/v0/stats/defense/tackles?match=1000003",
"actions": "/v0/stats/defense/actions?match=1000003",
"clearances": "/v0/stats/defense/clearances?match=1000003"
},
"goals": {
"penalties": "/v0/stats/goals/penalties?match=1000003",
"bodyparts": "/v0/stats/goals/bodyparts?match=1000003",
"locations": "/v0/stats/goals/locations?match=1000003",
"assists": "/v0/stats/goals/assists?match=1000003",
"totals": "/v0/stats/goals/totals?match=1000003"
},
"shots": {
"bodyparts": "/v0/stats/shots/bodyparts?match=1000003",
"plays": "/v0/stats/shots/plays?match=1000003",
"locations": "/v0/stats/shots/locations?match=1000003",
"totals": "/v0/stats/shots/totals?match=1000003"
},
"goalkeeper": {
"actions": "/v0/stats/goalkeeper/actions?match=1000003",
"saves": "/v0/stats/goalkeeper/saves?match=1000003",
"goals": "/v0/stats/goalkeeper/goals?match=1000003",
"shots": "/v0/stats/goalkeeper/shots?match=1000003"
}
},
"analytics": {
"segments": "/v0/analytics/match/1000003/segment",
"state": "/v0/analytics/match/1000003/state",
"tsr": "/v0/analytics/match/1000003/tsr"
},
"referee": "/v0/personnel/referees/10004",
"venue": "/v0/venues/1007",
"awayManager": "/v0/personnel/managers/10000",
"lineups": "/v0/matches/1000003/lineups",
"conditions": "/v0/matches/1000003/conditions",
"events": {
"offenses": "/v0/events/offenses?match=1000003",
"penalties": "/v0/events/penalties?match=1000003",
"goals": "/v0/events/goals?match=1000003",
"substitutions": "/v0/events/substitutions?match=1000003"
}
},
"competitionName": "English Barclays Premier League",
"homeTeam": 10007,
"kickoffTime": "16:00:00",
"refereeName": "Phil Dowd",
"venue": 1007,
"uri": "/v0/matches/1000003/info",
"secondhalfLength": 45
}
]
}
Returns data on climatic conditions present during a football match. If matchID is passed, return data for the match the ID corresponds to.
If query parameters are passed, it returns the matches that match the specified filters.
Query and Response Parameters:
| Field | Type | Description |
|---|---|---|
| match | integer | The unique ID of the football match. |
| kickoff_temp | string | The temperature at kickoff in degrees Celsius. |
| kickoff_weather | integer | The unique ID of the predominate weather condition at kickoff. |
| kickoff_weather_conditions | string | US NOAA/NWS description of predominate weather condition at kickoff. |
| halftime_weather | integer | The unique ID of the predominate weather condition at halftime. |
| halftime_weather_conditions | string | US NOAA/NWS description of predominate weather condition at halftime. |
| fulltime_weather | integer | The unique ID of the predominate weather condition at fulltime. |
| fulltime_weather_conditions | string | US NOAA/NWS description of predominate weather condition at fulltime. |
Link Parameters:
| Field | URL Description |
|---|---|
| match | Match Information resource representation. |
Example:
Retrieve the weather conditions that a match was played in.
GET /v0/match/1000003/conditions HTTP/1.1
Host: api-summary.soccermetrics.net
Accept: application/json
HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Content-Type: application/json
Date: Thu, 22 Aug 2013 06:50:01 GMT
Server: gunicorn/0.15.0
Content-Length: 463
Connection: keep-alive
{
"meta": {
"totalPages": 1,
"records": 10,
"totalRecords": 1,
"page": 1,
"next": null,
"first": "/v0/matches/1000003/conditions?records=10&page=1",
"last": "/v0/matches/1000003/conditions?records=10&page=1",
"prev": null
},
"attribution": {
"html": "<a href=\"http://www.soccermetrics.net\"><img src=\"http://soccermetrics-mcfc.s3.amazonaws.com/logo/soccermetrics_logo.png\"/></a>",
"source": {
"html": "<a href=\"http://www.optasports.com\"><img src=\"http://soccermetrics-mcfc.s3.amazonaws.com/logo/opta_logo.png\"/></a>"
"logo": "http://soccermetrics-mcfc.s3.amazonaws.com/logo/opta_logo.png",
"url": "http://www.optasports.com",
"name": "Opta Sports"
},
"text": "Powered by Soccermetrics Research",
"url": "http://www.soccermetrics.net",
"logo": "http://soccermetrics-mcfc.s3.amazonaws.com/logo/soccermetrics_logo.png"
},
"result": [
{
"halftimeWeatherCondition": "Few Clouds",
"kickoffTemp": 18.0,
"fulltimeWeather": 15,
"id": 1000003,
"uri": "/v0/matches/1000003/conditions",
"fulltimeWeatherCondition": "Few Clouds",
"link": {
"match": "/v0/matches/1000003/info"
},
"kickoffWeather": 12,
"kickoffWeatherCondition": "Few Clouds",
"halftimeWeather": 15,
"match": 1000003
}
]
}
Returns data on players in the lineup of a football match. They are designated as either starting or substitute, with a further designation for team captain.
If matchID is passed, return lineup data for the match the ID corresponds to.
If query parameters are passed, it returns the matches that match the specified filters.
Note
In general, unused substitutes are not included in the match lineup.
Query and Response Parameters:
| Field | Type | Description |
|---|---|---|
| match | integer | The unique ID of the football match. |
| matchday | integer | Matchday to which the league match corresponds. |
| home_team | integer | The unique ID of the home team. |
| home_team_name | string | The name of the home team. |
| away_team | integer | The unique ID of the away team. |
| away_team_name | string | The name of the away team. |
| player_team | integer | The unique ID of the player’s team. |
| player_team_name | string | The name of the player’s team. |
| player | integer | The unique ID of the player in the match lineup. |
| player_name | string | The name of the player in the match lineup. |
| position | integer | The unique ID of the player’s default position. |
| position_name | string | The name of the generic field position. |
| is_starting | bool | Flag to indicate whether the player started. |
| is_captain | bool | Flag to indicate whether the player was named captain. |
Link Parameters:
| Field | URL Description |
|---|---|
| match | Match Information resource representation. |
| player | Players resource representation. |
| home_team | Home Teams resource representation. |
| away_team | Away Teams resource representation. |
| stats | Match Statistics resource representations. |
Example #1:
Retrieve the starting lineup for one of the sides of a football match.
GET /v0/matches/1000003/lineups?is_starting=true&player_team_name=Liverpool HTTP/1.1
Host: api-summary.soccermetrics.net
Accept: application/json
HTTP/1.1 200 OK
Server: gunicorn/0.15.0
Date: Mon, 02 Sep 2013 06:23:19 GMT
Connection: close
Content-Type: application/json
Content-Length: 31208
Access-Control-Allow-Origin: *
{
"meta": {
"totalPages": 2,
"records": 10,
"totalRecords": 11,
"page": 1,
"next": "/v0/matches/1000003/lineups?is_starting=true&records=10&player_team_name=Liverpool&page=2",
"first": "/v0/matches/1000003/lineups?is_starting=true&records=10&player_team_name=Liverpool&page=1",
"last": "/v0/matches/1000003/lineups?is_starting=true&records=10&player_team_name=Liverpool&page=2",
"prev": null
},
"attribution": {
"html": "<a href=\"http://www.soccermetrics.net\"><img src=\"http://soccermetrics-mcfc.s3.amazonaws.com/logo/soccermetrics_logo.png\"/></a>",
"source": {
"html": "<a href=\"http://www.optasports.com\"><img src=\"http://soccermetrics-mcfc.s3.amazonaws.com/logo/opta_logo.png\"/></a>"
"logo": "http://soccermetrics-mcfc.s3.amazonaws.com/logo/opta_logo.png",
"url": "http://www.optasports.com",
"name": "Opta Sports"
},
"text": "Powered by Soccermetrics Research",
"url": "http://www.soccermetrics.net",
"logo": "http://soccermetrics-mcfc.s3.amazonaws.com/logo/soccermetrics_logo.png"
},
"result": [
{
"position_name": "Striker",
"is_starting": true,
"home_team": 10007,
"matchday": 1,
"home_team_name": "Liverpool",
"away_team_name": "Sunderland",
"is_captain": false,
"player_team_name": "Liverpool",
"player_team": 10007,
"position": 27,
"player_name": "Andy Carroll",
"link": {
"stats": {
"defense": {
"tackles": "/v0/stats/defense/tackles/1000053",
"clearances": "/v0/stats/defense/clearances/1000053",
"actions": "/v0/stats/defense/actions/1000053",
"goalline": "/v0/stats/defense/goalline/1000053",
"blocks": "/v0/stats/defense/blocks/1000053"
},
"fouls": {
"wins": "/v0/stats/fouls/wins/1000053",
"cards": "/v0/stats/fouls/cards/1000053"
},
"goals": {
"totals": "/v0/stats/goals/totals/1000053",
"bodyparts": "/v0/stats/goals/bodyparts/1000053",
"assists": "/v0/stats/goals/assists/1000053",
"penalties": "/v0/stats/goals/penalties/1000053",
"locations": "/v0/stats/goals/locations/1000053"
},
"crosses": {
"totals": "/v0/stats/crosses/totals/1000053",
"corners": "/v0/stats/crosses/corners/1000053"
},
"shots": {
"plays": "/v0/stats/shots/plays/1000053",
"totals": "/v0/stats/shots/totals/1000053",
"bodyparts": "/v0/stats/shots/bodyparts/1000053",
"locations": "/v0/stats/shots/locations/1000053"
},
"setpieces": {
"keyplays": "/v0/stats/setpieces/keyplays/1000053",
"corners": "/v0/stats/setpieces/corners/1000053",
"throwins": "/v0/stats/setpieces/throwins/1000053",
"freekicks": "/v0/stats/setpieces/freekicks/1000053"
},
"goalkeeper": {
"shots": "/v0/stats/goalkeeper/shots/1000053",
"actions": "/v0/stats/goalkeeper/actions/1000053",
"goals": "/v0/stats/goalkeeper/goals/1000053",
"saves": "/v0/stats/goalkeeper/saves/1000053"
},
"passes": {
"lengths": "/v0/stats/passes/lengths/1000053",
"totals": "/v0/stats/passes/totals/1000053",
"directions": "/v0/stats/passes/directions/1000053",
"locations": "/v0/stats/passes/locations/1000053"
},
"touches": {
"duels": "/v0/stats/touches/duels/1000053",
"totals": "/v0/stats/touches/totals/1000053",
"locations": "/v0/stats/touches/locations/1000053"
}
},
"home_team": "/v0/teams/10007",
"away_team": "/v0/teams/10014",
"match": "/v0/matches/1000003/info",
"player": "/v0/personnel/players/1000079"
},
"player": 1000079,
"away_team": 10014,
"uri": "/v0/matches/lineups?id=1000053",
"match": 1000003,
"id": 1000053
},
{
"position_name": "Central Midfielder",
"is_starting": true,
"home_team": 10007,
"matchday": 1,
"home_team_name": "Liverpool",
"away_team_name": "Sunderland",
"is_captain": false,
"player_team_name": "Liverpool",
"player_team": 10007,
"position": 21,
"player_name": "Charlie Adam",
"link": {
"stats": {
"defense": {
"tackles": "/v0/stats/defense/tackles/1000054",
"clearances": "/v0/stats/defense/clearances/1000054",
"actions": "/v0/stats/defense/actions/1000054",
"goalline": "/v0/stats/defense/goalline/1000054",
"blocks": "/v0/stats/defense/blocks/1000054"
},
"fouls": {
"wins": "/v0/stats/fouls/wins/1000054",
"cards": "/v0/stats/fouls/cards/1000054"
},
"goals": {
"totals": "/v0/stats/goals/totals/1000054",
"bodyparts": "/v0/stats/goals/bodyparts/1000054",
"assists": "/v0/stats/goals/assists/1000054",
"penalties": "/v0/stats/goals/penalties/1000054",
"locations": "/v0/stats/goals/locations/1000054"
},
"crosses": {
"totals": "/v0/stats/crosses/totals/1000054",
"corners": "/v0/stats/crosses/corners/1000054"
},
"shots": {
"plays": "/v0/stats/shots/plays/1000054",
"totals": "/v0/stats/shots/totals/1000054",
"bodyparts": "/v0/stats/shots/bodyparts/1000054",
"locations": "/v0/stats/shots/locations/1000054"
},
"setpieces": {
"keyplays": "/v0/stats/setpieces/keyplays/1000054",
"corners": "/v0/stats/setpieces/corners/1000054",
"throwins": "/v0/stats/setpieces/throwins/1000054",
"freekicks": "/v0/stats/setpieces/freekicks/1000054"
},
"goalkeeper": {
"shots": "/v0/stats/goalkeeper/shots/1000054",
"actions": "/v0/stats/goalkeeper/actions/1000054",
"goals": "/v0/stats/goalkeeper/goals/1000054",
"saves": "/v0/stats/goalkeeper/saves/1000054"
},
"passes": {
"lengths": "/v0/stats/passes/lengths/1000054",
"totals": "/v0/stats/passes/totals/1000054",
"directions": "/v0/stats/passes/directions/1000054",
"locations": "/v0/stats/passes/locations/1000054"
},
"touches": {
"duels": "/v0/stats/touches/duels/1000054",
"totals": "/v0/stats/touches/totals/1000054",
"locations": "/v0/stats/touches/locations/1000054"
}
},
"home_team": "/v0/teams/10007",
"away_team": "/v0/teams/10014",
"match": "/v0/matches/1000003/info",
"player": "/v0/personnel/players/1000001"
},
"player": 1000001,
"away_team": 10014,
"uri": "/v0/matches/lineups?id=1000054",
"match": 1000003,
"id": 1000054
},
{
"position_name": "Central Defender",
"is_starting": true,
"home_team": 10007,
"matchday": 1,
"home_team_name": "Liverpool",
"away_team_name": "Sunderland",
"is_captain": false,
"player_team_name": "Liverpool",
"player_team": 10007,
"position": 12,
"player_name": "Daniel Agger",
"link": {
"stats": {
"defense": {
"tackles": "/v0/stats/defense/tackles/1000055",
"clearances": "/v0/stats/defense/clearances/1000055",
"actions": "/v0/stats/defense/actions/1000055",
"goalline": "/v0/stats/defense/goalline/1000055",
"blocks": "/v0/stats/defense/blocks/1000055"
},
"fouls": {
"wins": "/v0/stats/fouls/wins/1000055",
"cards": "/v0/stats/fouls/cards/1000055"
},
"goals": {
"totals": "/v0/stats/goals/totals/1000055",
"bodyparts": "/v0/stats/goals/bodyparts/1000055",
"assists": "/v0/stats/goals/assists/1000055",
"penalties": "/v0/stats/goals/penalties/1000055",
"locations": "/v0/stats/goals/locations/1000055"
},
"crosses": {
"totals": "/v0/stats/crosses/totals/1000055",
"corners": "/v0/stats/crosses/corners/1000055"
},
"shots": {
"plays": "/v0/stats/shots/plays/1000055",
"totals": "/v0/stats/shots/totals/1000055",
"bodyparts": "/v0/stats/shots/bodyparts/1000055",
"locations": "/v0/stats/shots/locations/1000055"
},
"setpieces": {
"keyplays": "/v0/stats/setpieces/keyplays/1000055",
"corners": "/v0/stats/setpieces/corners/1000055",
"throwins": "/v0/stats/setpieces/throwins/1000055",
"freekicks": "/v0/stats/setpieces/freekicks/1000055"
},
"goalkeeper": {
"shots": "/v0/stats/goalkeeper/shots/1000055",
"actions": "/v0/stats/goalkeeper/actions/1000055",
"goals": "/v0/stats/goalkeeper/goals/1000055",
"saves": "/v0/stats/goalkeeper/saves/1000055"
},
"passes": {
"lengths": "/v0/stats/passes/lengths/1000055",
"totals": "/v0/stats/passes/totals/1000055",
"directions": "/v0/stats/passes/directions/1000055",
"locations": "/v0/stats/passes/locations/1000055"
},
"touches": {
"duels": "/v0/stats/touches/duels/1000055",
"totals": "/v0/stats/touches/totals/1000055",
"locations": "/v0/stats/touches/locations/1000055"
}
},
"home_team": "/v0/teams/10007",
"away_team": "/v0/teams/10014",
"match": "/v0/matches/1000003/info",
"player": "/v0/personnel/players/1000005"
},
"player": 1000005,
"away_team": 10014,
"uri": "/v0/matches/lineups?id=1000055",
"match": 1000003,
"id": 1000055
},
{
"position_name": "Defender",
"is_starting": true,
"home_team": 10007,
"matchday": 1,
"home_team_name": "Liverpool",
"away_team_name": "Sunderland",
"is_captain": true,
"player_team_name": "Liverpool",
"player_team": 10007,
"position": 11,
"player_name": "Jamie Carragher",
"link": {
"stats": {
"defense": {
"tackles": "/v0/stats/defense/tackles/1000056",
"clearances": "/v0/stats/defense/clearances/1000056",
"actions": "/v0/stats/defense/actions/1000056",
"goalline": "/v0/stats/defense/goalline/1000056",
"blocks": "/v0/stats/defense/blocks/1000056"
},
"fouls": {
"wins": "/v0/stats/fouls/wins/1000056",
"cards": "/v0/stats/fouls/cards/1000056"
},
"goals": {
"totals": "/v0/stats/goals/totals/1000056",
"bodyparts": "/v0/stats/goals/bodyparts/1000056",
"assists": "/v0/stats/goals/assists/1000056",
"penalties": "/v0/stats/goals/penalties/1000056",
"locations": "/v0/stats/goals/locations/1000056"
},
"crosses": {
"totals": "/v0/stats/crosses/totals/1000056",
"corners": "/v0/stats/crosses/corners/1000056"
},
"shots": {
"plays": "/v0/stats/shots/plays/1000056",
"totals": "/v0/stats/shots/totals/1000056",
"bodyparts": "/v0/stats/shots/bodyparts/1000056",
"locations": "/v0/stats/shots/locations/1000056"
},
"setpieces": {
"keyplays": "/v0/stats/setpieces/keyplays/1000056",
"corners": "/v0/stats/setpieces/corners/1000056",
"throwins": "/v0/stats/setpieces/throwins/1000056",
"freekicks": "/v0/stats/setpieces/freekicks/1000056"
},
"goalkeeper": {
"shots": "/v0/stats/goalkeeper/shots/1000056",
"actions": "/v0/stats/goalkeeper/actions/1000056",
"goals": "/v0/stats/goalkeeper/goals/1000056",
"saves": "/v0/stats/goalkeeper/saves/1000056"
},
"passes": {
"lengths": "/v0/stats/passes/lengths/1000056",
"totals": "/v0/stats/passes/totals/1000056",
"directions": "/v0/stats/passes/directions/1000056",
"locations": "/v0/stats/passes/locations/1000056"
},
"touches": {
"duels": "/v0/stats/touches/duels/1000056",
"totals": "/v0/stats/touches/totals/1000056",
"locations": "/v0/stats/touches/locations/1000056"
}
},
"home_team": "/v0/teams/10007",
"away_team": "/v0/teams/10014",
"match": "/v0/matches/1000003/info",
"player": "/v0/personnel/players/1000077"
},
"player": 1000077,
"away_team": 10014,
"uri": "/v0/matches/lineups?id=1000056",
"match": 1000003,
"id": 1000056
},
{
"position_name": "Right Full-back",
"is_starting": true,
"home_team": 10007,
"matchday": 1,
"home_team_name": "Liverpool",
"away_team_name": "Sunderland",
"is_captain": false,
"player_team_name": "Liverpool",
"player_team": 10007,
"position": 16,
"player_name": "Jon Flanagan",
"link": {
"stats": {
"defense": {
"tackles": "/v0/stats/defense/tackles/1000057",
"clearances": "/v0/stats/defense/clearances/1000057",
"actions": "/v0/stats/defense/actions/1000057",
"goalline": "/v0/stats/defense/goalline/1000057",
"blocks": "/v0/stats/defense/blocks/1000057"
},
"fouls": {
"wins": "/v0/stats/fouls/wins/1000057",
"cards": "/v0/stats/fouls/cards/1000057"
},
"goals": {
"totals": "/v0/stats/goals/totals/1000057",
"bodyparts": "/v0/stats/goals/bodyparts/1000057",
"assists": "/v0/stats/goals/assists/1000057",
"penalties": "/v0/stats/goals/penalties/1000057",
"locations": "/v0/stats/goals/locations/1000057"
},
"crosses": {
"totals": "/v0/stats/crosses/totals/1000057",
"corners": "/v0/stats/crosses/corners/1000057"
},
"shots": {
"plays": "/v0/stats/shots/plays/1000057",
"totals": "/v0/stats/shots/totals/1000057",
"bodyparts": "/v0/stats/shots/bodyparts/1000057",
"locations": "/v0/stats/shots/locations/1000057"
},
"setpieces": {
"keyplays": "/v0/stats/setpieces/keyplays/1000057",
"corners": "/v0/stats/setpieces/corners/1000057",
"throwins": "/v0/stats/setpieces/throwins/1000057",
"freekicks": "/v0/stats/setpieces/freekicks/1000057"
},
"goalkeeper": {
"shots": "/v0/stats/goalkeeper/shots/1000057",
"actions": "/v0/stats/goalkeeper/actions/1000057",
"goals": "/v0/stats/goalkeeper/goals/1000057",
"saves": "/v0/stats/goalkeeper/saves/1000057"
},
"passes": {
"lengths": "/v0/stats/passes/lengths/1000057",
"totals": "/v0/stats/passes/totals/1000057",
"directions": "/v0/stats/passes/directions/1000057",
"locations": "/v0/stats/passes/locations/1000057"
},
"touches": {
"duels": "/v0/stats/touches/duels/1000057",
"totals": "/v0/stats/touches/totals/1000057",
"locations": "/v0/stats/touches/locations/1000057"
}
},
"home_team": "/v0/teams/10007",
"away_team": "/v0/teams/10014",
"match": "/v0/matches/1000003/info",
"player": "/v0/personnel/players/1000165"
},
"player": 1000165,
"away_team": 10014,
"uri": "/v0/matches/lineups?id=1000057",
"match": 1000003,
"id": 1000057
},
{
"position_name": "Midfielder",
"is_starting": true,
"home_team": 10007,
"matchday": 1,
"home_team_name": "Liverpool",
"away_team_name": "Sunderland",
"is_captain": false,
"player_team_name": "Liverpool",
"player_team": 10007,
"position": 20,
"player_name": "Jordan Henderson",
"link": {
"stats": {
"defense": {
"tackles": "/v0/stats/defense/tackles/1000058",
"clearances": "/v0/stats/defense/clearances/1000058",
"actions": "/v0/stats/defense/actions/1000058",
"goalline": "/v0/stats/defense/goalline/1000058",
"blocks": "/v0/stats/defense/blocks/1000058"
},
"fouls": {
"wins": "/v0/stats/fouls/wins/1000058",
"cards": "/v0/stats/fouls/cards/1000058"
},
"goals": {
"totals": "/v0/stats/goals/totals/1000058",
"bodyparts": "/v0/stats/goals/bodyparts/1000058",
"assists": "/v0/stats/goals/assists/1000058",
"penalties": "/v0/stats/goals/penalties/1000058",
"locations": "/v0/stats/goals/locations/1000058"
},
"crosses": {
"totals": "/v0/stats/crosses/totals/1000058",
"corners": "/v0/stats/crosses/corners/1000058"
},
"shots": {
"plays": "/v0/stats/shots/plays/1000058",
"totals": "/v0/stats/shots/totals/1000058",
"bodyparts": "/v0/stats/shots/bodyparts/1000058",
"locations": "/v0/stats/shots/locations/1000058"
},
"setpieces": {
"keyplays": "/v0/stats/setpieces/keyplays/1000058",
"corners": "/v0/stats/setpieces/corners/1000058",
"throwins": "/v0/stats/setpieces/throwins/1000058",
"freekicks": "/v0/stats/setpieces/freekicks/1000058"
},
"goalkeeper": {
"shots": "/v0/stats/goalkeeper/shots/1000058",
"actions": "/v0/stats/goalkeeper/actions/1000058",
"goals": "/v0/stats/goalkeeper/goals/1000058",
"saves": "/v0/stats/goalkeeper/saves/1000058"
},
"passes": {
"lengths": "/v0/stats/passes/lengths/1000058",
"totals": "/v0/stats/passes/totals/1000058",
"directions": "/v0/stats/passes/directions/1000058",
"locations": "/v0/stats/passes/locations/1000058"
},
"touches": {
"duels": "/v0/stats/touches/duels/1000058",
"totals": "/v0/stats/touches/totals/1000058",
"locations": "/v0/stats/touches/locations/1000058"
}
},
"home_team": "/v0/teams/10007",
"away_team": "/v0/teams/10014",
"match": "/v0/matches/1000003/info",
"player": "/v0/personnel/players/1000219"
},
"player": 1000219,
"away_team": 10014,
"uri": "/v0/matches/lineups?id=1000058",
"match": 1000003,
"id": 1000058
},
{
"position_name": "Left Full-back",
"is_starting": true,
"home_team": 10007,
"matchday": 1,
"home_team_name": "Liverpool",
"away_team_name": "Sunderland",
"is_captain": false,
"player_team_name": "Liverpool",
"player_team": 10007,
"position": 15,
"player_name": "Jos\u00e9 Enrique",
"link": {
"stats": {
"defense": {
"tackles": "/v0/stats/defense/tackles/1000059",
"clearances": "/v0/stats/defense/clearances/1000059",
"actions": "/v0/stats/defense/actions/1000059",
"goalline": "/v0/stats/defense/goalline/1000059",
"blocks": "/v0/stats/defense/blocks/1000059"
},
"fouls": {
"wins": "/v0/stats/fouls/wins/1000059",
"cards": "/v0/stats/fouls/cards/1000059"
},
"goals": {
"totals": "/v0/stats/goals/totals/1000059",
"bodyparts": "/v0/stats/goals/bodyparts/1000059",
"assists": "/v0/stats/goals/assists/1000059",
"penalties": "/v0/stats/goals/penalties/1000059",
"locations": "/v0/stats/goals/locations/1000059"
},
"crosses": {
"totals": "/v0/stats/crosses/totals/1000059",
"corners": "/v0/stats/crosses/corners/1000059"
},
"shots": {
"plays": "/v0/stats/shots/plays/1000059",
"totals": "/v0/stats/shots/totals/1000059",
"bodyparts": "/v0/stats/shots/bodyparts/1000059",
"locations": "/v0/stats/shots/locations/1000059"
},
"setpieces": {
"keyplays": "/v0/stats/setpieces/keyplays/1000059",
"corners": "/v0/stats/setpieces/corners/1000059",
"throwins": "/v0/stats/setpieces/throwins/1000059",
"freekicks": "/v0/stats/setpieces/freekicks/1000059"
},
"goalkeeper": {
"shots": "/v0/stats/goalkeeper/shots/1000059",
"actions": "/v0/stats/goalkeeper/actions/1000059",
"goals": "/v0/stats/goalkeeper/goals/1000059",
"saves": "/v0/stats/goalkeeper/saves/1000059"
},
"passes": {
"lengths": "/v0/stats/passes/lengths/1000059",
"totals": "/v0/stats/passes/totals/1000059",
"directions": "/v0/stats/passes/directions/1000059",
"locations": "/v0/stats/passes/locations/1000059"
},
"touches": {
"duels": "/v0/stats/touches/duels/1000059",
"totals": "/v0/stats/touches/totals/1000059",
"locations": "/v0/stats/touches/locations/1000059"
}
},
"home_team": "/v0/teams/10007",
"away_team": "/v0/teams/10014",
"match": "/v0/matches/1000003/info",
"player": "/v0/personnel/players/1000267"
},
"player": 1000267,
"away_team": 10014,
"uri": "/v0/matches/lineups?id=1000059",
"match": 1000003,
"id": 1000059
},
{
"position_name": "Goalkeeper",
"is_starting": true,
"home_team": 10007,
"matchday": 1,
"home_team_name": "Liverpool",
"away_team_name": "Sunderland",
"is_captain": false,
"player_team_name": "Liverpool",
"player_team": 10007,
"position": 10,
"player_name": "Jos\u00e9 Reina",
"link": {
"stats": {
"defense": {
"tackles": "/v0/stats/defense/tackles/1000060",
"clearances": "/v0/stats/defense/clearances/1000060",
"actions": "/v0/stats/defense/actions/1000060",
"goalline": "/v0/stats/defense/goalline/1000060",
"blocks": "/v0/stats/defense/blocks/1000060"
},
"fouls": {
"wins": "/v0/stats/fouls/wins/1000060",
"cards": "/v0/stats/fouls/cards/1000060"
},
"goals": {
"totals": "/v0/stats/goals/totals/1000060",
"bodyparts": "/v0/stats/goals/bodyparts/1000060",
"assists": "/v0/stats/goals/assists/1000060",
"penalties": "/v0/stats/goals/penalties/1000060",
"locations": "/v0/stats/goals/locations/1000060"
},
"crosses": {
"totals": "/v0/stats/crosses/totals/1000060",
"corners": "/v0/stats/crosses/corners/1000060"
},
"shots": {
"plays": "/v0/stats/shots/plays/1000060",
"totals": "/v0/stats/shots/totals/1000060",
"bodyparts": "/v0/stats/shots/bodyparts/1000060",
"locations": "/v0/stats/shots/locations/1000060"
},
"setpieces": {
"keyplays": "/v0/stats/setpieces/keyplays/1000060",
"corners": "/v0/stats/setpieces/corners/1000060",
"throwins": "/v0/stats/setpieces/throwins/1000060",
"freekicks": "/v0/stats/setpieces/freekicks/1000060"
},
"goalkeeper": {
"shots": "/v0/stats/goalkeeper/shots/1000060",
"actions": "/v0/stats/goalkeeper/actions/1000060",
"goals": "/v0/stats/goalkeeper/goals/1000060",
"saves": "/v0/stats/goalkeeper/saves/1000060"
},
"passes": {
"lengths": "/v0/stats/passes/lengths/1000060",
"totals": "/v0/stats/passes/totals/1000060",
"directions": "/v0/stats/passes/directions/1000060",
"locations": "/v0/stats/passes/locations/1000060"
},
"touches": {
"duels": "/v0/stats/touches/duels/1000060",
"totals": "/v0/stats/touches/totals/1000060",
"locations": "/v0/stats/touches/locations/1000060"
}
},
"home_team": "/v0/teams/10007",
"away_team": "/v0/teams/10014",
"match": "/v0/matches/1000003/info",
"player": "/v0/personnel/players/1000401"
},
"player": 1000401,
"away_team": 10014,
"uri": "/v0/matches/lineups?id=1000060",
"match": 1000003,
"id": 1000060
},
{
"position_name": "Central Midfielder",
"is_starting": true,
"home_team": 10007,
"matchday": 1,
"home_team_name": "Liverpool",
"away_team_name": "Sunderland",
"is_captain": false,
"player_team_name": "Liverpool",
"player_team": 10007,
"position": 21,
"player_name": "Lucas Leiva",
"link": {
"stats": {
"defense": {
"tackles": "/v0/stats/defense/tackles/1000061",
"clearances": "/v0/stats/defense/clearances/1000061",
"actions": "/v0/stats/defense/actions/1000061",
"goalline": "/v0/stats/defense/goalline/1000061",
"blocks": "/v0/stats/defense/blocks/1000061"
},
"fouls": {
"wins": "/v0/stats/fouls/wins/1000061",
"cards": "/v0/stats/fouls/cards/1000061"
},
"goals": {
"totals": "/v0/stats/goals/totals/1000061",
"bodyparts": "/v0/stats/goals/bodyparts/1000061",
"assists": "/v0/stats/goals/assists/1000061",
"penalties": "/v0/stats/goals/penalties/1000061",
"locations": "/v0/stats/goals/locations/1000061"
},
"crosses": {
"totals": "/v0/stats/crosses/totals/1000061",
"corners": "/v0/stats/crosses/corners/1000061"
},
"shots": {
"plays": "/v0/stats/shots/plays/1000061",
"totals": "/v0/stats/shots/totals/1000061",
"bodyparts": "/v0/stats/shots/bodyparts/1000061",
"locations": "/v0/stats/shots/locations/1000061"
},
"setpieces": {
"keyplays": "/v0/stats/setpieces/keyplays/1000061",
"corners": "/v0/stats/setpieces/corners/1000061",
"throwins": "/v0/stats/setpieces/throwins/1000061",
"freekicks": "/v0/stats/setpieces/freekicks/1000061"
},
"goalkeeper": {
"shots": "/v0/stats/goalkeeper/shots/1000061",
"actions": "/v0/stats/goalkeeper/actions/1000061",
"goals": "/v0/stats/goalkeeper/goals/1000061",
"saves": "/v0/stats/goalkeeper/saves/1000061"
},
"passes": {
"lengths": "/v0/stats/passes/lengths/1000061",
"totals": "/v0/stats/passes/totals/1000061",
"directions": "/v0/stats/passes/directions/1000061",
"locations": "/v0/stats/passes/locations/1000061"
},
"touches": {
"duels": "/v0/stats/touches/duels/1000061",
"totals": "/v0/stats/touches/totals/1000061",
"locations": "/v0/stats/touches/locations/1000061"
}
},
"home_team": "/v0/teams/10007",
"away_team": "/v0/teams/10014",
"match": "/v0/matches/1000003/info",
"player": "/v0/personnel/players/1000308"
},
"player": 1000308,
"away_team": 10014,
"uri": "/v0/matches/lineups?id=1000061",
"match": 1000003,
"id": 1000061
},
{
"position_name": "Striker",
"is_starting": true,
"home_team": 10007,
"matchday": 1,
"home_team_name": "Liverpool",
"away_team_name": "Sunderland",
"is_captain": false,
"player_team_name": "Liverpool",
"player_team": 10007,
"position": 27,
"player_name": "Luis Su\u00e1rez",
"link": {
"stats": {
"defense": {
"tackles": "/v0/stats/defense/tackles/1000062",
"clearances": "/v0/stats/defense/clearances/1000062",
"actions": "/v0/stats/defense/actions/1000062",
"goalline": "/v0/stats/defense/goalline/1000062",
"blocks": "/v0/stats/defense/blocks/1000062"
},
"fouls": {
"wins": "/v0/stats/fouls/wins/1000062",
"cards": "/v0/stats/fouls/cards/1000062"
},
"goals": {
"totals": "/v0/stats/goals/totals/1000062",
"bodyparts": "/v0/stats/goals/bodyparts/1000062",
"assists": "/v0/stats/goals/assists/1000062",
"penalties": "/v0/stats/goals/penalties/1000062",
"locations": "/v0/stats/goals/locations/1000062"
},
"crosses": {
"totals": "/v0/stats/crosses/totals/1000062",
"corners": "/v0/stats/crosses/corners/1000062"
},
"shots": {
"plays": "/v0/stats/shots/plays/1000062",
"totals": "/v0/stats/shots/totals/1000062",
"bodyparts": "/v0/stats/shots/bodyparts/1000062",
"locations": "/v0/stats/shots/locations/1000062"
},
"setpieces": {
"keyplays": "/v0/stats/setpieces/keyplays/1000062",
"corners": "/v0/stats/setpieces/corners/1000062",
"throwins": "/v0/stats/setpieces/throwins/1000062",
"freekicks": "/v0/stats/setpieces/freekicks/1000062"
},
"goalkeeper": {
"shots": "/v0/stats/goalkeeper/shots/1000062",
"actions": "/v0/stats/goalkeeper/actions/1000062",
"goals": "/v0/stats/goalkeeper/goals/1000062",
"saves": "/v0/stats/goalkeeper/saves/1000062"
},
"passes": {
"lengths": "/v0/stats/passes/lengths/1000062",
"totals": "/v0/stats/passes/totals/1000062",
"directions": "/v0/stats/passes/directions/1000062",
"locations": "/v0/stats/passes/locations/1000062"
},
"touches": {
"duels": "/v0/stats/touches/duels/1000062",
"totals": "/v0/stats/touches/totals/1000062",
"locations": "/v0/stats/touches/locations/1000062"
}
},
"home_team": "/v0/teams/10007",
"away_team": "/v0/teams/10014",
"match": "/v0/matches/1000003/info",
"player": "/v0/personnel/players/1000469"
},
"player": 1000469,
"away_team": 10014,
"uri": "/v0/matches/lineups?id=1000062",
"match": 1000003,
"id": 1000062
}
]
}
Example #2:
Retrieve the (used) substitutes for one of the sides in a football match.
GET /v0/matches/1000003/lineups?is_starting=false&player_team_name=Liverpool HTTP/1.1
Host: api-summary.soccermetrics.net
Accept: application/json
HTTP/1.1 200 OK
Server: gunicorn/0.15.0
Date: Mon, 02 Sep 2013 06:26:15 GMT
Connection: close
Content-Type: application/json
Content-Length: 6525
Access-Control-Allow-Origin: *
{
"meta": {
"totalPages": 1,
"records": 10,
"totalRecords": 2,
"page": 1,
"next": null,
"first": "/v0/matches/1000003/lineups?is_starting=false&records=10&player_team_name=Liverpool&page=1",
"last": "/v0/matches/1000003/lineups?is_starting=false&records=10&player_team_name=Liverpool&page=1",
"prev": null
},
"result": [
{
"home_team": 10007,
"away_team": 10014,
"player_name": "Dirk Kuyt",
"home_team_name": "Liverpool",
"player_team": 10007,
"is_starting": false,
"player_team_name": "Liverpool",
"matchday": 1,
"uri": "/v0/matches/lineups?id=1010447",
"player": 1000282,
"is_captain": false,
"link": {
"player": "/v0/personnel/players/1000282",
"home_team": "/v0/teams/10007",
"away_team": "/v0/teams/10014",
"stats": {
"setpieces": {
"corners": "/v0/stats/setpieces/corners?lineup=1010447",
"freekicks": "/v0/stats/setpieces/freekicks?lineup=1010447",
"throwins": "/v0/stats/setpieces/throwins?lineup=1010447",
"keyplays": "/v0/stats/setpieces/keyplays?lineup=1010447"
},
"passes": {
"directions": "/v0/stats/passes/directions?lineup=1010447",
"lengths": "/v0/stats/passes/lengths?lineup=1010447",
"locations": "/v0/stats/passes/locations?lineup=1010447",
"totals": "/v0/stats/passes/totals?lineup=1010447"
},
"touches": {
"duels": "/v0/stats/touches/duels?lineup=1010447",
"locations": "/v0/stats/touches/locations?lineup=1010447",
"totals": "/v0/stats/touches/totals?lineup=1010447"
},
"crosses": {
"corners": "/v0/stats/crosses/corners?lineup=1010447",
"totals": "/v0/stats/crosses/totals?lineup=1010447"
},
"fouls": {
"cards": "/v0/stats/fouls/cards?lineup=1010447",
"wins": "/v0/stats/fouls/wins?lineup=1010447"
},
"defense": {
"goalline": "/v0/stats/defense/goalline?lineup=1010447",
"blocks": "/v0/stats/defense/blocks?lineup=1010447",
"tackles": "/v0/stats/defense/tackles?lineup=1010447",
"actions": "/v0/stats/defense/actions?lineup=1010447",
"clearances": "/v0/stats/defense/clearances?lineup=1010447"
},
"goals": {
"penalties": "/v0/stats/goals/penalties?lineup=1010447",
"bodyparts": "/v0/stats/goals/bodyparts?lineup=1010447",
"locations": "/v0/stats/goals/locations?lineup=1010447",
"assists": "/v0/stats/goals/assists?lineup=1010447",
"totals": "/v0/stats/goals/totals?lineup=1010447"
},
"shots": {
"bodyparts": "/v0/stats/shots/bodyparts?lineup=1010447",
"plays": "/v0/stats/shots/plays?lineup=1010447",
"locations": "/v0/stats/shots/locations?lineup=1010447",
"totals": "/v0/stats/shots/totals?lineup=1010447"
},
"goalkeeper": {
"actions": "/v0/stats/goalkeeper/actions?lineup=1010447",
"saves": "/v0/stats/goalkeeper/saves?lineup=1010447",
"goals": "/v0/stats/goalkeeper/goals?lineup=1010447",
"shots": "/v0/stats/goalkeeper/shots?lineup=1010447"
}
},
"match": "/v0/matches/1000003/info"
},
"away_team_name": "Sunderland",
"position_name": "Right Forward",
"position": 26,
"id": 1010447,
"match": 1000003
},
{
"home_team": 10007,
"away_team": 10014,
"player_name": "Raul Meireles",
"home_team_name": "Liverpool",
"player_team": 10007,
"is_starting": false,
"player_team_name": "Liverpool",
"matchday": 1,
"uri": "/v0/matches/lineups?id=1010448",
"player": 1000322,
"is_captain": false,
"link": {
"player": "/v0/personnel/players/1000322",
"home_team": "/v0/teams/10007",
"away_team": "/v0/teams/10014",
"stats": {
"setpieces": {
"corners": "/v0/stats/setpieces/corners?lineup=1010448",
"freekicks": "/v0/stats/setpieces/freekicks?lineup=1010448",
"throwins": "/v0/stats/setpieces/throwins?lineup=1010448",
"keyplays": "/v0/stats/setpieces/keyplays?lineup=1010448"
},
"passes": {
"directions": "/v0/stats/passes/directions?lineup=1010448",
"lengths": "/v0/stats/passes/lengths?lineup=1010448",
"locations": "/v0/stats/passes/locations?lineup=1010448",
"totals": "/v0/stats/passes/totals?lineup=1010448"
},
"touches": {
"duels": "/v0/stats/touches/duels?lineup=1010448",
"locations": "/v0/stats/touches/locations?lineup=1010448",
"totals": "/v0/stats/touches/totals?lineup=1010448"
},
"crosses": {
"corners": "/v0/stats/crosses/corners?lineup=1010448",
"totals": "/v0/stats/crosses/totals?lineup=1010448"
},
"fouls": {
"cards": "/v0/stats/fouls/cards?lineup=1010448",
"wins": "/v0/stats/fouls/wins?lineup=1010448"
},
"defense": {
"goalline": "/v0/stats/defense/goalline?lineup=1010448",
"blocks": "/v0/stats/defense/blocks?lineup=1010448",
"tackles": "/v0/stats/defense/tackles?lineup=1010448",
"actions": "/v0/stats/defense/actions?lineup=1010448",
"clearances": "/v0/stats/defense/clearances?lineup=1010448"
},
"goals": {
"penalties": "/v0/stats/goals/penalties?lineup=1010448",
"bodyparts": "/v0/stats/goals/bodyparts?lineup=1010448",
"locations": "/v0/stats/goals/locations?lineup=1010448",
"assists": "/v0/stats/goals/assists?lineup=1010448",
"totals": "/v0/stats/goals/totals?lineup=1010448"
},
"shots": {
"bodyparts": "/v0/stats/shots/bodyparts?lineup=1010448",
"plays": "/v0/stats/shots/plays?lineup=1010448",
"locations": "/v0/stats/shots/locations?lineup=1010448",
"totals": "/v0/stats/shots/totals?lineup=1010448"
},
"goalkeeper": {
"actions": "/v0/stats/goalkeeper/actions?lineup=1010448",
"saves": "/v0/stats/goalkeeper/saves?lineup=1010448",
"goals": "/v0/stats/goalkeeper/goals?lineup=1010448",
"shots": "/v0/stats/goalkeeper/shots?lineup=1010448"
}
},
"match": "/v0/matches/1000003/info"
},
"away_team_name": "Sunderland",
"position_name": "Central Midfielder",
"position": 21,
"id": 1010448,
"match": 1000003
}
]
}