Service Root¶

The Service Root is the central resource of the Soccermetrics API. From this point you can access all of the publicly-available resources.

GET /v0/¶

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
managers	Managers resource representation.
venues	Match venues resource representation.
weather	Weather conditions resource representation.
penalty_outcomes	Penalty outcomes resource representation.
bodyparts	Body parts resource representation.
surfaces	Playing surfaces resource representation.
competitions	Football competitions resource representation.
shotevents	Shot events resource representations.
referees	Match referees resource representation.
persons	Persons resource representation.
seasons	Seasons resource representation.
confederations	Confederations resource representation.
countries	Countries resource representation.
fouls	Fouls resource representation.
positions	Player positions resource representation.
teams	Teams resource representation.
players	Players resource representation.
cards	Disciplinary cards resource representation.
stats	Match statistics resource representations.
personnel	Match personnel resource representations.
events	Match events resource representations.
matches	Match resource representations.

Example:

GET /v0/ HTTP/1.1
Host: api-summary.soccermetrics.net
Accept: application/json

HTTP/1.1 200 OK
Server: gunicorn/0.15.0
Date: Wed, 02 Apr 2014 05:13:01 GMT
Connection: close
Content-Type: application/json
Content-Length: 3204
Access-Control-Allow-Origin: *

{
  "result": {
    "link": {
      "managers": "/v0/managers",
      "venues": "/v0/venues",
      "weather": "/v0/weather",
      "penaltyOutcomes": "/v0/penalty_outcomes",
      "bodyparts": "/v0/bodyparts",
      "surfaces": "/v0/surfaces",
      "competitions": "/v0/competitions",
      "shotevents": "/v0/shotevents",
      "referees": "/v0/referees",
      "persons": "/v0/persons",
      "seasons": "/v0/seasons",
      "confederations": "/v0/confederations",
      "countries": "/v0/countries",
      "fouls": "/v0/fouls",
      "positions": "/v0/positions",
      "teams": "/v0/teams",
      "players": "/v0/players",
      "cards": "/v0/cards",
      "stats": {
        "setpieces": {
          "corners": "/v0/stats/setpieces/corners",
          "freekicks": "/v0/stats/setpieces/freekicks",
          "throwins": "/v0/stats/setpieces/throwins",
          "keyplays": "/v0/stats/setpieces/keyplays"
        },
        "passes": {
          "directions": "/v0/stats/passes/directions",
          "lengths": "/v0/stats/passes/lengths",
          "locations": "/v0/stats/passes/locations",
          "totals": "/v0/stats/passes/totals"
        },
        "touches": {
          "duels": "/v0/stats/touches/duels",
          "locations": "/v0/stats/touches/locations",
          "totals": "/v0/stats/touches/totals"
        },
        "crosses": {
          "corners": "/v0/stats/crosses/corners",
          "totals": "/v0/stats/crosses/totals"
        },
        "fouls": {
          "cards": "/v0/stats/fouls/cards",
          "wins": "/v0/stats/fouls/wins"
        },
        "defense": {
          "goalline": "/v0/stats/defense/goalline",
          "blocks": "/v0/stats/defense/blocks",
          "tackles": "/v0/stats/defense/tackles",
          "actions": "/v0/stats/defense/actions",
          "clearances": "/v0/stats/defense/clearances"
        },
        "goals": {
          "penalties": "/v0/stats/goals/penalties",
          "bodyparts": "/v0/stats/goals/bodyparts",
          "locations": "/v0/stats/goals/locations",
          "assists": "/v0/stats/goals/assists",
          "totals": "/v0/stats/goals/totals"
        },
        "shots": {
          "bodyparts": "/v0/stats/shots/bodyparts",
          "plays": "/v0/stats/shots/plays",
          "locations": "/v0/stats/shots/locations",
          "totals": "/v0/stats/shots/totals"
        },
        "goalkeeper": {
          "actions": "/v0/stats/goalkeeper/actions",
          "saves": "/v0/stats/goalkeeper/saves",
          "goals": "/v0/stats/goalkeeper/goals",
          "shots": "/v0/stats/goalkeeper/shots"
        }
      },
      "personnel": {
        "players": "/v0/personnel/players",
        "managers": "/v0/personnel/managers",
        "referees": "/v0/personnel/referees"
      },
      "events": {
        "offenses": "/v0/events/offenses",
        "penalties": "/v0/events/penalties",
        "goals": "/v0/events/goals",
        "substitutions": "/v0/events/substitutions"
      },
      "matches": {
        "info": "/v0/matches/info",
        "lineups": "/v0/matches/lineups",
        "conditions": "/v0/matches/conditions"
      }
    }
  }
}