The Service Root is the central resource of the Soccermetrics API. From this point you can access all of the publicly-available resources.
Returns hyperlinks to all base resources in the API.
Note
Analytics resources are canonical (i.e. they are directly tied to a competition, match, or player), so they are not linked to the service root.
Link Parameters:
| Field | URL Description |
|---|---|
| bodyparts | Body part resource representation. |
| cards | Disciplinary cards resource representation. |
| club/events | Club match events resource representations. |
| club/matches | Club match resource representations. |
| club/stats | Club match statistics resource representations. |
| competitions | Football competitions resource representation. |
| confederations | Confederations resource representation. |
| countries | Countries resource representation. |
| domesticCompetitions | Domestic football competitions resource representation. |
| fouls | Fouls resource representation. |
| grouprounds | Group Rounds resource representation. |
| intlCompetitions | International football competitions resource representation. |
| knockoutrounds | Knockout Rounds resource representation. |
| managers | Managers resource representation. |
| nameOrder | Name order resource representation. |
| natl/events | National team match events resource representations. |
| natl/matches | National team match resource representations. |
| natl/stats | National team match statistics resource representations. |
| penaltyOutcomes | Penalty outcomes resource representation. |
| personnel | Match personnel resource representations. |
| persons | Persons resource representation. |
| phases | Match phases resource representation. |
| players | Players resource representation. |
| positions | Player positions resource representation. |
| referees | Match referees resource representation. |
| seasons | Seasons resource representation. |
| shotevents | Shot events resource representations. |
| surfaces | Playing surfaces resource representation. |
| teams | Teams resource representation. |
| timezones | Time Zone resource representation. |
| venues | Match venues resource representation. |
| weather | Weather conditions resource representation. |
Example:
Connect APIGET /v1/ HTTP/1.1
Host: api-connect.soccermetrics.net
Accept: application/json
HTTP/1.1 200 OK
Server: gunicorn/18.0
Date: Sat, 19 Jul 2014 05:13:40 GMT
Connection: close
Content-Type: application/json
Content-Length: 6951
Access-Control-Allow-Origin: *
{
"meta": {},
"result": {
"link": {
"bodyparts": "/v1/bodyparts",
"cards": "/v1/cards",
"club": {
"events": {
"actions": "/v1/clubs/events/actions",
"all": "/v1/clubs/events/all",
"touches": "/v1/clubs/events/touches"
},
"matches": {
"conditions": "/v1/clubs/matches/conditions",
"goals": "/v1/clubs/matches/goals",
"info": "/v1/clubs/matches/info",
"lineups": "/v1/clubs/matches/lineups",
"offenses": "/v1/clubs/matches/offenses",
"penalties": "/v1/clubs/matches/penalties",
"substitutions": "/v1/clubs/matches/substitutions"
},
"stats": {
"crosses": {
"corners": "/v1/clubs/stats/crosses/corners",
"totals": "/v1/clubs/stats/crosses/totals"
},
"defense": {
"actions": "/v1/clubs/stats/defense/actions",
"blocks": "/v1/clubs/stats/defense/blocks",
"clearances": "/v1/clubs/stats/defense/clearances",
"goalline": "/v1/clubs/stats/defense/goalline",
"tackles": "/v1/clubs/stats/defense/tackles"
},
"fouls": {
"cards": "/v1/clubs/stats/fouls/cards",
"wins": "/v1/clubs/stats/fouls/wins"
},
"goalkeeper": {
"actions": "/v1/clubs/stats/goalkeeper/actions",
"goals": "/v1/clubs/stats/goalkeeper/goals",
"saves": "/v1/clubs/stats/goalkeeper/saves",
"shots": "/v1/clubs/stats/goalkeeper/shots"
},
"goals": {
"assists": "/v1/clubs/stats/goals/assists",
"bodyparts": "/v1/clubs/stats/goals/bodyparts",
"locations": "/v1/clubs/stats/goals/locations",
"penalties": "/v1/clubs/stats/goals/penalties",
"totals": "/v1/clubs/stats/goals/totals"
},
"passes": {
"directions": "/v1/clubs/stats/passes/directions",
"lengths": "/v1/clubs/stats/passes/lengths",
"locations": "/v1/clubs/stats/passes/locations",
"totals": "/v1/clubs/stats/passes/totals"
},
"setpieces": {
"corners": "/v1/clubs/stats/setpieces/corners",
"freekicks": "/v1/clubs/stats/setpieces/freekicks",
"throwins": "/v1/clubs/stats/setpieces/throwins"
},
"shots": {
"bodyparts": "/v1/clubs/stats/shots/bodyparts",
"locations": "/v1/clubs/stats/shots/locations",
"plays": "/v1/clubs/stats/shots/plays",
"totals": "/v1/clubs/stats/shots/totals"
},
"touches": {
"duels": "/v1/clubs/stats/touches/duels",
"locations": "/v1/clubs/stats/touches/locations",
"totals": "/v1/clubs/stats/touches/totals"
}
}
},
"competitions": "/v1/competitions",
"confederations": "/v1/confederations",
"countries": "/v1/countries",
"domesticCompetitions": "/v1/domestic_competitions",
"fouls": "/v1/fouls",
"grouprounds": "/v1/grouprounds",
"intlCompetitions": "/v1/intl_competitions",
"knockoutrounds": "/v1/knockoutrounds",
"managers": "/v1/managers",
"nameOrder": "/v1/name_order",
"natl": {
"events": {
"actions": "/v1/national/events/actions",
"all": "/v1/national/events/all",
"touches": "/v1/national/events/touches"
},
"matches": {
"conditions": "/v1/national/matches/conditions",
"goals": "/v1/national/matches/goals",
"info": "/v1/national/matches/info",
"lineups": "/v1/national/matches/lineups",
"offenses": "/v1/national/matches/offenses",
"penalties": "/v1/national/matches/penalties",
"substitutions": "/v1/national/matches/substitutions"
},
"stats": {
"crosses": {
"corners": "/v1/national/stats/crosses/corners",
"totals": "/v1/national/stats/crosses/totals"
},
"defense": {
"actions": "/v1/national/stats/defense/actions",
"blocks": "/v1/national/stats/defense/blocks",
"clearances": "/v1/national/stats/defense/clearances",
"goalline": "/v1/national/stats/defense/goalline",
"tackles": "/v1/national/stats/defense/tackles"
},
"fouls": {
"cards": "/v1/national/stats/fouls/cards",
"wins": "/v1/national/stats/fouls/wins"
},
"goalkeeper": {
"actions": "/v1/national/stats/goalkeeper/actions",
"goals": "/v1/national/stats/goalkeeper/goals",
"saves": "/v1/national/stats/goalkeeper/saves",
"shots": "/v1/national/stats/goalkeeper/shots"
},
"goals": {
"assists": "/v1/national/stats/goals/assists",
"bodyparts": "/v1/national/stats/goals/bodyparts",
"locations": "/v1/national/stats/goals/locations",
"penalties": "/v1/national/stats/goals/penalties",
"totals": "/v1/national/stats/goals/totals"
},
"passes": {
"directions": "/v1/national/stats/passes/directions",
"lengths": "/v1/national/stats/passes/lengths",
"locations": "/v1/national/stats/passes/locations",
"totals": "/v1/national/stats/passes/totals"
},
"setpieces": {
"corners": "/v1/national/stats/setpieces/corners",
"freekicks": "/v1/national/stats/setpieces/freekicks",
"throwins": "/v1/national/stats/setpieces/throwins"
},
"shots": {
"bodyparts": "/v1/national/stats/shots/bodyparts",
"locations": "/v1/national/stats/shots/locations",
"plays": "/v1/national/stats/shots/plays",
"totals": "/v1/national/stats/shots/totals"
},
"touches": {
"duels": "/v1/national/stats/touches/duels",
"locations": "/v1/national/stats/touches/locations",
"totals": "/v1/national/stats/touches/totals"
}
}
},
"penaltyOutcomes": "/v1/penalty_outcomes",
"personnel": {
"managers": "/v1/personnel/managers",
"players": "/v1/personnel/players",
"referees": "/v1/personnel/referees"
},
"persons": "/v1/persons",
"phases": "/v1/phases",
"players": "/v1/players",
"positions": "/v1/positions",
"referees": "/v1/referees",
"seasons": "/v1/seasons",
"shotevents": "/v1/shotevents",
"surfaces": "/v1/surfaces",
"teams": "/v1/teams",
"timezones": "/v1/timezones",
"venues": "/v1/venues",
"weather": "/v1/weather"
}
}
}