API Reference

The Spapi API is organized around REST. to allow you to interact securely with our API from a client-side web application (though you should remember that you should never expose your secret API key in any public website's client-side code). JSON will be returned in all responses from the API, including errors.

API endpoint

https://spapi.pw/api/v1

Authentication

You authenticate to the Spapi API by providing one of your API keys in the request. You can manage your API keys from your account.

All API requests must be made over HTTPS.

HTTP Status Code Summary

200 - OK Everything worked as expected.
400 - Bad Request Often missing a required parameter.
401 - Unauthorized Your API key is wrong, is no longer valid, or you do not have access to the given resource.
402 - Request Failed Parameters were valid but request failed.
404 - Not Found The requested item doesn't exist.
500, 502, 503, 504 - Server Errors Something went wrong on Spapi.

Competitions

The Competition resource lets you access data about available competitions. You can access competitions' details, upcoming games, finished games, standings and its players' rankings.

Url:
/api/v1/competitions
Attributes
  • per_page integer optional

    A limit on the number of objects to be returned. Limit can range between 1 and 50 items.

  • page integer optional

    An identifier to fetch the nth page of objects.

curl "https://spapi.pw/api/v1/competitions?access_token=[YOUR KEY]"
{
  "total_pages": 10,
  "total_count": 100,
  "current_page": 1,
  "items": [{
    "guid":5,
    "name":"Bundesliga 1",
    "country":"Germany",
    "regions":"de",
    "competition_type":"LEAGUE"
  }]
}

Details

The Competition Details resource lets you access data about a specific league.

Url:
/api/v1/competitions/:guid
Attributes
  • guid integer required

    The identifier of the competition whose details to return.

curl "https://spapi.pw/api/v1/competitions/5?access_token=[YOUR KEY]"
{
  "guid":5,
  "name":"Bundesliga 1",
  "country":"Germany",
  "regions":"de",
  "competition_type":"LEAGUE"
}

Playing Games

The Competition Playing Games resource lets you access data about the competition's games in progress.

Url:
/api/v1/competitions/:guid/playing_matches
Attributes
  • guid integer required

    The identifier of the competition whose details to return.

  • per_page integer optional

    A limit on the number of objects to be returned. Limit can range between 1 and 20 items.

  • page integer optional

    An identifier to fetch the nth page of objects.

curl "https://spapi.pw/api/v1/competitions/5/playing_matches?access_token=[YOUR KEY]"
{
  "total_pages": 10,
  "total_count": 100,
  "current_page": 1,
  "items": [{
    "guid":17100,
    "season":2015,
    "date":"2014-08-30",
    "datetime_of_play":"2014-08-30T11:45:00.000Z",
    "scores_and_stats": null,
    "status":"STARTED",
    "home_season_match_day":3,
    "away_season_match_day":3,
    "competition_id":1,
    "home_team": {
      "guid":33,
      "name":"Burnley",
      "abbreviation_name":"BUR"
    },
    "away_team": {
      "guid":1,
      "name":"Manchester United",
      "abbreviation_name":"MU"
    },
    "livescore_data": {
      "time": "11:45",
      "status": "HT",
      "score": "2 : 0",
      "home_red": 0,
      "away_red": 0,
      "events": [
        [68, 0, "Yannick Bolasie", 10158, "goal"], 
        [89, 0, "Yohan Cabaye", 520, "penalty"]
      ]
    }
  }]
}

Upcoming Games

The Competition Upcoming Games resource lets you access data about the competition's scheduled games.

Url:
/api/v1/competitions/:guid/upcoming_matches
Attributes
  • guid integer required

    The identifier of the competition whose details to return.

  • per_page integer optional

    A limit on the number of objects to be returned. Limit can range between 1 and 20 items.

  • page integer optional

    An identifier to fetch the nth page of objects.

  • start_date string optional

    Starting date of the query range (e.g. 2015-01-01).

  • end_date string optional

    End date of the query range (e.g. 2015-05-01).

curl "https://spapi.pw/api/v1/competitions/5/upcoming_matches?access_token=[YOUR KEY]"
{
  "total_pages": 10,
  "total_count": 100,
  "current_page": 1,
  "items": [{
    "guid":17100,
    "season":2015,
    "date":"2014-08-30",
    "datetime_of_play":"2014-08-30T11:45:00.000Z",
    "scores_and_stats": null,
    "status":"SCHEDULED",
    "home_season_match_day":3,
    "away_season_match_day":3,
    "competition_id":1,
    "home_team": {
      "guid":33,
      "name":"Burnley",
      "abbreviation_name":"BUR"
    },
    "away_team": {
      "guid":1,
      "name":"Manchester United",
      "abbreviation_name":"MU"
    }
  }]
}

Finished Games

The Competition Finished Games resource lets you access data about the league's played games.

Url:
/api/v1/competitions/:guid/finished_matches
Attributes
  • guid integer required

    The identifier of the competition whose details to return.

  • per_page integer optional

    A limit on the number of objects to be returned. Limit can range between 1 and 20 items.

  • page integer optional

    An identifier to fetch the nth page of objects.

  • start_date string optional

    Starting date of the query range (e.g. 2015-01-01).

  • end_date string optional

    End date of the query range (e.g. 2015-05-01).

curl "https://spapi.pw/api/v1/competitions/5/finished_matches?access_token=[YOUR KEY]"
{
  "total_pages": 10,
  "total_count": 100,
  "current_page": 1,
  "items": [{
    "guid":17100,
    "season":2015,
    "date":"2014-08-30",
    "datetime_of_play":"2014-08-30T11:45:00.000Z",
    "scores_and_stats": {
      "status": "ft",
      "scores": {
        "home": 1,
        "away": 0
      },
      "extra": {
        "half": "1 : 0",
        "full": "1 : 0",
        "aet": 0,
        "pen": 0,
        "final": "1 : 0"
      },
      "fl_scores": {
        "home": 1,
        "away": 0
      }
    },
    "status":"FINAL",
    "home_season_match_day":3,
    "away_season_match_day":3,
    "competition_id":1,
    "home_team": {
      "guid":33,
      "name":"Burnley",
      "abbreviation_name":"BUR"
    },
    "away_team": {
      "guid":1,
      "name":"Manchester United",
      "abbreviation_name":"MU"
    }
  }]
}

Groups

The Competition Groups resource lets you access data about the groups in a specific competition.

Url:
/api/v1/competitions/:guid/groups
Attributes
  • guid integer required

    The identifier of the competition whose details to return.

curl "https://spapi.pw/api/v1/competitions/11/groups?access_token=[YOUR KEY]"
["A","B","C"]

Standings

The Competition Standings resource lets you access data about the teams' standings in a specific competition.

Url:
/api/v1/competitions/:guid/standings
Attributes
  • guid integer required

    The identifier of the competition whose details to return.

  • standing_type string optional

    Possible standings types:

    • standings
    • forms_6
    • forms_3
    • streaks_current
    • streaks_season
  • group_name string optional

    In a CUP competition, a group name is required to access the group table. E.g: A

curl "https://spapi.pw/api/v1/competitions/5/standings?access_token=[YOUR KEY]&standing_type=standings"
[{
  "overall_position":1,
  "overall_played":34,
  "overall_wins":25,
  "overall_draws":4,
  "overall_losses":5,
  "overall_goals_for":80,
  "overall_goals_against":18,
  "overall_goals_difference":62,
  "overall_points":79,
  "home_position":1,
  "home_played":17,
  "home_wins":14,
  "home_draws":1,
  "home_losses":2,
  "home_goals_for":46,
  "home_goals_against":7,
  "home_goals_difference":39,
  "home_points":43,
  "away_position":1,
  "away_played":17,
  "away_wins":11,    
  "away_draws":3,
  "away_losses":3,
  "away_goals_for":34,
  "away_goals_against":11,
  "away_goals_difference":23,
  "away_points":36,
  "team_id":108,
  "team_name":"Bayern Munich"
}]

Teams

The Competition Teams resource lets you access data about the competition's teams.

Url:
/api/v1/competitions/:guid/teams
Attributes
  • guid integer required

    The identifier of the competition whose details to return.

  • season integer optional

    The season of the competition.

  • per_page integer optional

    A limit on the number of objects to be returned. Limit can range between 1 and 20 items.

  • page integer optional

    An identifier to fetch the nth page of objects.

curl "https://spapi.pw/api/v1/competitions/5/teams?access_token=[YOUR KEY]"
{
  "total_pages": 1,
  "total_count": 20,
  "current_page": 1,
  "items": [{
    "guid":33,
    "name":"Burnley",
    "abbreviation_name":"BUR"
  },{
    "guid":1,
    "name":"Manchester United",
    "abbreviation_name":"MU"
  }]
}

Player Rankings

Deprecated

The Competition Player Rankings resource lets you access data about the players' rankings in a specific league.

Url:
/api/v1/competitions/:guid/player_rankings
Attributes
  • guid integer required

    The identifier of the competition whose details to return.

  • ranking_type string optional

    Possible player rankings types:

    • offensive
    • defensive
    • passing
    • all
  • per_page integer optional

    A limit on the number of objects to be returned. Limit can range between 1 and 20 items.

  • page integer optional

    An identifier to fetch the nth page of objects.

curl "https://spapi.pw/api/v1/competitions/5/player_rankings?access_token=[YOUR KEY]&ranking_type=all"
{
  "total_pages": 10,
  "total_count": 100,
  "current_page": 1,
  "items": [{
    "name": "Matteo Darmian",
    "guid": 9086,
    "team_id": 1
  }]
}

Top Five

The Competition Top Five resource lets you access data about the top 5 players in a specific league for some important factors.

Url:
/api/v1/competitions/:guid/top_five
Attributes
  • guid integer required

    The identifier of the competition whose details to return.

  • ranking_factor string optional

    Possible player rankings factors:

    • yellow_card
    • red_card
    • appearance
    • assist
    • shots_total
    • shots_per_appearance
    • goals_total
curl "https://spapi.pw/api/v1/competitions/1/top_five?access_token=[YOUR KEY]&ranking_factor=yellow_card"
{
  "total_pages": 1,
  "total_count": 5,
  "current_page": 1,
  "items": [{
    "guid": 9086,
    "name": "Robert Green",
    "team_id": 36,
    "player_id": 616,
    "yellow_card": 0,
    "red_card": 1,
    "appearance": 24,
    "assist": 1,
    "shots_total": 0,
    "shots_per_appearance": 0.0,
    "goals_total": 0
  }]
}

Teams

The Team resource lets you access data about the teams that participate in a specific league. You can access teams' details, rosters, upcoming games, finished games and its players statistics.

Url:
/api/v1/teams
Attributes
  • competition_guid integer required

    The identifier of the competition whose teams to return.

  • season integer optional

    Season of the competition.

  • per_page integer optional

    A limit on the number of objects to be returned. Limit can range between 1 and 50 items.

  • page integer optional

    An identifier to fetch the nth page of objects.

curl "https://spapi.pw/api/v1/teams?access_token=[YOUR KEY]&competition_guid=1"
{
  "total_pages": 10,
  "total_count": 100,
  "current_page": 1,
  "items": [{
    "guid":2,
    "name":"Arsenal",
    "code_name":"Arsenal"
  }]
}

Details

The Team Details resource lets you access data about a specific team. You can obtain its names, players, nicknames, stadia, locations, etc.

Url:
/api/v1/teams/:guid
Attributes
  • guid integer required

    The identifier of the team whose details to return.

curl "https://spapi.pw/api/v1/teams/1?access_token=[YOUR KEY]"
{
  "guid":1,
  "name":"Manchester United",
  "abbreviation_name":"MU",
  "other_possible_names":"Manchester United, Man Utd, manchester united",
  "description":"",
  "additional_info": {
    "nicknames":"the Red Devils",
    "stadium":"Old Trafford",
    "location":"Manchester",
    "coach":"David Moyes"
  }
}

Upcoming Games

The Team Upcoming Games resource lets you access data about the team's scheduled games.

Url:
/api/v1/teams/:guid/upcoming_matches
Attributes
  • guid integer required

    The identifier of the team whose details to return.

  • per_page integer optional

    A limit on the number of objects to be returned. Limit can range between 1 and 20 items.

  • page integer optional

    An identifier to fetch the nth page of objects.

curl "https://spapi.pw/api/v1/teams/1/upcoming_matches?access_token=[YOUR KEY]"
{
  "total_pages": 10,
  "total_count": 100,
  "current_page": 1,
  "items": [{
    "guid":17100,
      "season":2015,
      "date":"2014-08-30",
      "datetime_of_play":"2014-08-30T11:45:00.000Z",
      "scores_and_stats": null,
      "status":"SCHEDULED",
      "home_season_match_day":3,
      "away_season_match_day":3,
      "competition_id":1,
      "home_team": {
        "guid":33,
        "name":"Burnley",
        "abbreviation_name":"BUR"
      },
      "away_team": {
        "guid":1,
        "name":"Manchester United",
        "abbreviation_name":"MU"
      }
  }]
}

Finished Games

The Team Finished Games resource lets you access data about the team's played games.

Url:
/api/v1/teams/:guid/finished_matches
Attributes
  • guid integer required

    The identifier of the team whose details to return.

  • per_page integer optional

    A limit on the number of objects to be returned. Limit can range between 1 and 20 items.

  • page integer optional

    An identifier to fetch the nth page of objects.

curl "https://spapi.pw/api/v1/teams/1/finished_matches?access_token=[YOUR KEY]"
{
  "total_pages": 10,
  "total_count": 100,
  "current_page": 1,
  "items": [{
    "guid":17100,
    "season":2015,
    "date":"2014-08-30",
    "datetime_of_play":"2014-08-30T11:45:00.000Z",
    "scores_and_stats": {
      "status": "ft",
      "scores": {
        "home": 1,
        "away": 0
      },
      "extra": {
        "half": "1 : 0",
        "full": "1 : 0",
        "aet": 0,
        "pen": 0,
        "final": "1 : 0"
      },
      "fl_scores": {
        "home": 1,
        "away": 0
      }
    },
    "status":"FINAL",
    "home_season_match_day":3,
    "away_season_match_day":3,
    "competition_id":1,
    "home_team": {
      "guid":33,
      "name":"Burnley",
      "abbreviation_name":"BUR"
    },
    "away_team": {
      "guid":1,
      "name":"Manchester United",
      "abbreviation_name":"MU"
    }
  }]
}

Player Details

The Team Player Details resource lets you access data about the team's players.

Url:
/api/v1/teams/:guid/player_details
Attributes
  • guid integer required

    The identifier of the team whose details to return.

  • competition_guid integer optional

    The identifier of the competition whose teams to return.

  • per_page integer optional

    A limit on the number of objects to be returned. Limit can range between 1 and 20 items.

  • page integer optional

    An identifier to fetch the nth page of objects.

curl "https://spapi.pw/api/v1/teams/1/player_details?access_token=[YOUR KEY]"
{
  "total_pages": 10,
  "total_count": 100,
  "current_page": 1,
  "items": [{
    "name": "Matteo Darmian",
    "guid": 9086,
    "team_id": 1,
    "appearance": 27,
    "mins_played": 1777,
    "man_of_the_match": 1,
    "position": "DR",
    "ball_recovery": 90,
    "challenge_lost": 22,
    "clearance_total": 41,
    "dispossessed": 16,
    "dribble_lost": 10,
    "dribble_won": 7,
    "duel_aerial_lost": 11,
    "duel_aerial_won": 18,
    "final_third": 362,
    "foul_committed": 24,
    "foul_given": 21,
    "interception_all": 35,
    "pass_key": 10,
    "pass_inaccurate": 158,
    "pass_accurate": 647,
    "possession": 850,
    "yellow_card": 7,
    "tackle_lost": 16,
    "tackle_won": 59,
    "touches": 1209,
    "shot_off_target": 4,
    "shots_total": 4,
    "sub_off": 8,
    "sub_on": 4
  }]
}

Squad

Beta (not stable)

The Team Squad resource lets you access info about the team's current squad.

Url:
/api/v1/teams/:guid/squad
Attributes
  • guid integer required

    The identifier of the team whose details to return.

  • competition_guid integer required

    The identifier of the competition whose teams to return.

curl "https://spapi.pw/api/v1/teams/1/squad?access_token=[YOUR KEY]&competition_guid=1"
{
    "name": "Manchester United",
    "guid": 1,
    "squad": {
        "Goalkeepers": [
            {"name": "Henderson Dean", "jersey": "1", "country": "England"}, 
            {"name": "Pereira Joel", "jersey": "40", "country": "Portugal"}
        ],
        "Midfielders": [
            {"name": "Blind Daley", "jersey": "17", "country": "Netherlands"}, 
            {"name": "Fellaini Marouane", "jersey": "31", "country": "Belgium"}
        ],
        "Forwards": [
            {"name": "Depay Memphis", "jersey": "7", "country": "Netherlands"}, 
            {"name": "Keane Will", "jersey": "48", "country": "England"}
        ], 
        "Coach": [{"name": "Mourinho Jose", "country": "Portugal"}]
    }
}

Statistics

The Team Statistics resource lets you access data about the team's general statistics.

Url:
/api/v1/teams/:guid/statistics
Attributes
  • guid integer required

    The identifier of the team whose details to return.

  • competition_guid integer optional

    The identifier of the competition whose teams to return.

curl "https://spapi.pw/api/v1/teams/1/statistics?access_token=[YOUR KEY]"
{
    "name": "Manchester United",
    "guid": 1,
    "appearance": 27,
    "ball_recovery": 90,
    "challenge_lost": 22,
    "clearance_total": 41,
    "dispossessed": 16,
    "dribble_lost": 10,
    "dribble_won": 7,
    "duel_aerial_lost": 11,
    "duel_aerial_won": 18,
    "final_third": 362,
    "foul_committed": 24,
    "foul_given": 21,
    "interception_all": 35,
    "pass_key": 10,
    "pass_inaccurate": 158,
    "pass_accurate": 647,
    "possession": 850,
    "yellow_card": 7,
    "red_card": 2,    
    "tackle_lost": 16,
    "tackle_won": 59,
    "touches": 1209,
    "shot_off_target": 4,
    "shots_total": 4
}

Historical

Only for Data Plan

The Team Historical resource lets you access data about the team's historical statistics.

Url:
/api/v1/teams/:guid/historical
Attributes
  • guid integer required

    The identifier of the team whose details to return.

  • competition_guid integer required

    The identifier of the competition whose teams to return.

  • season integer optional

    Season of the competition.

curl "https://spapi.pw/api/v1/teams/1/historical?access_token=[YOUR KEY]&competition_guid=1&season=2014"
{
    "name": "Manchester United",
    "guid": 1,
    "appearance": 27,
    "ball_recovery": 90,
    "challenge_lost": 22,
    "clearance_total": 41,
    "dispossessed": 16,
    "dribble_lost": 10,
    "dribble_won": 7,
    "duel_aerial_lost": 11,
    "duel_aerial_won": 18,
    "final_third": 362,
    "foul_committed": 24,
    "foul_given": 21,
    "interception_all": 35,
    "pass_key": 10,
    "pass_inaccurate": 158,
    "pass_accurate": 647,
    "possession": 850,
    "yellow_card": 7,
    "red_card": 2,    
    "tackle_lost": 16,
    "tackle_won": 59,
    "touches": 1209,
    "shot_off_target": 4,
    "shots_total": 4
}

Games

The League resource lets you access data about available leagues. You can access leagues' details, upcoming games, finished games, standings and its players' rankings.

Scores

The Match Scores resource lets you access data about the scores of the game.

Url:
/api/v1/matches/:guid/scores
Attributes
  • guid integer required

    The identifier of the match whose details to return.

curl "https://spapi.pw/api/v1/matches/19263/scores?access_token=[YOUR KEY]"
{
  "status": "ft", 
  "scores": {
    "home": 1, 
    "away": 0
  }, 
  "extra": {
    "half": "1 : 0", 
    "full": "1 : 0", 
    "aet": 0, 
    "pen": 0, 
    "final": "1 : 0"
  },
  "fl_scores": {
    "home": 1, 
    "away": 0
  }
}

Livescores

The Match Livescores resource lets you access data about the live scores of the game.

Url:
/api/v1/matches/:guid/livescores
Attributes
  • guid integer required

    The identifier of the match whose details to return.

curl "https://spapi.pw/api/v1/matches/19263/livescores?access_token=[YOUR KEY]"
{
  "guid":17100,
  "season":2015,
  "date":"2014-08-30",
  "datetime_of_play":"2014-08-30T11:45:00.000Z",
  "status":"STARTED",
  "home_season_match_day":3,
  "away_season_match_day":3,
  "competition_id":1,
  "home_team": {
    "guid":33,
    "name":"Burnley",
    "abbreviation_name":"BUR"
  },
  "away_team": {
    "guid":1,
    "name":"Manchester United",
    "abbreviation_name":"MU"
  },
  "livescore_data": {
    "time": "11:45",
    "status": "HT",
    "score": "2 : 0",
    "home_red": 0,
    "away_red": 0,
    "events": [
      [68, 0, "Yannick Bolasie", 10158, "goal"], 
      [89, 0, "Yohan Cabaye", 520, "penalty"]
    ]
  }
}

Feed

Deprecated

The Match Feed resource lets you access data about the general events in a game. Only available for medium/small coverage. Please use "/api/v1/matches/:guid/events" for big coverage.

Url:
/api/v1/matches/:guid/feed
Attributes
  • guid integer required

    The identifier of the match whose details to return.

curl "https://spapi.pw/api/v1/matches/19263/feed?access_token=[YOUR KEY]"
{
  "guid":17100,
  "season":2015,
  "datetime_of_play":"2014-08-30T11:45:00.000Z",
  "status":"STARTED",
  "competition_id":1,
  "home_team": {
    "guid":33,
    "name":"Burnley",
    "abbreviation_name":"BUR"
  },
  "away_team": {
    "guid":1,
    "name":"Manchester United",
    "abbreviation_name":"MU"
  },
  "match_feed": [
    [1065, "Hossein Baghlani", 0, "penalty-goal", "(1-0)", "Pen.", 54, 33104, 0], 
    [1065, "Hakim Nasari", 0, "goal", "(2-0)", 0, 75, 33105, 0], 
    [1065, "Louis Nganioni", "Valentin Henry", "subst", 0, 0, 77, 4521, 35173],
    [1065, "Mohammad Nosrati", 0, "owngoal", "(3-0)", "OG", 89, 33106, 0]
  ]
}

Status

The Match Status resource lets you access data about the status of the game.

Url:
/api/v1/matches/:guid/status
Attributes
  • guid integer required

    The identifier of the match whose details to return.

curl "https://spapi.pw/api/v1/matches/19263/status?access_token=[YOUR KEY]"
{
  "status": "SCHEDULED"
}

Events

The Match Events resource lets you access data about occuring events during a match.

Url:
/api/v1/matches/:guid/events
Attributes
  • guid integer required

    The identifier of the match whose details to return.

curl "https://spapi.pw/api/v1/matches/19263/events?access_token=[YOUR KEY]"
{
  "players": {
    "12036": "Nikolay Bodurov", 
    "352": "Hugo Rodallega"
  },
  "home_events": [{
    "minute": 53,
    "second": 10,
    "team_id": 32,
    "event_id": 250,
    "start_x": 20.8,
    "start_y": 69.5,
    "expanded_minute": 57,
    "period": {
      "name": "SecondHalf",
      "value": 2
    },
    "type": {
      "name": "Clearance",
      "value": 12
    },
    "outcome_type": {
      "name": "Successful",
      "value": 1
    },
    "qualifiers": [{
      "type": "Head"
    }, {
      "type": "Zone",
      "value": "Back"
    }],
    "is_touch": true
  }, {
    "minute": 88,
    "second": 0,
    "team_id": 259,
    "event_id": 250,    
    "start_x": 22.3,
    "start_y": 10.9,
    "expanded_minute": 92,
    "period": {
      "name": "SecondHalf",
      "value": 2
    },
    "type": {
      "name": "Clearance",
      "value": 12
    },
    "outcome_type": {
      "name": "Successful",
      "value": 1
    },
    "qualifiers": [{
      "type": "Zone",
      "value": "Back"
    }, {
      "type": "Head"
    }],
    "is_touch": true
  }],
  "away_events": []
}

Pre-Match

The Match Pre-Game resource lets you access data about the teams and players before the game begins.

Url:
/api/v1/matches/:guid/pre_match
Attributes
  • guid integer required

    The identifier of the match whose details to return.

curl "https://spapi.pw/api/v1/matches/19263/pre_match?access_token=[YOUR KEY]"
{
  "teams": {
    "home": {
      "general": {
        "all": [{
          "name":"Hertha Berlin",
          "guid":47,
          "games_played":14,
          "goals":19,
          "yellow_cards":31,
          "red_cards":1,
          "total_passes":4930,
          "possession":613.9,
          "accurate_passes":3387,
          "aerial_won":381,
          "aerial_lost":478,
          "rating":6.64,
          "defensive_rating":6.63,
          "offensive_rating":6.53,
          "shots_conceded_inside_box":108,
          "shots_conceded_outside_box":63,
          "total_tackles":277,
          "interceptions":254,
          "fouls":272,
          "was_fouled":218,
          "total_shots":144,
          "shots_blocked":37,
          "shots_on_target":52,
          "dribbles":133,
          "offsides":41,
          "corners":67,
          "throws":357,
          "dispossesed":158
        }]
      }
    }
  },
  "players": {
    "home": {
      "general": {
        "all": [{
          "guid":10794,
          "name":"Rune Jarstein",
          "first_name":"Rune",
          "last_name":"Jarstein",
          "team_id":114,
          "height":190,
          "weight":82,
          "position":"Goalkeeper",
          "short_position":"GK",
          "long_position":"Goalkeeper",
          "age":30,
          "games_started":1,
          "sub_on":0,
          "sub_off":0,
          "yellow_cards":0,
          "red_cards":0,
          "goals":0,
          "assists":0,
          "total_passes":37,
          "accurate_passes":9,
          "aerial_won":1,
          "aerial_lost":0,
          "total_tackles":0,
          "interceptions":0,
          "offsides_won":0,
          "offsides":0,
          "total_clearances":1,
          "fouls":0,
          "was_fouled":1,
          "dribbles":0,
          "was_dribbled":0,
          "total_shots":0,
          "shots_blocked":0,
          "shots_on_target":0,
          "own_goals":0,
          "key_passes":0,
          "dispossesed":0,
          "turnovers":0,
          "total_crosses":0,
          "accurate_crosses":0,
          "total_long_balls":36,
          "accurate_long_balls":8,
          "total_through_balls":0,
          "accurate_through_balls":0,
          "rating":5.53,
          "man_of_the_match":0
        }]
      }
    }
  },
  "fixtures": {
    "home": [["26-09-2015", "15:00", "Southampton", "Swansea", "3 : 1", "1 : 0", "FT", "2015/2016", "Premier League", "EPL"]],
    "away": []
  },
  "previous_meetings": [["26-09-2015", "15:00", "Southampton", "Swansea", "3 : 1", "1 : 0", "FT", "2015/2016", "Premier League", "EPL"]]
}

Post-Match

The Match Post-Game resource lets you access data about the teams and players after the game finishes. It is only available 12 hours after the game finishes.

Url:
/api/v1/matches/:guid/post_match
Attributes
  • guid integer required

    The identifier of the match whose details to return.

curl "https://spapi.pw/api/v1/matches/19263/post_match?access_token=[YOUR KEY]"
{
  "players": {
    "home": [{
      "name": "Marcus Bettinelli",
      "guid": 10673,
      "accurate_passes": 3,
      "challenges_won": 3,
      "formation_place": 1,
      "good_high_claims": 5,
      "saves": 7,
      "touches": 3,
      "aerial_lost": 14,
      "aerial_won": 9,
      "blocked_scoring_attempts": 10,
      "six_yard_blocks": 0,
      "total_passes": 1,
      "total_scoring_attempts": 0,
      "total_tackles": 0,
      "penalties_conceded": 0,
      "goal_assists": 3,
      "man_of_the_match": 1,
      "red_cards": 1,
      "yellow_cards": 1,
      "fouls": 25,
      "attempts_penalty_goal": 1
    }],
    "away": [{
      //...
    }]
  },
  "teams": {
    "home": {
      "accurate_passes": 579,
      "aerial_lost": 17,
      "aerial_won": 31,
      "attempts_goal_low_centre": 1,
      "attempts_goal_low_left": 1,
      "attempts_miss_high": 2,
      "attempts_miss_left": 5,
      "attempts_miss_right": 5,
      "attempts_in_frame_low_centre": 3,
      "attempts_in_frame_low_right": 1,
      "blocked_scoring_attempts": 6,
      "freekick_fouls_lost": 9,
      "goals": 2,
      "on_target_scoring_attempts": 6,
      "possession_percentage": 72.3,
      "shots_off_target": 12,
      "total_offsides": 5,
      "total_passes": 672,
      "total_scoring_attempts": 24,
      "total_tackles": 17,
      "total_throws": 29,
      "challenges_won": 16,
      "won_corners": 11
    },
    "away": {
      //...
    }
  }
}

Odds

The Match Odds resource lets you access data about the available betting odds of the game.

Url:
/api/v1/matches/:guid/odds
Attributes
  • guid integer required

    The identifier of the match whose details to return.

curl "https://spapi.pw/api/v1/matches/24011/odds?access_token=[YOUR KEY]"
{
  "guid": 24011,
  "status": "SCHEDULED",
  "markets": [{
    "category": "match_handicaps",
    "participants": [{
      "name": "T1 -1 goal",
      "full_name": "AFC United -1 goal",
      "code_name": "t1_-1_goal",      
      "decimal_odds": 5.5,
      "american_odds": 450.0,
      "fractional_odds": "11/2",
      "last_update_datetime": "2015-06-12T11:52:56+00:00",
      "probability": 0.18,
      "odds_movement": "same",
      "approx_decimal_odds": 5.21,
      "approx_american_odds": 420.81,
      "approx_fractional_odds": "521/100",
      "approx_probability": 0.19,
      "total_probabilities": 4.50,
      "no_juice_probability": 0.04,
      "no_juice_odds": 23.45
    }],
    "bet_till_datetime": "2015-06-15T18:00:00+00:00",
    "last_update_datetime": "2015-06-12T11:52:55+00:00",
    "participants_number": 12,
    "overround": 3.50
  }]
}

In-Match Info

The Match In-Game resource lets you access data about the teams and players general information during/after the game.

Url:
/api/v1/matches/:guid
Attributes
  • guid integer required

    The identifier of the match whose details to return.

curl "https://spapi.pw/api/v1/matches/19263?access_token=[YOUR KEY]"
{
  "players": {
    "home": [{
      "name": "Marcus Bettinelli",
      "guid": 10673,
      "accurate_passes": 3,
      "challenges_won": 3,
      "formation_place": 1,
      "good_high_claims": 5,
      "saves": 7,
      "touches": 3,
      "aerial_lost": 14,
      "aerial_won": 9,
      "blocked_scoring_attempts": 10,
      "six_yard_blocks": 0,
      "total_passes": 1,
      "total_scoring_attempts": 0,
      "total_tackles": 0,
      "penalties_conceded": 0,
      "goal_assists": 3,
      "man_of_the_match": 1,
      "red_cards": 1,
      "yellow_cards": 1,
      "fouls": 25,
      "attempts_penalty_goal": 1
    }],
    "away": [{
      //...
    }]
  },
  "teams": {
    "home": {
      "accurate_passes": 579,
      "aerial_lost": 17,
      "aerial_won": 31,
      "attempts_goal_low_centre": 1,
      "attempts_goal_low_left": 1,
      "attempts_miss_high": 2,
      "attempts_miss_left": 5,
      "attempts_miss_right": 5,
      "attempts_in_frame_low_centre": 3,
      "attempts_in_frame_low_right": 1,
      "blocked_scoring_attempts": 6,
      "freekick_fouls_lost": 9,
      "goals": 2,
      "on_target_scoring_attempts": 6,
      "possession_percentage": 72.3,
      "shots_off_target": 12,
      "total_offsides": 5,
      "total_passes": 672,
      "total_scoring_attempts": 24,
      "total_tackles": 17,
      "total_throws": 29,
      "challenges_won": 16,
      "won_corners": 11
    },
    "away": {
      //...
    }
  }
}

In-Match Statistics

The Match In-Game Statistics resource lets you access data about the teams and players statistics during/after the game.

Url:
/api/v1/matches/:guid/statistics
Attributes
  • guid integer required

    The identifier of the match whose details to return.

curl "https://spapi.pw/api/v1/matches/19263/statistics?access_token=[YOUR KEY]"
{
  "players": {
    "home": [{
      "name": "Taison",
      "guid": 15805,
      "mins_played": 81,
      "ball_recovery": 1,
      "corner_awarded": 2,
      "defensive_third": 9,
      "dribble_lost": 3,
      "dribble_won": 1,
      "duel_aerial_lost": 1,
      "final_third": 20,
      "foul_committed": 3,
      "foul_given": 2,
      "key_pass_corner": 1,
      "key_pass_cross": 1,
      "key_pass_long": 1,
      "key_pass_other": 2,
      "key_pass_short": 2,
      "mid_third": 19,
      "offensive_duel": 1,
      "outfielder_blocked_pass": 1,
      "pass_accurate": 37,
      "pass_back": 23,
      "pass_back_zone_inaccurate": 1,
      "pass_chipped": 6,
      "pass_corner": 5,
      "pass_corner_accurate": 1,
      "pass_corner_inaccurate": 4,
      "pass_cross_accurate": 1,
      "pass_cross_blocked_defensive": 3,
      "pass_cross_inaccurate": 4,
      "pass_forward": 22,
      "pass_forward_zone_accurate": 25,
      "pass_freekick": 5,
      "pass_freekick_accurate": 2,
      "pass_inaccurate": 3,
      "pass_key": 3,
      "pass_left": 15,
      "pass_long_ball_accurate": 3,
      "pass_right": 30,
      "short_pass_accurate": 34,
      "short_pass_inaccurate": 3,
      "shot_blocked": 1,
      "shot_left_foot": 1,
      "shot_open_play": 1,
      "shot_penalty_area": 1,
      "shots_total": 1,
      "sub_off": 1,
      "successful_final_third_passes": 13,
      "tackle_won": 1,
      "touches": 58
    }],
    "away": [{
      //...
    }]
  },
  "teams": {
    "home": {
      "accurate_passes": 579,
      "aerial_lost": 17,
      "aerial_won": 31,
      "attempts_goal_low_centre": 1,
      "attempts_goal_low_left": 1,
      "attempts_miss_high": 2,
      "attempts_miss_left": 5,
      "attempts_miss_right": 5,
      "attempts_in_frame_low_centre": 3,
      "attempts_in_frame_low_right": 1,
      "blocked_scoring_attempts": 6,
      "freekick_fouls_lost": 9,
      "goals": 2,
      "on_target_scoring_attempts": 6,
      "possession_percentage": 72.3,
      "shots_off_target": 12,
      "total_offsides": 5,
      "total_passes": 672,
      "total_scoring_attempts": 24,
      "total_tackles": 17,
      "total_throws": 29,
      "challenges_won": 16,
      "won_corners": 11
    },
    "away": {
      //...
    }
  }
}

In-Match Details

The Match In-Game Details resource lets you access data about detailed statistics on a game.

Url:
/api/v1/matches/:guid/details
Attributes
  • guid integer required

    The identifier of the match whose details to return.

curl "https://spapi.pw/api/v1/matches/19263/details?access_token=[YOUR KEY]"
{
  "referee_name": "Andy Haines",
  "attendance": 15512,
  "stadium": "Craven Cottage",
  "weather": "clear",
  "start_time": "01/21/2015 19:45:00",
  "score": "3 : 2",
  "half_time_score": "3 : 1",
  "full_time_score": "",
  "extra_time_score": "",
  "penalty_score": "",
  "max_minute": 93,
  "expanded_minutes": {},
  "expanded_max_minute": 96,
  "period_end_minutes": {
    "1": 47,
    "2": 93
  },
  "time_out_in_seconds": 30,
  "home": {
    "guid": 170,
    "name": "Fulham",
    "manager": "Kit Symons",
    "score": {
      "halftime": 3,
      "running": 3
    },
    "field": "home",
    "average_age": 24.1,
    "stats": {
      "minute_with_stats": [],
      "rating": {
        "0": "6.00636363636364",
        "1": "6.01181818181818"
        // ...
      },
      "total_shots": {},
      "shots_on_target": {},
      "shots_off_target": {},
      "shots_blocked": {},
      "possession": {},
      "total_passes": {},
      "accurate_passes": {},
      "accurate_passes_percent": {},
      "total_aerial": {},
      "aerial_won": {},
      "success_aerial": {},
      "offensive_aerial": {},
      "defensive_aerial": {},
      "total_corners": {},
      "accurate_corners": {},
      "total_throw_in": {},
      "accurate_throw_in": {},
      "throw_in_accuracy": {},
      "offside_caught": {},
      "fouls": {},
      "total_tackles": {},
      "successful_tackles": {},
      "unsuccesful_tackles": {},
      "successful_tackles_percent": {},
      "dribbled_past": {},
      "dribbles_won": {},
      "dribbles_attempted": {},
      "dribbles_lost": {},
      "successful_dribbles_percent": {}
      // ...
    },
    "formations": [{
      "formation_name": "41212",
      "captain_id": 270,
      "period": 16,
      "start_minute_expanded": 0,
      "end_minute_expanded": 59,
      "player_guids": [],
      "formation_positions": [{
        "vertical": 0.0,
        "horizontal": 5.0
      } // ...
      ]
    }],
    "players": [{
      "guid": 135768,
      "shirt_number": 40,
      "name": "Marcus Bettinelli",
      "position": "GK",
      "height": 194,
      "weight": 82,
      "age": 22,
      "is_first_eleven": true,
      "is_man_of_the_match": false,
      "field": "home",
      "possession": {},
      "total_passes": {},
      "accurate_passes": {},
      "accurate_passes_percent": {},
      "total_aerial": {},
      "aerial_won": {},
      "defensive_aerial": {}
      // ...
    }]
  },
  "away": {}
}

In-Match Actions

The Match In-Game Actions resource lets you access data about every single actions in a game.

Url:
/api/v1/matches/:guid/actions
Attributes
  • guid integer required

    The identifier of the match whose details to return.

curl "https://spapi.pw/api/v1/matches/19263/actions?access_token=[YOUR KEY]"
{
  "players": {
    "12036": "Nikolay Bodurov", 
    "352": "Hugo Rodallega"
  },
  "actions": [{
    "minute": 53,
    "second": 10,
    "team_id": 32,
    "start_x": 20.8,
    "start_y": 69.5,
    "expanded_minute": 57,
    "period": {
      "name": "SecondHalf",
      "value": 2
    },
    "type": {
      "name": "Clearance",
      "value": 12
    },
    "outcome_type": {
      "name": "Successful",
      "value": 1
    },
    "qualifiers": [{
      "type": "Head"
    }, {
      "type": "Zone",
      "value": "Back"
    }],
    "is_touch": true
  }, {
    "minute": 88,
    "second": 0,
    "team_id": 259,
    "start_x": 22.3,
    "start_y": 10.9,
    "expanded_minute": 92,
    "period": {
      "name": "SecondHalf",
      "value": 2
    },
    "type": {
      "name": "Clearance",
      "value": 12
    },
    "outcome_type": {
      "name": "Successful",
      "value": 1
    },
    "qualifiers": [{
      "type": "Zone",
      "value": "Back"
    }, {
      "type": "Head"
    }],
    "is_touch": true
  }]
}

Odds

The Odds resource lets you access data about available odds. You can access pre-game odds or in-play odds.

Pre-Game

The Pre-Game Odds resource lets you access data about odds before the game starts.

Url:
/api/v1/odds?live=false
Attributes
  • guid integer required

    The identifier of the competition whose odds to return.

  • live boolean optional

    A Boolean indicating whether the games are live or not.

  • per_page integer optional

    A limit on the number of objects to be returned. Limit can range between 1 and 20 items.

  • page integer optional

    An identifier to fetch the nth page of objects.

curl "https://spapi.pw/api/v1/odds?guid=1&live=false&access_token=[YOUR KEY]"
[{
  "guid": 24011,
  "status": "SCHEDULED",
  "markets": [{
    "category": "match_handicaps",
    "participants": [{
      "name": "T1 -1 goal",
      "full_name": "AFC United -1 goal",
      "code_name": "t1_-1_goal",      
      "decimal_odds": 5.5,
      "american_odds": 450.0,
      "fractional_odds": "11/2",
      "last_update_datetime": "2015-06-12T11:52:56+00:00",
      "probability": 0.18,
      "odds_movement": "same",
      "approx_decimal_odds": 5.21,
      "approx_american_odds": 420.81,
      "approx_fractional_odds": "521/100",
      "approx_probability": 0.19,
      "total_probabilities": 4.50,
      "no_juice_probability": 0.04,
      "no_juice_odds": 23.45
    }
    // {...}
    ],
    "bet_till_datetime": "2015-06-15T18:00:00+00:00",
    "last_update_datetime": "2015-06-12T11:52:55+00:00",
    "participants_number": 12,
    "overround": 3.50
  }
  // {...}
  ]
}]

In-Play

The In-Play Odds resource lets you access data about odds during an ongoing game.

Url:
/api/v1/odds?live=true
Attributes
  • guid integer required

    The identifier of the competition whose odds to return.

  • live boolean optional

    A Boolean indicating whether the games are live or not.

  • per_page integer optional

    A limit on the number of objects to be returned. Limit can range between 1 and 20 items.

  • page integer optional

    An identifier to fetch the nth page of objects.

curl "https://spapi.pw/api/v1/odds?guid=1&live=true&access_token=[YOUR KEY]"
[{
  "guid": 24011,
  "status": "SCHEDULED",
  "markets": [{
    "category": "match_handicaps",
    "participants": [{
      "name": "T1 -1 goal",
      "full_name": "AFC United -1 goal",
      "code_name": "t1_-1_goal",      
      "decimal_odds": 5.5,
      "american_odds": 450.0,
      "fractional_odds": "11/2",
      "last_update_datetime": "2015-06-12T11:52:56+00:00",
      "probability": 0.18,
      "odds_movement": "same",
      "approx_decimal_odds": 5.21,
      "approx_american_odds": 420.81,
      "approx_fractional_odds": "521/100",
      "approx_probability": 0.19,
      "total_probabilities": 4.50,
      "no_juice_probability": 0.04,
      "no_juice_odds": 23.45
    }
    // {...}
    ],
    "bet_till_datetime": "2015-06-15T18:00:00+00:00",
    "last_update_datetime": "2015-06-12T11:52:55+00:00",
    "participants_number": 12,
    "overround": 3.50
  }
  // {...}
  ]
}]

Livescores

The Livescores resource lets you access data about live games. You can access livescores and important live events of the in-play games.

Url:
/api/v1/livescores
curl "https://spapi.pw/api/v1/livescores?access_token=[YOUR KEY]"
{
  "competitions": {
    "149": ["gb-eng", "England", "EC", "Championship"]
  },
  "matches": {
    "149": [ 
      [0, "23:30", "1 : 1", "FT", "Atletico Tucuman", 0, "Union de Mar del Plata", 0, [
        [12, 0, "Leandro Diaz", 0, "goal"],
        [39, 1, "Nahuel Santos", 0, "goal"]
      ]]
    ]
  }
}

Players

The Players resource lets you access data about a specific player. You can access his information, statistics.

Info

The Player Info resource lets you access information about a player.

Url:
/api/v1/players/:guid
Attributes
  • guid integer required

    The identifier of the player whose details to return.

curl "https://spapi.pw/api/v1/players/1?access_token=[YOUR KEY]"
{
  "guid": 1,
  "first_name": "Abou",
  "last_name": "Diabi",
  "name": "Abou Diaby", 
  "position": "M"
}

Statistics

The Player Statistics resource lets you access information about a player.

Url:
/api/v1/players/:guid/statistics
Attributes
  • guid integer required

    The identifier of the player whose details to return.

curl "https://spapi.pw/api/v1/players/1/statistics?access_token=[YOUR KEY]"
{
  "name": "Héctor Bellerín",
  "guid": 7,
  "team_id": 2,
  "appearance": 30,
  "mins_played": 2924,
  "man_of_the_match": 1,
  "position": "DR",
  "assist": 4,
  "assist_other": 3,
  "assist_throughball": 1,
  "ball_recovery": 145,
  "big_chance_created": 9,
  "challenge_lost": 20,
  "clean_sheet_dr": 11,
  "clearance_effective": 57,
  "clearance_head": 31,
  "clearance_total": 76,
  "close_miss_right": 1,
  "corner_awarded": 42,
  "defensive_duel": 48,
  "defensive_third": 373,
  "dispossessed": 38,
  "dribble_lost": 25,
  "dribble_won": 53,
  "duel_aerial_lost": 28,
  "duel_aerial_won": 32,
  "final_third": 630,
  "foul_committed": 14,
  "foul_given": 7,
  "goal_left_foot": 1,
  "goal_normal": 1,
  "goal_open_play": 1,
  "goal_penalty_area": 1,
  "goal_scored_by_team_dr": 36,
  "intentional_assist": 4,
  "interception_all": 54,
  "interception_inthe_box": 8,
  "interception_won": 54,
  "keeper_sweeper_lost": 0,
  "key_pass_cross": 7,
  "key_pass_long": 3,
  "key_pass_other": 11,
  "key_pass_short": 18,
  "key_pass_throughball": 3,
  "mid_third": 816,
  "offensive_duel": 12,
  "offside_given": 1,
  "offside_provoked": 1,
  "outfielder_block": 7,
  "outfielder_blocked_pass": 25,
  "overrun": 11,
  "pass_accurate": 1187,
  "pass_back": 770,
  "pass_back_zone_inaccurate": 74,
  "pass_chipped": 133,
  "pass_cross_accurate": 15,
  "pass_cross_blocked_defensive": 17,
  "pass_cross_inaccurate": 77,
  "pass_forward": 942,
  "pass_forward_zone_accurate": 695,
  "pass_freekick_accurate": 20,
  "pass_freekick_inaccurate": 1,
  "pass_head": 81,
  "pass_inaccurate": 202,
  "pass_key": 21,
  "pass_left": 1395,
  "pass_long_ball_accurate": 31,
  "pass_long_ball_inaccurate": 31,
  "pass_right": 306,
  "pass_through_ball_accurate": 4,
  "pass_through_ball_inaccurate": 2,
  "penalty_missed": 0,
  "penalty_shootout_missed_off_target": 0,
  "penalty_shootout_saved": 0,
  "penalty_shootout_scored": 0,
  "possession": 1481,
  "short_pass_accurate": 1156,
  "short_pass_inaccurate": 172,
  "shot_blocked": 4,
  "shot_head": 1,
  "shot_left_foot": 2,
  "shot_off_target": 2,
  "shot_off_target_inside_box": 1,
  "shot_on_target": 3,
  "shot_open_play": 9,
  "shot_penalty_area": 7,
  "shot_right_foot": 6,
  "shots_total": 9,
  "successful_final_third_passes": 386,
  "tackle_lost": 9,
  "tackle_won": 41,
  "throw_in": 244,
  "touches": 1949,
  "turnover": 27,
  "yellow_card": 2
}

Historical

Only for Data Plan

The Player Historical resource lets you access information about a player's historical statistics.

Url:
/api/v1/players/:guid/historical
Attributes
  • guid integer required

    The identifier of the player whose details to return.

  • competition_guid integer required

    The identifier of the competition whose players to return.

  • team_guid integer required

    The identifier of the team whose players to return.

  • season integer optional

    Season of the competition.

curl "https://spapi.pw/api/v1/players/1/historical?access_token=[YOUR KEY]&competition_guid=1&season=2014&team_guid=1"
{
  "name": "Héctor Bellerín",
  "guid": 7,
  "team_id": 2,
  "appearance": 30,
  "mins_played": 2924,
  "man_of_the_match": 1,
  "position": "DR",
  "assist": 4,
  "assist_other": 3,
  "assist_throughball": 1,
  "ball_recovery": 145,
  "big_chance_created": 9,
  "challenge_lost": 20,
  "clean_sheet_dr": 11,
  "clearance_effective": 57,
  "clearance_head": 31,
  "clearance_total": 76,
  "close_miss_right": 1,
  "corner_awarded": 42,
  "defensive_duel": 48,
  "defensive_third": 373,
  "dispossessed": 38,
  "dribble_lost": 25,
  "dribble_won": 53,
  "duel_aerial_lost": 28,
  "duel_aerial_won": 32,
  "final_third": 630,
  "foul_committed": 14,
  "foul_given": 7,
  "goal_left_foot": 1,
  "goal_normal": 1,
  "goal_open_play": 1,
  "goal_penalty_area": 1,
  "goal_scored_by_team_dr": 36,
  "intentional_assist": 4,
  "interception_all": 54,
  "interception_inthe_box": 8,
  "interception_won": 54,
  "keeper_sweeper_lost": 0,
  "key_pass_cross": 7,
  "key_pass_long": 3,
  "key_pass_other": 11,
  "key_pass_short": 18,
  "key_pass_throughball": 3,
  "mid_third": 816,
  "offensive_duel": 12,
  "offside_given": 1,
  "offside_provoked": 1,
  "outfielder_block": 7,
  "outfielder_blocked_pass": 25,
  "overrun": 11,
  "pass_accurate": 1187,
  "pass_back": 770,
  "pass_back_zone_inaccurate": 74,
  "pass_chipped": 133,
  "pass_cross_accurate": 15,
  "pass_cross_blocked_defensive": 17,
  "pass_cross_inaccurate": 77,
  "pass_forward": 942,
  "pass_forward_zone_accurate": 695,
  "pass_freekick_accurate": 20,
  "pass_freekick_inaccurate": 1,
  "pass_head": 81,
  "pass_inaccurate": 202,
  "pass_key": 21,
  "pass_left": 1395,
  "pass_long_ball_accurate": 31,
  "pass_long_ball_inaccurate": 31,
  "pass_right": 306,
  "pass_through_ball_accurate": 4,
  "pass_through_ball_inaccurate": 2,
  "penalty_missed": 0,
  "penalty_shootout_missed_off_target": 0,
  "penalty_shootout_saved": 0,
  "penalty_shootout_scored": 0,
  "possession": 1481,
  "short_pass_accurate": 1156,
  "short_pass_inaccurate": 172,
  "shot_blocked": 4,
  "shot_head": 1,
  "shot_left_foot": 2,
  "shot_off_target": 2,
  "shot_off_target_inside_box": 1,
  "shot_on_target": 3,
  "shot_open_play": 9,
  "shot_penalty_area": 7,
  "shot_right_foot": 6,
  "shots_total": 9,
  "successful_final_third_passes": 386,
  "tackle_lost": 9,
  "tackle_won": 41,
  "throw_in": 244,
  "touches": 1949,
  "turnover": 27,
  "yellow_card": 2
}

Glossary

Definitions of terms and category types used.

Statuses
  • SCHEDULED

    Match is still scheduled, not started yet

  • CANCELED

    Match is canceled

  • POSTPONED

    Match is postponed to another date

  • ABANDONED

    Match is abandoned

  • FINAL

    Match is finished and the scores are final

  • WAITING

    Match is in process of finishing, waiting for final data

  • STARTED

    Match has started or about to start

Positions
  • GK

    Goalkeeper

  • DL

    Defender Left

  • DC

    Defender Center

  • DR

    Defender Right

  • DML

    Defensive Midfielder Left

  • DMC

    Defensive Midfielder Center

  • DMR

    Defensive Midfielder Right

  • ML

    Midfiled Left

  • MC

    Midfiled Center

  • MR

    Midfiled Right

  • AML

    Attacking Midfielder Left

  • AMC

    Attacking Midfielder Center

  • AMR

    Attacking Midfielder Right

  • FWL

    Forward Left

  • FW

    Forward

  • FWR

    Forward Right

  • Sub

    Substitute

Injury reasons
  • ineligible

    tbd

  • injured

    tbd

  • injured doubtful

    tbd

  • international duty

    tbd

  • other

    tbd

  • suspended

    tbd

  • unfit

    tbd

Injury statuses
  • Doubtful

    tbd

  • Out

    tbd

Attributes
  • aerial_success

    Winning a header in a direct contest with an opponent.

  • assist

    A pass that directly leads to a chance scored by a teammate.

  • assist_corner

    Assist from a corner

  • assist_cross

    Assist from a cross

  • assist_freekick

    Assist from a freekick

  • assist_other

    Other types of assists

  • assist_throughball

    Assist from a throughball

  • assist_throwin

    Assist from a throw in

  • ball_recovery

    Number of ball possessions recovered.

  • big_chance_created

    A big scoring occasion created

  • big_chance_missed

    A big scoring occasion missed

  • big_chance_scored

    A big scoring occasion transformed successfully into a goal

  • challenge_lost

    Duel (Aerial or Ground) lost to an oppenent.

  • clean_sheet_amc

    Clean sheet as AMC

  • clean_sheet_aml

    Clean sheet as AML

  • clean_sheet_amr

    Clean sheet as AMR

  • clean_sheet_dc

    Clean sheet as DC

  • clean_sheet_dl

    Clean sheet as DL

  • clean_sheet_dmc

    Clean sheet as DMC

  • clean_sheet_dml

    Clean sheet as DML

  • clean_sheet_dmr

    Clean sheet as DMR

  • clean_sheet_dr

    Clean sheet as DR

  • clean_sheet_fw

    Clean sheet as FW

  • clean_sheet_fwl

    Clean sheet as FWL

  • clean_sheet_fwr

    Clean sheet as FWR

  • clean_sheet_gk

    Clean sheet as GK

  • clean_sheet_mc

    Clean sheet as MC

  • clean_sheet_ml

    Clean sheet as ML

  • clean_sheet_mr

    Clean sheet as MR

  • clean_sheet_sub

    Clean sheet as SUB

  • clearance_effective

    Successful action by a defending player that temporarily removes the attacking threat on their goal/that effectively alleviates pressure on their goal.

  • clearance_head

    A clearance with the head

  • clearance_off_the_line

    A clearance off the line

  • clearance_total

    Total number of clearances

  • close_miss_high

    A miss from close range targeted to high of pitch

  • close_miss_high_left

    A miss from close range targeted to high-left of pitch

  • close_miss_high_right

    A miss from close range targeted to high-right of pitch

  • close_miss_left

    A miss from close range targeted to the left of pitch

  • close_miss_right

    A miss from close range targeted to the right of pitch

  • corner_awarded

    Corner awarded

  • defensive_duel

    A defensive duel

  • defensive_third

    In the defensive third

  • dispossessed

    Being tackled by an opponent without attempting to dribble past them.

  • dribble_lastman

    Taking on the last opponent and successfully making it past them whilst retaining the ball.

  • dribble_lost

    A lost dribble

  • dribble_won

    A successful challenge as a dribble

  • duel_aerial_lost

    Losing a header in a direct contest with an opponent.

  • duel_aerial_won

    Winning a header in a direct contest with an opponent.

  • error_leads_to_goal

    An error that leads to the opponents scoring a goal

  • error_leads_to_shot

    An error that leads to the opponents having a shot at the goal

  • final_third

    Entries into the final 1/3 zone

  • foul_committed

    An illegal manoeuvre by a player that results in a free kick for the opposing team (does not include offsides).

  • foul_given

    A foul given

  • goal_conceded_by_team_amc

    Goal conceded as AMC

  • goal_conceded_by_team_aml

    Goal conceded as AML

  • goal_conceded_by_team_amr

    Goal conceded as AMR

  • goal_conceded_by_team_dc

    Goal conceded as DC

  • goal_conceded_by_team_dl

    Goal conceded as DL

  • goal_conceded_by_team_dmc

    Goal conceded as DMC

  • goal_conceded_by_team_dml

    Goal conceded as DML

  • goal_conceded_by_team_dmr

    Goal conceded as DMR

  • goal_conceded_by_team_dr

    Goal conceded as DR

  • goal_conceded_by_team_fw

    Goal conceded as FW

  • goal_conceded_by_team_fwl

    Goal conceded as FWL

  • goal_conceded_by_team_fwr

    Goal conceded as FWR

  • goal_conceded_by_team_gk

    Goal conceded as GK

  • goal_conceded_by_team_mc

    Goal conceded as MC

  • goal_conceded_by_team_ml

    Goal conceded as ML

  • goal_conceded_by_team_mr

    Goal conceded as MR

  • goal_conceded_by_team_sub

    Goal conceded as SUB

  • goal_conceded_outside_box_goalkeeper

    Goal conceded by the goalkeeper outside of the box

  • goal_counter

    A goal scored from a counter

  • goal_head

    A goal scored with a head

  • goal_left_foot

    A goal scored with the left foot

  • goal_normal

    A normal goal

  • goal_open_play

    A goal scored during open play

  • goal_own

    An own goal

  • goal_penalty_area

    A goal scored in the penalty area

  • goal_right_foot

    A goal scored with the right foot

  • goal_scored_by_team_amc

    Goal scored as AMC

  • goal_scored_by_team_aml

    Goal scored as AML

  • goal_scored_by_team_amr

    Goal scored as AMR

  • goal_scored_by_team_dc

    Goal scored as DC

  • goal_scored_by_team_dl

    Goal scored as DL

  • goal_scored_by_team_dmc

    Goal scored as DMC

  • goal_scored_by_team_dml

    Goal scored as DML

  • goal_scored_by_team_dmr

    Goal scored as DMR

  • goal_scored_by_team_dr

    Goal scored as DR

  • goal_scored_by_team_fw

    Goal scored as FW

  • goal_scored_by_team_fwl

    Goal scored as FWL

  • goal_scored_by_team_fwr

    Goal scored as FWR

  • goal_scored_by_team_gk

    Goal scored as GK

  • goal_scored_by_team_mc

    Goal scored as MC

  • goal_scored_by_team_ml

    Goal scored as ML

  • goal_scored_by_team_mr

    Goal scored as MR

  • goal_scored_by_team_sub

    Goal scored as SUB

  • goal_set_piece

    Goal scored from a set piece

  • goal_six_yard_box

    Goal scored in six yard box

  • intentional_assist

    Intentional assist

  • interception_all

    Preventing an opponent's pass from reaching their teammates.

  • interception_inthe_box

    Interceptions in the box

  • interception_won

    Interceptions won

  • keeper_claim_high_lost

    Unsuccessful keeper claim of a high ball.

  • keeper_claim_high_won

    Successful keeper claim of a high ball.

  • keeper_claim_lost

    Unsuccessful keeper claim of a ball.

  • keeper_claim_won

    Successful keeper claim of a ball.

  • keeper_diving_save

    Keeper diving save

  • keeper_missed

    Keeper missed save

  • keeper_one_to_one_won

    Keeper one to one won

  • keeper_penalty_saved

    Penalties saved by keeper

  • keeper_save_in_the_box

    Saves of the keeper in the box

  • keeper_save_total

    Total saves of the keeper

  • keeper_smother

    Smother save by the keeper

  • keeper_sweeper_lost

    The sweeper is a defensive position in football, so called because their job is to 'sweep up' any attacking moves which pass other defenders.

  • key_pass_corner

    Key pass from a corner

  • key_pass_cross

    Key pass from a cross

  • key_pass_freekick

    Key pass from a freekick

  • key_pass_long

    Key pass from a long ball

  • key_pass_other

    Key pass from other types

  • key_pass_short

    Key pass from a short ball

  • key_pass_throughball

    Key pass from a throughball

  • key_pass_throwin

    Key pass from a throw-in

  • mid_third

    The 1/3 of the soccer field containing the Halfway Line & Center Circle.

  • offensive_duel

    An offensive duel

  • offside_given

    Offside given

  • offside_provoked

    Offside provoked

  • outfielder_block

    Prevention by an outfield player.

  • outfielder_blocked_pass

    Prevention by an outfield player.

  • overrun

    Spread rapidly throughout the opposition.

  • parried_danger

    Parried Danger area save

  • parried_safe

    Parried safe save

  • pass_accuracy

    Accuracy percentage of passes

  • pass_accurate

    Accurate pass

  • pass_back

    Pass back zone

  • pass_back_zone_inaccurate

    Inaccurate pass back zone

  • pass_chipped

    Chipped pass

  • pass_corner

    Pass from a corner

  • pass_corner_accurate

    Accurate pass from a corner

  • pass_corner_inaccurate

    Inaccurate pass from a corner

  • pass_cross_accurate

    Accurate pass from a cross

  • pass_cross_blocked_defensive

    Pass from a cross blocked by the defense

  • pass_cross_inaccurate

    Inaccurate pass from a cross

  • pass_forward

    A pass forward

  • pass_forward_zone_accurate

    Accurate pass forward

  • pass_freekick

    Pass from a freekick

  • pass_freekick_accurate

    Accurate pass from a freekick

  • pass_freekick_inaccurate

    Inaccurate pass from a freekick

  • pass_head

    Pass with the head

  • pass_inaccurate

    Inaccurate pass

  • pass_key

    A key pass

  • pass_left

    A pass to the left

  • pass_left_foot

    A pass with the left foot

  • pass_long_ball_accurate

    Accurate pass from a long ball

  • pass_long_ball_inaccurate

    Inaccurate pass from a long ball

  • pass_right

    A pass to the right

  • pass_right_foot

    A pass with the right foot

  • pass_through_ball_accurate

    Accurate pass from a throughball

  • pass_through_ball_inaccurate

    Inaccurate pass from a throughball

  • pass_through_ball_inacurate

    Inaccurate pass from a throughball

  • penalty_conceded

    Penalty conceded

  • penalty_missed

    Penalty missed

  • penalty_scored

    Penalty scored

  • penalty_shootout_conceded_gk

    Penalty shootout conceded by goalkeeper

  • penalty_shootout_missed_off_target

    Penalty shootout missed and off target

  • penalty_shootout_saved

    Penalty shootout saved

  • penalty_shootout_saved_gk

    Penalty shootout saved by goalkeeper

  • penalty_shootout_scored

    Penalty shootout scored

  • penalty_won

    Penalty won

  • possession

    Possession

  • punches

    Punches

  • red_card

    Red card

  • save_feet

    Save with the feet

  • save_hands

    Save with the hands

  • save_high_centre

    Save from high centre

  • save_high_left

    Save from high left

  • save_high_right

    Save from high right

  • save_low_centre

    Save from low centre

  • save_low_left

    Save from low left

  • save_low_right

    Save from low right

  • save_penalty_area

    Save in penalty area

  • save_six_yard_box

    Save in six yard box

  • second_yellow

    Second yellow card

  • short_pass_accurate

    Accurate short pass

  • short_pass_inaccurate

    Inaccurate short pass

  • shot_blocked

    Shot blocked

  • shot_counter

    Shot from a counter

  • shot_head

    Shot as a header

  • shot_left_foot

    Shot with left foot

  • shot_off_target

    Shot off target

  • shot_off_target_inside_box

    Shot off target inside box

  • shot_on_post

    Shot on post

  • shot_on_target

    Shot on target

  • shot_open_play

    Shot from open play

  • shot_penalty_area

    Shot in penalty area

  • shot_right_foot

    Shot with right foot

  • shot_set_piece

    Shot from set piece

  • shot_six_yard_box

    Shot in six yard box

  • shots_total

    Total number of shots

  • six_yard_block

    Block in six yard box

  • standing_save

    A standing save

  • sub_off

    Substitution off

  • sub_on

    Substitution on

  • successful_final_third_passes

    Successful passes in final third

  • tackle_last_man

    Tackle by last man

  • tackle_lost

    Tackle lost

  • tackle_won

    Tackle won

  • throw_in

    Throw-in

  • touches

    Touches

  • turnover

    Turnover

  • void_yellow_card

    Void yellow card

  • yellow_card

    Yellow card

Disclaimer: Although every possible effort is made to ensure the accuracy of our services we accept no responsibility for any kind of use made of any kind of data and information provided by this site.