Player Endpoints - SportsAPI Pro

Base URL

https://api.sportsapipro.com/v2/football

Finding Player IDs: Use /api/search?q=haaland to find player IDs, or extract them from match lineups (/api/match/{id}/lineups) or team squads (/api/teams/{id}/players).

Player Profile

Player Details

GET /api/players/{playerId}

Returns player profile: name, nationality, age, height, weight, position, current team, shirt number, preferred foot, and market value.

number

required

Numeric player ID (e.g., 934235 for Haaland). Discover via search, lineups, or squads.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651 (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "player": {
      "name": "Nahuel Noll",
      "slug": "nahuel-noll",
      "shortName": "N. Noll",
      "team": {
        "name": "SC Paderborn 07",
        "slug": "sc-paderborn-07",
        "shortName": "Paderborn",
        "gender": "M",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "tournament": {
          "name": "2. Bundesliga",
          "slug": "2-bundesliga",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "country": {
              "alpha2": "DE",
              "alpha3": "DEU",
              "name": "Germany",
              "slug": "germany"
            },
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            }
          },
          "uniqueTournament": {
            "name": "2. Bundesliga",
            "slug": "2-bundesliga",
            "primaryColorHex": "#919292",
            "secondaryColorHex": "#d20616",
            "category": {
              "name": "Germany",
              "slug": "germany",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 8,
              "country": {
                "alpha2": "DE",
                "alpha3": "DEU",
                "name": "Germany",
                "slug": "germany"
              },
              "id": 30,
              "flag": "germany",
              "alpha2": "DE",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "ألمانيا",
                  "bn": "জার্মানি",
                  "hi": "जर्मनी",
                  "ru": "Германия"
                },
                "shortNameTranslation": {}
              }
            },
            "userCount": 57928,
            "liveActivityEnabled": true,
            "country": {},
            "id": 44,
            "displayInverseHomeAwayTeams": false,
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "الدوري الألماني الدرجة الثانية",
                "bn": "2. বুন্দেসলিগা",
                "hi": "2. बुंडेसलीगा",
                "ru": "Бундеслига 2"
              },
              "shortNameTranslation": {}
            }
          },
          "priority": 355,
          "isLive": false,
          "id": 41,
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "الدوري الألماني الدرجة الثانية",
              "bn": "2. বুন্দেসলিগা",
              "hi": "2. बुंडेसलीगा",
              "ru": "Бундеслига 2"
            },
            "shortNameTranslation": {}
          }
        },
        "primaryUniqueTournament": {
          "name": "Bundesliga",
          "slug": "bundesliga",
          "primaryColorHex": "#e2080e",
          "secondaryColorHex": "#8e0902",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "country": {
              "alpha2": "DE",
              "alpha3": "DEU",
              "name": "Germany",
              "slug": "germany"
            },
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 565701,
          "liveActivityEnabled": true,
          "country": {},
          "id": 35,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "bn": "বুন্দেসলীগা",
              "ar": "الدوري الألماني",
              "hi": "बुंडेसलीगा",
              "ru": "Бундеслига"
            },
            "shortNameTranslation": {}
          }
        },
        "userCount": 33644,
        "nameCode": "PAD",
        "disabled": false,
        "national": false,
        "type": 0,
        "country": {
          "alpha2": "DE",
          "alpha3": "DEU",
          "name": "Germany",
          "slug": "germany"
        },
        "id": 2561,
        "teamColors": {
          "primary": "#0000bb",
          "secondary": "#0000a6",
          "text": "#0000a6"
        },
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "بادربورن",
            "hi": "एससी पेडरबोर्न 07",
            "ru": "Падерборн 07"
          },
          "shortNameTranslation": {
            "ar": "بادربورن",
            "bn": "প্যাডারবর্ন",
            "hi": "पेडरबॉर्न",
            "ru": "Падерборн 07"
          }
        }
      },
      "position": "G",
      "positionsDetailed": [
        "GK"
      ],
      "jerseyNumber": "15",
      "height": 188,
      "dateOfBirth": "2003-03-17T00:00:00+00:00",
      "preferredFoot": "Both",
      "userCount": 263,
      "deceased": false,
      "gender": "M",
      "country": {
        "alpha2": "DE",
        "alpha3": "DEU",
        "name": "Germany",
        "slug": "germany"
      },
      "id": 1048651,
      "underage": false,
      "shirtNumber": 15,
      "dateOfBirthTimestamp": 1047859200,
      "contractUntilTimestamp": 1814313600,
      "proposedMarketValue": 1900000,
      "proposedMarketValueRaw": {
        "value": 1900000,
        "currency": "EUR"
      },
      "fieldTranslations": {
        "nameTranslation": {
          "ar": "ناهيل نول",
          "bn": "নাহুয়েল নোল",
          "hi": "नाहुएल नोल",
          "ru": "Нахуэль Ноль"
        },
        "shortNameTranslation": {
          "ar": "ن. نول",
          "bn": "এন. নোল",
          "hi": "एन. नोल",
          "ru": "Н. Ноль"
        }
      }
    }
  }
}

Player Image

GET /api/players/{playerId}/image

Returns the player’s profile photo URL.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/image (lists trimmed to 2 items).

{
  "success": true,
  "playerId": 1048651,
  "imageUrl": "https://api.provider.app/api/v1/player/1048651/image"
}

Characteristics

GET /api/players/{playerId}/characteristics

Returns the player’s standout attributes ranked against all other players, plus the position codes they’ve been classified as. Response shape:

{
  "positive": [
    { "type": 25, "rank": 31 },
    { "type": 16, "rank": 131 },
    { "type": 5, "rank": 18 }
  ],
  "negative": [
    { "type": 6, "rank": 1951 }
  ],
  "positions": ["ST"]
}

Fields:

positive / negative — arrays of standout attributes (strengths and weaknesses).
type (number) — numeric attribute ID from the underlying data model. Stable across requests; treat as an opaque grouping key.
rank (number) — the player’s global rank among all players for that attribute. Lower number = stronger for positive, weaker for negative.
positions — position codes the player has been classified as (e.g. ST, RW, CM, GK).

Human-readable trait labels (e.g. “Strong in the air”) are not part of this payload. The endpoint returns numeric attribute IDs only — map them to labels on the client if you need display strings.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/characteristics (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "positive": [
      {
        "type": 19,
        "rank": 269
      }
    ],
    "negative": [],
    "positions": [
      "GK"
    ]
  }
}

Attribute Overviews

GET /api/players/{playerId}/attribute-overviews

Returns radar chart data with two parallel series: the player’s scores and the peer-group average for the same position. Five axes (0–100): attacking, technical, tactical, defending, creativity. Response shape:

{
  "averageAttributeOverviews": [
    { "attacking": 61, "technical": 54, "tactical": 43, "defending": 32, "creativity": 46, "position": "F", "yearShift": 0, "id": 19812 }
  ],
  "playerAttributeOverviews": [
    { "attacking": 85, "technical": 66, "tactical": 77, "defending": 38, "creativity": 52, "position": "F", "yearShift": 0, "id": 22047 },
    { "attacking": 83, "technical": 63, "tactical": 74, "defending": 30, "creativity": 51, "position": "F", "yearShift": 1, "id": 30286 },
    { "attacking": 83, "technical": 63, "tactical": 75, "defending": 33, "creativity": 56, "position": "F", "yearShift": 2, "id": 56218 },
    { "attacking": 94, "technical": 70, "tactical": 72, "defending": 30, "creativity": 58, "position": "F", "yearShift": 3, "id": 76089 }
  ]
}

Fields:

playerAttributeOverviews — the player’s own scores. One entry per season, identified by yearShift.
averageAttributeOverviews — peer-group benchmark: the average across all players in the same position bucket for the same yearShift. Use as the comparison ring on a radar chart.
attacking, technical, tactical, defending, creativity — the five radar axes, scored 0–100. (There are no physical or mental axes.)
position — broad position bucket the averages are computed against: F (forward), M (midfielder), D (defender), G (goalkeeper).
yearShift — offset from the current season: 0 = current, 1 = one season ago, 2 = two seasons ago, and so on. Use for year-over-year trend charts.
id — internal record id; safe to ignore when charting.

For the classic player-vs-position radar, overlay playerAttributeOverviews where yearShift === 0 on top of averageAttributeOverviews where yearShift === 0.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/attribute-overviews (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "playerAttributeOverviews": [
      {
        "id": 174894,
        "tactical": 57,
        "saves": 57,
        "anticipation": 53,
        "ballDistribution": 74,
        "aerial": 58,
        "position": "G",
        "yearShift": 0
      },
      {
        "id": 228783,
        "tactical": 51,
        "saves": 51,
        "anticipation": 52,
        "ballDistribution": 67,
        "aerial": 55,
        "position": "G",
        "yearShift": 1
      }
    ],
    "averageAttributeOverviews": [
      {
        "id": 19809,
        "tactical": 37,
        "saves": 55,
        "anticipation": 36,
        "ballDistribution": 55,
        "aerial": 55,
        "position": "G",
        "yearShift": 0
      }
    ],
    "sportSlug": "football"
  }
}

Last Year Summary

GET /api/players/{playerId}/last-year-summary

Returns a summary of the player’s performance over the last calendar year: goals, assists, appearances, and ratings.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/last-year-summary (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "summary": [
      {
        "type": "event",
        "timestamp": 1759663800,
        "value": "6.3",
        "uniqueTournamentId": 44
      },
      {
        "type": "event",
        "timestamp": 1760718600,
        "value": "6.5",
        "uniqueTournamentId": 44
      }
    ],
    "uniqueTournamentsMap": {
      "35": {
        "name": "Bundesliga",
        "slug": "bundesliga",
        "primaryColorHex": "#e2080e",
        "secondaryColorHex": "#8e0902",
        "category": {
          "name": "Germany",
          "slug": "germany",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "priority": 8,
          "id": 30,
          "flag": "germany",
          "alpha2": "DE",
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "ألمانيا",
              "bn": "জার্মানি",
              "hi": "जर्मनी",
              "ru": "Германия"
            },
            "shortNameTranslation": {}
          }
        },
        "userCount": 565701,
        "liveActivityEnabled": true,
        "id": 35,
        "displayInverseHomeAwayTeams": false,
        "fieldTranslations": {
          "nameTranslation": {
            "bn": "বুন্দেসলীগা",
            "ar": "الدوري الألماني",
            "hi": "बुंडेसलीगा",
            "ru": "Бундеслига"
          },
          "shortNameTranslation": {}
        }
      },
      "44": {
        "name": "2. Bundesliga",
        "slug": "2-bundesliga",
        "primaryColorHex": "#919292",
        "secondaryColorHex": "#d20616",
        "category": {
          "name": "Germany",
          "slug": "germany",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "priority": 8,
          "id": 30,
          "flag": "germany",
          "alpha2": "DE",
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "ألمانيا",
              "bn": "জার্মানি",
              "hi": "जर्मनी",
              "ru": "Германия"
            },
            "shortNameTranslation": {}
          }
        },
        "userCount": 57928,
        "liveActivityEnabled": true,
        "id": 44,
        "displayInverseHomeAwayTeams": false,
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "الدوري الألماني الدرجة الثانية",
            "bn": "2. বুন্দেসলিগা",
            "hi": "2. बुंडेसलीगा",
            "ru": "Бундеслига 2"
          },
          "shortNameTranslation": {}
        }
      }
    }
  }
}

Statistics

Overall Statistics

GET /api/players/{playerId}/statistics

Returns career statistics across all competitions: goals, assists, appearances, minutes, cards, and ratings.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/statistics (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "seasons": [
      {
        "statistics": {
          "accurateLongBalls": 49,
          "accurateLongBallsPercentage": 39.84,
          "accuratePasses": 143,
          "accuratePassesPercentage": 65.6,
          "aerialDuelsWon": 1,
          "assists": 0,
          "bigChancesCreated": 0,
          "bigChancesMissed": 0,
          "cleanSheet": 1,
          "dribbledPast": 0,
          "errorLeadToGoal": 0,
          "expectedAssists": 0.02485947,
          "goals": 0,
          "goalsAssistsSum": 0,
          "goalsConceded": 5,
          "goalsPrevented": 1.3715,
          "interceptions": 0,
          "keyPasses": 0,
          "minutesPlayed": 360,
          "passToAssist": 0,
          "rating": 7.75,
          "redCards": 0,
          "savedShotsFromInsideTheBox": 9,
          "saves": 14,
          "successfulDribbles": 0,
          "...": "31 more fields"
        },
        "year": "26/27",
        "startYear": 2026,
        "endYear": 2027,
        "team": {
          "name": "SC Paderborn 07",
          "slug": "sc-paderborn-07",
          "shortName": "Paderborn",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 33769,
          "nameCode": "PAD",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 2561,
          "teamColors": {
            "primary": "#0000bb",
            "secondary": "#0000a6",
            "text": "#0000a6"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "بادربورن",
              "hi": "एससी पेडरबोर्न 07",
              "ru": "Падерборн 07"
            },
            "shortNameTranslation": {
              "ar": "بادربورن",
              "bn": "প্যাডারবর্ন",
              "hi": "पेडरबॉर्न",
              "ru": "Падерборн 07"
            }
          }
        },
        "uniqueTournament": {
          "name": "Bundesliga",
          "slug": "bundesliga",
          "primaryColorHex": "#e2080e",
          "secondaryColorHex": "#8e0902",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 568337,
          "liveActivityEnabled": true,
          "id": 35,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "bn": "বুন্দেসলীগা",
              "ar": "الدوري الألماني",
              "hi": "बुंडेसलीगा",
              "ru": "Бундеслига"
            },
            "shortNameTranslation": {}
          },
          "competitionType": "domestic-league",
          "majorTrophy": true,
          "hasAchievements": true
        },
        "season": {
          "name": "Bundesliga 26/27",
          "year": "26/27",
          "editor": false,
          "potsEnabled": false,
          "id": 97464
        }
      }
    ],
    "typesMap": {
      "35": [
        "overall"
      ],
      "44": [
        "overall"
      ],
      "217": [
        "overall"
      ]
    }
  }
}

Statistics Seasons

GET /api/players/{playerId}/statistics/seasons

Returns all seasons with available statistics. Use this to discover valid season IDs for season-specific endpoints.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/statistics/seasons (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "uniqueTournamentSeasons": [
      {
        "uniqueTournament": {
          "name": "Bundesliga",
          "slug": "bundesliga",
          "primaryColorHex": "#e2080e",
          "secondaryColorHex": "#8e0902",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 565701,
          "liveActivityEnabled": true,
          "id": 35,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "bn": "বুন্দেসলীগা",
              "ar": "الدوري الألماني",
              "hi": "बुंडेसलीगा",
              "ru": "Бундеслига"
            },
            "shortNameTranslation": {}
          }
        },
        "seasons": [
          {
            "name": "Bundesliga 26/27",
            "year": "26/27",
            "editor": false,
            "id": 97464
          }
        ]
      },
      {
        "uniqueTournament": {
          "name": "DFB Pokal",
          "slug": "dfb-pokal",
          "primaryColorHex": "#ffcc00",
          "secondaryColorHex": "#666666",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 82831,
          "liveActivityEnabled": true,
          "id": 217,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "كأس ألمانيا",
              "bn": "ডিএফবি পোকাল",
              "hi": "डीएफबी पोकल",
              "ru": "Кубок DFB"
            },
            "shortNameTranslation": {}
          }
        },
        "seasons": [
          {
            "name": "DFB Pokal 25/26",
            "year": "25/26",
            "editor": false,
            "id": 76910
          },
          {
            "name": "DFB Pokal 24/25",
            "year": "24/25",
            "editor": false,
            "id": 61132
          }
        ]
      }
    ],
    "typesMap": {
      "35": {
        "97464": [
          "overall",
          "home"
        ]
      },
      "44": {
        "63514": [
          "overall",
          "home"
        ],
        "77354": [
          "overall",
          "home"
        ]
      },
      "217": {
        "61132": [
          "overall",
          "away"
        ],
        "76910": [
          "overall",
          "away"
        ]
      },
      "1079": {
        "37340": [
          "overall"
        ],
        "42517": [
          "overall"
        ]
      }
    }
  }
}

Career Stats by Match Type

GET /api/players/{playerId}/statistics/match-type?type={type}

Returns career statistics filtered by match type.

string

Match type filter (e.g., domestic league, cup, international).

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/statistics/match-type?type=overall (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "seasons": [
      {
        "statistics": {
          "accurateLongBalls": 49,
          "accurateLongBallsPercentage": 39.84,
          "accuratePasses": 143,
          "accuratePassesPercentage": 65.6,
          "aerialDuelsWon": 1,
          "assists": 0,
          "bigChancesCreated": 0,
          "bigChancesMissed": 0,
          "cleanSheet": 1,
          "dribbledPast": 0,
          "errorLeadToGoal": 0,
          "expectedAssists": 0.02485947,
          "goals": 0,
          "goalsAssistsSum": 0,
          "goalsConceded": 5,
          "goalsPrevented": 1.3715,
          "interceptions": 0,
          "keyPasses": 0,
          "minutesPlayed": 360,
          "passToAssist": 0,
          "rating": 7.75,
          "redCards": 0,
          "savedShotsFromInsideTheBox": 9,
          "saves": 14,
          "successfulDribbles": 0,
          "...": "31 more fields"
        },
        "year": "26/27",
        "startYear": 2026,
        "endYear": 2027,
        "team": {
          "name": "SC Paderborn 07",
          "slug": "sc-paderborn-07",
          "shortName": "Paderborn",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 33769,
          "nameCode": "PAD",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 2561,
          "teamColors": {
            "primary": "#0000bb",
            "secondary": "#0000a6",
            "text": "#0000a6"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "بادربورن",
              "hi": "एससी पेडरबोर्न 07",
              "ru": "Падерборн 07"
            },
            "shortNameTranslation": {
              "ar": "بادربورن",
              "bn": "প্যাডারবর্ন",
              "hi": "पेडरबॉर्न",
              "ru": "Падерборн 07"
            }
          }
        },
        "uniqueTournament": {
          "name": "Bundesliga",
          "slug": "bundesliga",
          "primaryColorHex": "#e2080e",
          "secondaryColorHex": "#8e0902",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 568337,
          "liveActivityEnabled": true,
          "id": 35,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "bn": "বুন্দেসলীগা",
              "ar": "الدوري الألماني",
              "hi": "बुंडेसलीगा",
              "ru": "Бундеслига"
            },
            "shortNameTranslation": {}
          },
          "competitionType": "domestic-league",
          "majorTrophy": true,
          "hasAchievements": true
        },
        "season": {
          "name": "Bundesliga 26/27",
          "year": "26/27",
          "editor": false,
          "potsEnabled": false,
          "id": 97464
        }
      }
    ],
    "typesMap": {
      "35": [
        "overall"
      ],
      "44": [
        "overall"
      ],
      "217": [
        "overall"
      ]
    }
  }
}

Tournament Season Statistics (aggregated per player)

GET /api/players/{playerId}/tournament/{tournamentId}/season/{seasonId}/statistics?type=overall

The canonical route for aggregated season statistics for one player. Returns data.statistics plus the player’s team for that season. Around 60 fields on a tier 1-3 season — verified 4 Sep 2026 for Joey Veerman (850816), Eredivisie 25/26 (tournament 37, season 77012):

{
  "rating": 7.8866666666667,
  "totalRating": 236.6,
  "countRating": 30,
  "goals": 8,
  "assists": 14,
  "goalsAssistsSum": 22,
  "expectedAssists": 9.6936295,
  "bigChancesCreated": 27,
  "bigChancesMissed": 1,
  "totalPasses": 1961,
  "accuratePasses": 1691,
  "accuratePassesPercentage": 86.231514533401,
  "keyPasses": 95,
  "successfulDribbles": 13,
  "tackles": 58,
  "interceptions": 26,
  "totalShots": 34,
  "yellowCards": 4,
  "redCards": 0
}

Per-game figures are not returned: divide a total by appearances (from top-players) or by countRating.

string

default:"overall"

Only overall is currently served; home and away are advertised by player-statistics/types but return 404/503.

Depth follows competition tier. Regionalliga and below return only goals, penaltyGoals and ownGoals (verified for Regionalliga North 25/26, season 77796). See Coverage.

Discovering valid season IDs: use /api/players/{playerId}/statistics/seasons for one player, or /api/teams/{teamId}/player-statistics/seasons for a whole squad — both return data.uniqueTournamentSeasons. Competition leaders live on /api/tournament/{id}/season/{seasonId}/top-players, which returns 30-32 categories x top 50 in a single request.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/tournament/35/season/97464/statistics?type=overall (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "statistics": {
      "rating": 7.75,
      "totalRating": 31,
      "countRating": 4,
      "goals": 0,
      "bigChancesCreated": 0,
      "bigChancesMissed": 0,
      "assists": 0,
      "expectedAssists": 0.02485947,
      "goalsAssistsSum": 0,
      "expectedGoalsInvolvement": 0.02485947,
      "accuratePasses": 143,
      "inaccuratePasses": 75,
      "totalPasses": 218,
      "accuratePassesPercentage": 65.596330275229,
      "accurateOwnHalfPasses": 109,
      "accurateOppositionHalfPasses": 34,
      "accurateFinalThirdPasses": 19,
      "keyPasses": 0,
      "successfulDribbles": 0,
      "successfulDribblesPercentage": 0,
      "tackles": 0,
      "interceptions": 0,
      "yellowCards": 0,
      "directRedCards": 0,
      "redCards": 0,
      "...": "88 more fields"
    },
    "seasonRatingBreakdown": {
      "passValue": 0.17,
      "dribbleValue": 0.05,
      "defensiveValue": -0.02,
      "goalkeeperValue": 0.54
    },
    "team": {
      "name": "SC Paderborn 07",
      "slug": "sc-paderborn-07",
      "shortName": "Paderborn",
      "gender": "M",
      "sport": {
        "name": "Football",
        "slug": "football",
        "id": 1
      },
      "userCount": 33644,
      "nameCode": "PAD",
      "disabled": false,
      "national": false,
      "type": 0,
      "id": 2561,
      "teamColors": {
        "primary": "#0000bb",
        "secondary": "#0000a6",
        "text": "#0000a6"
      },
      "fieldTranslations": {
        "nameTranslation": {
          "ar": "بادربورن",
          "hi": "एससी पेडरबोर्न 07",
          "ru": "Падерборн 07"
        },
        "shortNameTranslation": {
          "ar": "بادربورن",
          "bn": "প্যাডারবর্ন",
          "hi": "पेडरबॉर्न",
          "ru": "Падерборн 07"
        }
      }
    }
  }
}

National Team Statistics

GET /api/players/{playerId}/national-team-statistics

Returns international career statistics: caps, goals, and assists for the national team.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/national-team-statistics (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "statistics": []
  }
}

Visual Data

Match Heatmap

GET /api/players/{playerId}/match/{matchId}/heatmap

Returns heatmap data showing the player’s movement and positioning during a specific match.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/match/16434052/heatmap (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "heatmap": [
      {
        "x": 19,
        "y": 36
      },
      {
        "x": 10,
        "y": 49
      }
    ]
  }
}

Season Heatmap

GET /api/players/{playerId}/tournament/{tournamentId}/season/{seasonId}/heatmap?type={type}

Returns an aggregated heatmap across all matches in a tournament season.

string

default:"overall"

Filter: overall, home, or away.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/tournament/35/season/97464/heatmap?type=overall (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "points": [
      {
        "x": 13,
        "y": 53,
        "count": 1
      }
    ],
    "matches": 4,
    "events": [
      {
        "eventState": {},
        "tournament": {
          "name": "Bundesliga",
          "slug": "bundesliga",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            }
          },
          "uniqueTournament": {
            "name": "Bundesliga",
            "slug": "bundesliga",
            "primaryColorHex": "#e2080e",
            "secondaryColorHex": "#8e0902",
            "category": {
              "name": "Germany",
              "slug": "germany",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 8,
              "id": 30,
              "flag": "germany",
              "alpha2": "DE",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "ألمانيا",
                  "bn": "জার্মানি",
                  "hi": "जर्मनी",
                  "ru": "Германия"
                },
                "shortNameTranslation": {}
              }
            },
            "userCount": 565701,
            "liveActivityEnabled": true,
            "id": 35,
            "displayInverseHomeAwayTeams": false,
            "fieldTranslations": {
              "nameTranslation": {
                "bn": "বুন্দেসলীগা",
                "ar": "الدوري الألماني",
                "hi": "बुंडेसलीगा",
                "ru": "Бундеслига"
              },
              "shortNameTranslation": {}
            }
          },
          "priority": 699,
          "isLive": false,
          "id": 42,
          "fieldTranslations": {
            "nameTranslation": {
              "hi": "बुंडेसलीगा",
              "ar": "الدوري الألماني",
              "bn": "বুন্দেসলীগা",
              "ru": "Бундеслига"
            },
            "shortNameTranslation": {}
          }
        },
        "roundInfo": {
          "round": 3
        },
        "customId": "lbbsydb",
        "status": {
          "code": 100,
          "description": "Ended",
          "type": "finished"
        },
        "winnerCode": 1,
        "homeTeam": {
          "name": "Borussia Dortmund",
          "slug": "borussia-dortmund",
          "shortName": "Dortmund",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 1455253,
          "nameCode": "BVB",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 2673,
          "teamColors": {
            "primary": "#ffe600",
            "secondary": "#000000",
            "text": "#000000"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "بوروسيا دورتموند",
              "hi": "बोरुस्सिया  डॉर्टमुंड",
              "ru": "Боруссия Дортмунд"
            },
            "shortNameTranslation": {
              "ar": "دورتموند",
              "bn": "ডর্টমুন্ড",
              "hi": "डॉर्टमुंड",
              "ru": "Дортмунд"
            }
          }
        },
        "awayTeam": {
          "name": "SC Paderborn 07",
          "slug": "sc-paderborn-07",
          "shortName": "Paderborn",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 33644,
          "nameCode": "PAD",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 2561,
          "teamColors": {
            "primary": "#0000bb",
            "secondary": "#0000a6",
            "text": "#0000a6"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "بادربورن",
              "hi": "एससी पेडरबोर्न 07",
              "ru": "Падерборн 07"
            },
            "shortNameTranslation": {
              "ar": "بادربورن",
              "bn": "প্যাডারবর্ন",
              "hi": "पेडरबॉर्न",
              "ru": "Падерборн 07"
            }
          }
        },
        "homeScore": {
          "current": 3,
          "display": 3,
          "period1": 1,
          "period2": 2,
          "normaltime": 3
        },
        "awayScore": {
          "current": 0,
          "display": 0,
          "period1": 0,
          "period2": 0,
          "normaltime": 0
        },
        "hasXg": true,
        "id": 16434037,
        "slug": "borussia-dortmund-sc-paderborn-07",
        "startTimestamp": 1789219800,
        "finalResultOnly": false
      }
    ]
  }
}

Season Ratings

GET /api/players/{playerId}/tournament/{tournamentId}/season/{seasonId}/ratings?type={type}

Returns match-by-match player ratings throughout the season — useful for performance trend charts.

string

default:"overall"

Filter: overall, home, or away.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/tournament/35/season/97464/ratings?type=overall (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "seasonRatings": [
      {
        "eventId": 16434052,
        "event": {
          "eventState": {},
          "tournament": {
            "name": "Bundesliga",
            "slug": "bundesliga",
            "category": {
              "name": "Germany",
              "slug": "germany",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 8,
              "id": 30,
              "flag": "germany",
              "alpha2": "DE",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "ألمانيا",
                  "bn": "জার্মানি",
                  "hi": "जर्मनी",
                  "ru": "Германия"
                },
                "shortNameTranslation": {}
              }
            },
            "uniqueTournament": {
              "name": "Bundesliga",
              "slug": "bundesliga",
              "primaryColorHex": "#e2080e",
              "secondaryColorHex": "#8e0902",
              "category": {
                "name": "Germany",
                "slug": "germany",
                "sport": {
                  "name": "Football",
                  "slug": "football",
                  "id": 1
                },
                "priority": 8,
                "id": 30,
                "flag": "germany",
                "alpha2": "DE",
                "fieldTranslations": {
                  "nameTranslation": "...",
                  "shortNameTranslation": "..."
                }
              },
              "userCount": 565701,
              "liveActivityEnabled": true,
              "id": 35,
              "displayInverseHomeAwayTeams": false,
              "fieldTranslations": {
                "nameTranslation": {
                  "bn": "বুন্দেসলীগা",
                  "ar": "الدوري الألماني",
                  "hi": "बुंडेसलीगा",
                  "ru": "Бундеслига"
                },
                "shortNameTranslation": {}
              }
            },
            "priority": 699,
            "isLive": false,
            "id": 42,
            "fieldTranslations": {
              "nameTranslation": {
                "hi": "बुंडेसलीगा",
                "ar": "الدوري الألماني",
                "bn": "বুন্দেসলীগা",
                "ru": "Бундеслига"
              },
              "shortNameTranslation": {}
            }
          },
          "roundInfo": {
            "round": 4
          },
          "customId": "lbbsubb",
          "status": {
            "code": 100,
            "description": "Ended",
            "type": "finished"
          },
          "winnerCode": 1,
          "homeTeam": {
            "name": "SC Paderborn 07",
            "slug": "sc-paderborn-07",
            "shortName": "Paderborn",
            "gender": "M",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "userCount": 33644,
            "nameCode": "PAD",
            "disabled": false,
            "national": false,
            "type": 0,
            "id": 2561,
            "teamColors": {
              "primary": "#0000bb",
              "secondary": "#0000a6",
              "text": "#0000a6"
            },
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "بادربورن",
                "hi": "एससी पेडरबोर्न 07",
                "ru": "Падерборн 07"
              },
              "shortNameTranslation": {
                "ar": "بادربورن",
                "bn": "প্যাডারবর্ন",
                "hi": "पेडरबॉर्न",
                "ru": "Падерборн 07"
              }
            }
          },
          "awayTeam": {
            "name": "TSG Hoffenheim",
            "slug": "tsg-hoffenheim",
            "shortName": "Hoffenheim",
            "gender": "M",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "userCount": 114014,
            "nameCode": "TSG",
            "disabled": false,
            "national": false,
            "type": 0,
            "id": 2569,
            "teamColors": {
              "primary": "#1f5da6",
              "secondary": "#ffffff",
              "text": "#ffffff"
            },
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "هوفنهايم",
                "hi": "TSG होफ्फेन्हेइम",
                "ru": "Хоффенхайм"
              },
              "shortNameTranslation": {
                "ar": "هوفنهايم",
                "bn": "হফেনহাইম",
                "hi": "हॉफेनहाइम"
              }
            }
          },
          "homeScore": {
            "current": 3,
            "display": 3,
            "period1": 2,
            "period2": 1,
            "normaltime": 3
          },
          "awayScore": {
            "current": 1,
            "display": 1,
            "period1": 0,
            "period2": 1,
            "normaltime": 1
          },
          "hasXg": true,
          "id": 16434052,
          "slug": "tsg-hoffenheim-sc-paderborn-07",
          "startTimestamp": 1789925400,
          "finalResultOnly": false
        },
        "startTimestamp": 1789925400,
        "rating": 6.7,
        "opponent": {
          "name": "TSG Hoffenheim",
          "slug": "tsg-hoffenheim",
          "shortName": "Hoffenheim",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 114014,
          "nameCode": "TSG",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 2569,
          "teamColors": {
            "primary": "#1f5da6",
            "secondary": "#ffffff",
            "text": "#ffffff"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "هوفنهايم",
              "hi": "TSG होफ्फेन्हेइम",
              "ru": "Хоффенхайм"
            },
            "shortNameTranslation": {
              "ar": "هوفنهايم",
              "bn": "হফেনহাইম",
              "hi": "हॉफेनहाइम"
            }
          }
        },
        "isHome": true
      }
    ]
  }
}

Near Events

GET /api/players/{playerId}/near-events

Returns the player’s previous and next match with player ratings. Useful for quick context on recent and upcoming fixtures.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/near-events (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "previousEvent": {
      "eventState": {},
      "tournament": {
        "name": "Bundesliga",
        "slug": "bundesliga",
        "category": {
          "name": "Germany",
          "slug": "germany",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "priority": 8,
          "id": 30,
          "flag": "germany",
          "alpha2": "DE",
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "ألمانيا",
              "bn": "জার্মানি",
              "hi": "जर्मनी",
              "ru": "Германия"
            },
            "shortNameTranslation": {}
          }
        },
        "uniqueTournament": {
          "name": "Bundesliga",
          "slug": "bundesliga",
          "primaryColorHex": "#e2080e",
          "secondaryColorHex": "#8e0902",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 565701,
          "liveActivityEnabled": true,
          "id": 35,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "bn": "বুন্দেসলীগা",
              "ar": "الدوري الألماني",
              "hi": "बुंडेसलीगा",
              "ru": "Бундеслига"
            },
            "shortNameTranslation": {}
          }
        },
        "priority": 699,
        "isLive": false,
        "id": 42,
        "fieldTranslations": {
          "nameTranslation": {
            "hi": "बुंडेसलीगा",
            "ar": "الدوري الألماني",
            "bn": "বুন্দেসলীগা",
            "ru": "Бундеслига"
          },
          "shortNameTranslation": {}
        }
      },
      "roundInfo": {
        "round": 4
      },
      "customId": "lbbsubb",
      "status": {
        "code": 100,
        "description": "Ended",
        "type": "finished"
      },
      "winnerCode": 1,
      "homeTeam": {
        "name": "SC Paderborn 07",
        "slug": "sc-paderborn-07",
        "shortName": "Paderborn",
        "gender": "M",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "userCount": 33644,
        "nameCode": "PAD",
        "disabled": false,
        "national": false,
        "type": 0,
        "id": 2561,
        "teamColors": {
          "primary": "#0000bb",
          "secondary": "#0000a6",
          "text": "#0000a6"
        },
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "بادربورن",
            "hi": "एससी पेडरबोर्न 07",
            "ru": "Падерборн 07"
          },
          "shortNameTranslation": {
            "ar": "بادربورن",
            "bn": "প্যাডারবর্ন",
            "hi": "पेडरबॉर्न",
            "ru": "Падерборн 07"
          }
        }
      },
      "awayTeam": {
        "name": "TSG Hoffenheim",
        "slug": "tsg-hoffenheim",
        "shortName": "Hoffenheim",
        "gender": "M",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "userCount": 114014,
        "nameCode": "TSG",
        "disabled": false,
        "national": false,
        "type": 0,
        "id": 2569,
        "teamColors": {
          "primary": "#1f5da6",
          "secondary": "#ffffff",
          "text": "#ffffff"
        },
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "هوفنهايم",
            "hi": "TSG होफ्फेन्हेइम",
            "ru": "Хоффенхайм"
          },
          "shortNameTranslation": {
            "ar": "هوفنهايم",
            "bn": "হফেনহাইম",
            "hi": "हॉफेनहाइम"
          }
        }
      },
      "homeScore": {
        "current": 3,
        "display": 3,
        "period1": 2,
        "period2": 1,
        "normaltime": 3
      },
      "awayScore": {
        "current": 1,
        "display": 1,
        "period1": 0,
        "period2": 1,
        "normaltime": 1
      },
      "hasXg": true,
      "id": 16434052,
      "slug": "tsg-hoffenheim-sc-paderborn-07",
      "startTimestamp": 1789925400,
      "finalResultOnly": false
    },
    "nextEvent": {
      "eventState": {},
      "tournament": {
        "name": "Club Friendly Games",
        "slug": "club-friendly-games",
        "category": {
          "name": "World",
          "slug": "world",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "priority": 20,
          "id": 1468,
          "flag": "international",
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "العالم",
              "hi": "विश्व",
              "bn": "বিশ্ব",
              "ru": "Мир"
            },
            "shortNameTranslation": {}
          }
        },
        "uniqueTournament": {
          "name": "Club Friendly Games",
          "slug": "club-friendly-games",
          "primaryColorHex": "#25497d",
          "secondaryColorHex": "#d38f1d",
          "category": {
            "name": "World",
            "slug": "world",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 20,
            "id": 1468,
            "flag": "international",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "العالم",
                "hi": "विश्व",
                "bn": "বিশ্ব",
                "ru": "Мир"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 40659,
          "liveActivityEnabled": false,
          "id": 853,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "bn": "ক্লাব ফ্রেন্ডলি গেমস",
              "ar": "مباريات ودية للأندية",
              "hi": "क्लब फ्रेंडली गेम्स",
              "ru": "Товарищеские игры клубов"
            },
            "shortNameTranslation": {}
          }
        },
        "priority": 0,
        "isLive": false,
        "id": 86,
        "fieldTranslations": {
          "nameTranslation": {
            "hi": "क्लब फ्रेंडली गेम्स",
            "ar": "مباريات ودية للأندية",
            "bn": "ক্লাব ফ্রেন্ডলি গেমস",
            "ru": "Кубок дружеских игр"
          },
          "shortNameTranslation": {}
        }
      },
      "customId": "cabslbb",
      "status": {
        "code": 0,
        "description": "Not started",
        "type": "notstarted"
      },
      "homeTeam": {
        "name": "DC United",
        "slug": "dc-united",
        "shortName": "DC United",
        "gender": "M",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "userCount": 16409,
        "nameCode": "DC",
        "disabled": false,
        "national": false,
        "type": 0,
        "id": 2502,
        "teamColors": {
          "primary": "#000000",
          "secondary": "#ff0000",
          "text": "#ff0000"
        },
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "دي سي يونايتد",
            "hi": "डीसी यूनाइटेड",
            "ru": "Ди Си Юнайтед"
          },
          "shortNameTranslation": {}
        }
      },
      "awayTeam": {
        "name": "SC Paderborn 07",
        "slug": "sc-paderborn-07",
        "shortName": "Paderborn",
        "gender": "M",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "userCount": 33644,
        "nameCode": "PAD",
        "disabled": false,
        "national": false,
        "type": 0,
        "id": 2561,
        "teamColors": {
          "primary": "#0000bb",
          "secondary": "#0000a6",
          "text": "#0000a6"
        },
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "بادربورن",
            "hi": "एससी पेडरबोर्न 07",
            "ru": "Падерборн 07"
          },
          "shortNameTranslation": {
            "ar": "بادربورن",
            "bn": "প্যাডারবর্ন",
            "hi": "पेडरबॉर्न",
            "ru": "Падерборн 07"
          }
        }
      },
      "homeScore": {},
      "awayScore": {},
      "id": 17059733,
      "slug": "sc-paderborn-07-dc-united",
      "startTimestamp": 1790811000,
      "finalResultOnly": false
    },
    "statisticsMap": {
      "16434052": {
        "rating": 6.7
      }
    }
  }
}

Events

Last Events (Paginated)

GET /api/players/{playerId}/events/last/{page}

Returns the player’s most recent matches with stats and ratings, paginated.

number

required

Page number (0-indexed). Start with 0 for the most recent.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/events/last/0 (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "events": [
      {
        "eventState": {},
        "tournament": {
          "name": "2. Bundesliga",
          "slug": "2-bundesliga",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "country": {
              "alpha2": "DE",
              "alpha3": "DEU",
              "name": "Germany",
              "slug": "germany"
            },
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            }
          },
          "uniqueTournament": {
            "name": "2. Bundesliga",
            "slug": "2-bundesliga",
            "primaryColorHex": "#919292",
            "secondaryColorHex": "#d20616",
            "category": {
              "name": "Germany",
              "slug": "germany",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 8,
              "country": {
                "alpha2": "DE",
                "alpha3": "DEU",
                "name": "Germany",
                "slug": "germany"
              },
              "id": 30,
              "flag": "germany",
              "alpha2": "DE",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "ألمانيا",
                  "bn": "জার্মানি",
                  "hi": "जर्मनी",
                  "ru": "Германия"
                },
                "shortNameTranslation": {}
              }
            },
            "userCount": 57928,
            "hasPerformanceGraphFeature": true,
            "liveActivityEnabled": true,
            "country": {},
            "id": 44,
            "hasEventPlayerStatistics": true,
            "displayInverseHomeAwayTeams": false,
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "الدوري الألماني الدرجة الثانية",
                "bn": "2. বুন্দেসলিগা",
                "hi": "2. बुंडेसलीगा",
                "ru": "Бундеслига 2"
              },
              "shortNameTranslation": {}
            }
          },
          "priority": 355,
          "isGroup": false,
          "isLive": false,
          "id": 41,
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "الدوري الألماني الدرجة الثانية",
              "bn": "2. বুন্দেসলিগা",
              "hi": "2. बुंडेसलीगा",
              "ru": "Бундеслига 2"
            },
            "shortNameTranslation": {}
          }
        },
        "season": {
          "name": "2. Bundesliga 25/26",
          "year": "25/26",
          "editor": false,
          "id": 77354
        },
        "roundInfo": {
          "round": 17
        },
        "customId": "yabsQab",
        "status": {
          "code": 100,
          "description": "Ended",
          "type": "finished"
        },
        "winnerCode": 1,
        "homeTeam": {
          "name": "1. FC Nürnberg",
          "slug": "1-fc-nurnberg",
          "shortName": "Nürnberg",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 27254,
          "nameCode": "FCN",
          "disabled": false,
          "national": false,
          "type": 0,
          "country": {
            "alpha2": "DE",
            "alpha3": "DEU",
            "name": "Germany",
            "slug": "germany"
          },
          "id": 2523,
          "subTeams": [],
          "teamColors": {
            "primary": "#990000",
            "secondary": "#000000",
            "text": "#000000"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "نيورنبرج",
              "ru": "Нюрнберг"
            },
            "shortNameTranslation": {}
          }
        },
        "awayTeam": {
          "name": "Hannover 96",
          "slug": "hannover-96",
          "shortName": "Hannover",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 34627,
          "nameCode": "H96",
          "disabled": false,
          "national": false,
          "type": 0,
          "country": {
            "alpha2": "DE",
            "alpha3": "DEU",
            "name": "Germany",
            "slug": "germany"
          },
          "id": 2541,
          "subTeams": [],
          "teamColors": {
            "primary": "#bf0000",
            "secondary": "#ffffff",
            "text": "#ffffff"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "هانوفر",
              "hi": "हेन्नोवर 96",
              "ru": "Ганновер 96"
            },
            "shortNameTranslation": {}
          }
        },
        "homeScore": {
          "current": 2,
          "display": 2,
          "period1": 1,
          "period2": 1,
          "normaltime": 2
        },
        "awayScore": {
          "current": 1,
          "display": 1,
          "period1": 1,
          "period2": 0,
          "normaltime": 1
        },
        "time": {
          "injuryTime1": 3,
          "injuryTime2": 4,
          "currentPeriodStartTimestamp": 1766324194
        },
        "changes": {
          "changes": [
            "status.code"
          ],
          "changeTimestamp": 1766327186
        },
        "hasGlobalHighlights": false,
        "hasXg": true,
        "hasEventPlayerStatistics": true,
        "hasEventPlayerHeatMap": true,
        "detailId": 1,
        "crowdsourcingDataDisplayEnabled": false,
        "correctAiInsight": false,
        "correctHalftimeAiInsight": false,
        "id": 14065401,
        "slug": "hannover-96-1-fc-nurnberg",
        "startTimestamp": 1766320200,
        "finalResultOnly": false,
        "...": "3 more fields"
      }
    ],
    "hasNextPage": true,
    "playedForTeamMap": {
      "14065389": 2541,
      "14065401": 2541,
      "14065404": 2541,
      "14065415": 2541,
      "14065422": 2541,
      "14065431": 2541,
      "14065445": 2541,
      "14065453": 2541,
      "14065463": 2541,
      "14065469": 2541,
      "14065480": 2541,
      "14065487": 2541,
      "14065495": 2541,
      "14065509": 2541,
      "14065513": 2541,
      "14065520": 2541,
      "14065533": 2541,
      "14065539": 2541,
      "14065549": 2541,
      "15317624": 2541,
      "15318024": 2541,
      "16287053": 2561,
      "16400333": 2561,
      "16434024": 2561,
      "16434037": 2561,
      "...": "6 more fields"
    },
    "statisticsMap": {
      "14065389": {
        "rating": 7.2,
        "minutesPlayed": 90
      },
      "14065401": {
        "rating": 6.5,
        "minutesPlayed": 90
      },
      "14065404": {
        "rating": 8.3,
        "minutesPlayed": 90
      },
      "14065415": {
        "rating": 7.3,
        "minutesPlayed": 90
      },
      "14065422": {
        "rating": 8.3,
        "minutesPlayed": 90
      },
      "14065431": {
        "rating": 7.2,
        "minutesPlayed": 90
      },
      "14065445": {
        "rating": 8.1,
        "minutesPlayed": 90
      },
      "14065453": {
        "rating": 6.8,
        "minutesPlayed": 90
      },
      "14065463": {
        "rating": 9.6,
        "minutesPlayed": 90
      },
      "14065469": {
        "rating": 6.4,
        "minutesPlayed": 90
      },
      "14065480": {
        "rating": 7.2,
        "minutesPlayed": 90
      },
      "14065487": {
        "rating": 8.5,
        "minutesPlayed": 90
      },
      "14065495": {
        "rating": 6.5,
        "minutesPlayed": 90
      },
      "14065509": {
        "rating": 7.1,
        "minutesPlayed": 90
      },
      "14065513": {
        "rating": 7.2,
        "minutesPlayed": 90
      },
      "14065520": {
        "rating": 6.7,
        "minutesPlayed": 90
      },
      "14065533": {
        "rating": 6.4,
        "minutesPlayed": 90
      },
      "14065539": {
        "rating": 6.7,
        "minutesPlayed": 90
      },
      "14065549": {
        "rating": 6.5,
        "minutesPlayed": 90
      },
      "15317624": {},
      "15318024": {},
      "16287053": {},
      "16400333": {},
      "16434024": {
        "rating": 8.4,
        "minutesPlayed": 90
      },
      "16434037": {
        "rating": 7.8,
        "minutesPlayed": 90
      },
      "...": "6 more fields"
    },
    "incidentsMap": {
      "14065401": {
        "yellowCards": 1
      }
    },
    "onBenchMap": {
      "16287053": true,
      "16665883": true
    }
  }
}

Season Summary

Tournament Season Summary

GET /api/players/{playerId}/tournament/{tournamentId}/season/{seasonId}/summary

Returns a summary of the player’s performance in a specific tournament season: appearances, goals, assists, ratings, and key stats.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/tournament/35/season/97464/summary (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "statistics": {
      "rating": 7.75,
      "totalRating": 31,
      "countRating": 4,
      "goals": 0,
      "bigChancesCreated": 0,
      "bigChancesMissed": 0,
      "assists": 0,
      "expectedAssists": 0.02485947,
      "goalsAssistsSum": 0,
      "expectedGoalsInvolvement": 0.02485947,
      "accuratePasses": 143,
      "inaccuratePasses": 75,
      "totalPasses": 218,
      "accuratePassesPercentage": 65.596330275229,
      "accurateOwnHalfPasses": 109,
      "accurateOppositionHalfPasses": 34,
      "accurateFinalThirdPasses": 19,
      "keyPasses": 0,
      "successfulDribbles": 0,
      "successfulDribblesPercentage": 0,
      "tackles": 0,
      "interceptions": 0,
      "yellowCards": 0,
      "directRedCards": 0,
      "redCards": 0,
      "...": "88 more fields"
    },
    "seasonRatingBreakdown": {
      "passValue": 0.17,
      "dribbleValue": 0.05,
      "defensiveValue": -0.02,
      "goalkeeperValue": 0.54
    },
    "team": {
      "name": "SC Paderborn 07",
      "slug": "sc-paderborn-07",
      "shortName": "Paderborn",
      "gender": "M",
      "sport": {
        "name": "Football",
        "slug": "football",
        "id": 1
      },
      "userCount": 33644,
      "nameCode": "PAD",
      "disabled": false,
      "national": false,
      "type": 0,
      "id": 2561,
      "teamColors": {
        "primary": "#0000bb",
        "secondary": "#0000a6",
        "text": "#0000a6"
      },
      "fieldTranslations": {
        "nameTranslation": {
          "ar": "بادربورن",
          "hi": "एससी पेडरबोर्न 07",
          "ru": "Падерборн 07"
        },
        "shortNameTranslation": {
          "ar": "بادربورن",
          "bn": "প্যাডারবর্ন",
          "hi": "पेडरबॉर्न",
          "ru": "Падерборн 07"
        }
      }
    }
  }
}

Transfer & Career

Transfer History

GET /api/players/{playerId}/transfer-history

Returns complete transfer history: clubs, dates, fees, and transfer types (permanent, loan, free).

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/transfer-history (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "transferHistory": [
      {
        "player": {
          "name": "Nahuel Noll",
          "slug": "nahuel-noll",
          "shortName": "N. Noll",
          "position": "G",
          "jerseyNumber": "15",
          "userCount": 263,
          "gender": "M",
          "id": 1048651,
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "ناهيل نول",
              "bn": "নাহুয়েল নোল",
              "hi": "नाहुएल नोल",
              "ru": "Нахуэль Ноль"
            },
            "shortNameTranslation": {
              "ar": "ن. نول",
              "bn": "এন. নোল",
              "hi": "एन. नोल",
              "ru": "Н. Ноль"
            }
          }
        },
        "transferFrom": {
          "name": "SC Paderborn 07",
          "slug": "sc-paderborn-07",
          "shortName": "Paderborn",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 33644,
          "nameCode": "PAD",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 2561,
          "teamColors": {
            "primary": "#0000bb",
            "secondary": "#0000a6",
            "text": "#0000a6"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "بادربورن",
              "hi": "एससी पेडरबोर्न 07",
              "ru": "Падерборн 07"
            },
            "shortNameTranslation": {
              "ar": "بادربورن",
              "bn": "প্যাডারবর্ন",
              "hi": "पेडरबॉर्न",
              "ru": "Падерборн 07"
            }
          }
        },
        "transferTo": {
          "name": "TSG Hoffenheim",
          "slug": "tsg-hoffenheim",
          "shortName": "Hoffenheim",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 114014,
          "nameCode": "TSG",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 2569,
          "teamColors": {
            "primary": "#1f5da6",
            "secondary": "#ffffff",
            "text": "#ffffff"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "هوفنهايم",
              "hi": "TSG होफ्फेन्हेइम",
              "ru": "Хоффенхайм"
            },
            "shortNameTranslation": {
              "ar": "هوفنهايم",
              "bn": "হফেনহাইম",
              "hi": "हॉफेनहाइम"
            }
          }
        },
        "fromTeamName": "SC Paderborn 07",
        "toTeamName": "TSG Hoffenheim",
        "type": 2,
        "transferFee": 0,
        "transferFeeDescription": "-",
        "id": 3456942,
        "transferDateTimestamp": 1814313600,
        "transferFeeRaw": {
          "value": 0,
          "currency": "EUR"
        }
      }
    ]
  }
}

Unique Tournaments

GET /api/players/{playerId}/unique-tournaments

Returns all competitions the player has participated in throughout their career.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/unique-tournaments (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "uniqueTournaments": [
      {
        "name": "Bundesliga",
        "slug": "bundesliga",
        "primaryColorHex": "#e2080e",
        "secondaryColorHex": "#8e0902",
        "category": {
          "name": "Germany",
          "slug": "germany",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "priority": 8,
          "id": 30,
          "flag": "germany",
          "alpha2": "DE",
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "ألمانيا",
              "bn": "জার্মানি",
              "hi": "जर्मनी",
              "ru": "Германия"
            },
            "shortNameTranslation": {}
          }
        },
        "userCount": 565701,
        "gender": "M",
        "liveActivityEnabled": true,
        "id": 35,
        "displayInverseHomeAwayTeams": false,
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "الدوري الألماني",
            "bn": "বুন্দেসলীগা",
            "hi": "बुंडेसलीगा",
            "ru": "Бундеслига"
          },
          "shortNameTranslation": {}
        }
      },
      {
        "name": "DFB Pokal",
        "slug": "dfb-pokal",
        "primaryColorHex": "#ffcc00",
        "secondaryColorHex": "#666666",
        "category": {
          "name": "Germany",
          "slug": "germany",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "priority": 8,
          "id": 30,
          "flag": "germany",
          "alpha2": "DE",
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "ألمانيا",
              "bn": "জার্মানি",
              "hi": "जर्मनी",
              "ru": "Германия"
            },
            "shortNameTranslation": {}
          }
        },
        "userCount": 82831,
        "gender": "M",
        "liveActivityEnabled": true,
        "id": 217,
        "displayInverseHomeAwayTeams": false,
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "كأس ألمانيا",
            "bn": "ডিএফবি পোকাল",
            "hi": "डीएफबी पोकल",
            "ru": "Кубок DFB"
          },
          "shortNameTranslation": {}
        }
      }
    ]
  }
}

Penalty History

GET /api/players/{playerId}/penalty-history

Returns the player’s career penalty record: taken, scored, missed, and saved.

No example: this endpoint returned HTTP 404 for our Bundesliga sample on 24 September 2026. It only returns data when the entity has it (for example knockout draws, penalties or media), so handle an empty or 404 response.

Tournament Penalty History

GET /api/players/{playerId}/tournament/{tournamentId}/season/{seasonId}/penalty-history

Returns penalty record for a specific tournament season.

Media

GET /api/players/{playerId}/media

Returns media content associated with the player (photos).

Media Videos

GET /api/players/{playerId}/media/videos

Returns video highlights and clips featuring the player.

Media Summary

GET /api/players/{playerId}/media-summary?country={country}

Returns a media summary for the player (highlights, YouTube videos) localized by country.

string

default:"GB"

Country code for localized content (e.g., GB, US, DE).

Fantasy

Fantasy Competitions

GET /api/players/{playerId}/fantasy/competitions

Returns fantasy competitions the player is registered in, along with the player’s fantasy ID.

Important: Fantasy IDs are NOT the same as player IDs. Use this endpoint to discover the fantasyId, then pass it to /api/fantasy/player/{fantasyId} endpoints. See Fantasy Endpoints.

Example response

Recorded 24 September 2026 from GET /v2/football/players/1048651/fantasy/competitions (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "competitions": [
      {
        "competitionId": 166,
        "fantasyPlayerId": 94432,
        "globalLeagueId": 267561,
        "uniqueTournamentId": 35,
        "seasonId": 97464,
        "seasonName": "Bundesliga 26/27"
      }
    ]
  }
}

Example Requests

curl -X GET "https://api.sportsapipro.com/v2/football/players/934235/statistics" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  'https://api.sportsapipro.com/v2/football/players/934235/statistics',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const stats = await response.json();

import requests

response = requests.get(
    'https://api.sportsapipro.com/v2/football/players/934235/statistics',
    headers={'x-api-key': 'YOUR_API_KEY'}
)
stats = response.json()

Historical Depth of Player Statistics

Player-level detail is not uniform across all seasons. Verified against the Premier League (uniqueTournament 17, 35 seasons available from 1992/93 onwards):

Period	Player-level detail
2022/23 to present	Full detail including per-match `expectedGoals` and `expectedAssists`
2014/15 to 2021/22	Rich per-match stats (roughly 43 to 51 fields: `keyPass`, `rating`, duels, defending, passing) but no per-match xG or xA
2013/14 and earlier	Basic player fields only. Fixtures, results, lineups, standings and match events remain available

Preseason and exhibition fixtures are best-effort. Club Friendly Games and Community Shield matches involving top-tier clubs typically return full lineups with detailed player statistics, but xG is not populated for those matches and lower-profile exhibition fixtures may return no player statistics at all.

Example responses

Real responses recorded on 24 September 2026 from the Bundesliga (tournament 35, season 97464), match SC Paderborn 07 3-1 TSG Hoffenheim (16434052). Long lists are shortened to the first items; field names and structure are unchanged.

Player details

curl -H "x-api-key: YOUR_API_KEY" "https://api.sportsapipro.com/v2/football/players/1180758"

{
  "success": true,
  "data": {
    "player": {
      "name": "Adam Daghim",
      "firstName": "",
      "lastName": "",
      "slug": "adam-daghim",
      "shortName": "A. Daghim",
      "team": {
        "name": "TSG Hoffenheim",
        "slug": "tsg-hoffenheim",
        "shortName": "Hoffenheim",
        "gender": "M",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "tournament": {
          "name": "Bundesliga",
          "slug": "bundesliga",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "country": {
              "alpha2": "DE",
              "alpha3": "DEU",
              "name": "Germany",
              "slug": "germany"
            },
            "id": 30,
            "flag": "germany",
            "alpha2": "DE"
          },
          "uniqueTournament": {
            "name": "Bundesliga",
            "slug": "bundesliga",
            "primaryColorHex": "#e2080e",
            "secondaryColorHex": "#8e0902",
            "category": {
              "name": "Germany",
              "slug": "germany",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 8,
              "country": {
                "alpha2": "DE",
                "alpha3": "DEU",
                "name": "Germany",
                "slug": "germany"
              },
              "id": 30,
              "flag": "germany",
              "alpha2": "DE"
            },
            "userCount": 565701,
            "liveActivityEnabled": true,
            "country": {},
            "id": 35,
            "displayInverseHomeAwayTeams": false
          },
          "priority": 699,
          "isLive": false,
          "id": 42
        },
        "primaryUniqueTournament": {
          "name": "Bundesliga",
          "slug": "bundesliga",
          "primaryColorHex": "#e2080e",
          "secondaryColorHex": "#8e0902",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "country": {
              "alpha2": "DE",
              "alpha3": "DEU",
              "name": "Germany",
              "slug": "germany"
            },
            "id": 30,
            "flag": "germany",
            "alpha2": "DE"
          },
          "userCount": 565701,
          "liveActivityEnabled": true,
          "country": {},
          "id": 35,
          "displayInverseHomeAwayTeams": false
        },
        "userCount": 114014,
        "nameCode": "TSG",
        "disabled": false,
        "national": false,
        "type": 0,
        "country": {
          "alpha2": "DE",
          "alpha3": "DEU",
          "name": "Germany",
          "slug": "germany"
        },
        "id": 2569
      },
      "position": "F",
      "positionsDetailed": [
        "ST",
        "RW"
      ],
      "jerseyNumber": "14",
      "height": 186,
      "dateOfBirth": "2005-09-28T00:00:00+00:00",
      "preferredFoot": "Left",
      "userCount": 1162,
      "deceased": false,
      "gender": "M",
      "country": {
        "alpha2": "DK",
        "alpha3": "DNK",
        "name": "Denmark",
        "slug": "denmark"
      },
      "id": 1180758,
      "underage": false,
      "shirtNumber": 14,
      "dateOfBirthTimestamp": 1127865600,
      "proposedMarketValue": 8100000,
      "proposedMarketValueRaw": {
        "value": 8100000,
        "currency": "EUR"
      }
    }
  },
  "source": "live",
  "cacheHit": false,
  "timezone": {
    "name": "Europe/Amsterdam",
    "utcOffset": "+02:00",
    "source": "auto",
    "country": "NL"
  }
}

Player season statistics (every stat key)

curl -H "x-api-key: YOUR_API_KEY" "https://api.sportsapipro.com/v2/football/players/1180758/tournament/35/season/97464/statistics?type=overall"

{
  "success": true,
  "data": {
    "statistics": {
      "rating": 6.95,
      "totalRating": 27.8,
      "countRating": 4,
      "goals": 2,
      "bigChancesCreated": 5,
      "bigChancesMissed": 0,
      "assists": 2,
      "expectedAssists": 0.885463,
      "goalsAssistsSum": 4,
      "expectedGoalsInvolvement": 1.227663,
      "accuratePasses": 70,
      "inaccuratePasses": 36,
      "totalPasses": 106,
      "accuratePassesPercentage": 66.037735849057,
      "accurateOwnHalfPasses": 13,
      "accurateOppositionHalfPasses": 57,
      "accurateFinalThirdPasses": 37,
      "keyPasses": 9,
      "successfulDribbles": 5,
      "successfulDribblesPercentage": 22.727272727273,
      "tackles": 6,
      "interceptions": 4,
      "yellowCards": 0,
      "directRedCards": 0,
      "redCards": 0,
      "accurateCrosses": 3,
      "accurateCrossesPercentage": 18.75,
      "totalShots": 6,
      "shotsOnTarget": 4,
      "shotsOffTarget": 0,
      "groundDuelsWon": 12,
      "groundDuelsWonPercentage": 31.578947368421,
      "aerialDuelsWon": 4,
      "aerialDuelsWonPercentage": 80,
      "totalDuelsWon": 16,
      "totalDuelsWonPercentage": 37.209302325581,
      "minutesPlayed": 347,
      "goalConversionPercentage": 33.333333333333,
      "penaltiesTaken": 0,
      "penaltyGoals": 0,
      "penaltyWon": 0,
      "penaltyConceded": 0,
      "shotFromSetPiece": 0,
      "freeKickGoal": 0,
      "goalsFromInsideTheBox": 1,
      "goalsFromOutsideTheBox": 1,
      "shotsFromInsideTheBox": 4,
      "shotsFromOutsideTheBox": 2,
      "headedGoals": 0,
      "leftFootGoals": 1,
      "rightFootGoals": 1,
      "accurateLongBalls": 3,
      "accurateLongBallsPercentage": 42.857142857143,
      "clearances": 4,
      "errorLeadToGoal": 0,
      "errorLeadToShot": 0,
      "dispossessed": 3,
      "possessionLost": 85,
      "possessionWonAttThird": 5,
      "totalChippedPasses": 5,
      "accurateChippedPasses": 1,
      "touches": 202,
      "wasFouled": 2,
      "fouls": 4,
      "hitWoodwork": 0,
      "ownGoals": 0,
      "dribbledPast": 2,
      "offsides": 2,
      "blockedShots": 2,
      "passToAssist": 0,
      "saves": 0,
      "kilometersCovered": 42.27,
      "numberOfSprints": 88,
      "topSpeed": 35.33,
      "cleanSheet": 0,
      "penaltyFaced": 0,
      "penaltySave": 0,
      "savedShotsFromInsideTheBox": 0,
      "savedShotsFromOutsideTheBox": 0,
      "goalsConcededInsideTheBox": 10,
      "goalsConcededOutsideTheBox": 0,
      "punches": 0,
      "runsOut": 0,
      "successfulRunsOut": 0,
      "highClaims": 0,
      "crossesNotClaimed": 0,
      "matchesStarted": 4,
      "penaltyConversion": 0,
      "setPieceConversion": 0,
      "totalAttemptAssist": 9,
      "totalContest": 22,
      "totalCross": 16,
      "duelLost": 27,
      "aerialLost": 1,
      "attemptPenaltyMiss": 0,
      "attemptPenaltyPost": 0,
      "attemptPenaltyTarget": 0,
      "totalLongBalls": 7,
      "goalsConceded": 10,
      "tacklesWon": 5,
      "tacklesWonPercentage": 83.333333333333,
      "scoringFrequency": 173.5,
      "yellowRedCards": 0,
      "savesCaught": 0,
      "savesParried": 0,
      "totalOwnHalfPasses": 16,
      "totalOppositionHalfPasses": 90,
      "totwAppearances": 0,
      "expectedGoals": 0.3422,
      "goalKicks": 0,
      "ballRecovery": 11,
      "outfielderBlocks": 0,
      "kilometersCoveredPer90": 10.963400576369,
      "numberOfSprintsPer90": 22.824207492795,
      "id": 3325991,
      "type": "overall",
      "appearances": 4,
      "statisticsType": {
        "sportSlug": "football",
        "statisticsType": "player"
      }
    },
    "seasonRatingBreakdown": {
      "shotValue": 0.13,
      "passValue": 0.1,
      "dribbleValue": 0.07,
      "defensiveValue": -0.12
    },
    "team": {
      "name": "TSG Hoffenheim",
      "slug": "tsg-hoffenheim",
      "shortName": "Hoffenheim",
      "gender": "M",
      "sport": {
        "name": "Football",
        "slug": "football",
        "id": 1
      },
      "userCount": 114014,
      "nameCode": "TSG",
      "disabled": false,
      "national": false,
      "type": 0,
      "id": 2569
    }
  },
  "source": "live",
  "cacheHit": false,
  "timezone": {
    "name": "Europe/Amsterdam",
    "utcOffset": "+02:00",
    "source": "auto",
    "country": "NL"
  }
}

Attribute overview

curl -H "x-api-key: YOUR_API_KEY" "https://api.sportsapipro.com/v2/football/players/1180758/attribute-overviews"

{
  "success": true,
  "data": {
    "playerAttributeOverviews": [
      {
        "id": 132537,
        "attacking": 61,
        "technical": 47,
        "tactical": 45,
        "defending": 31,
        "creativity": 54,
        "position": "F",
        "yearShift": 0
      },
      {
        "id": 175550,
        "attacking": 62,
        "technical": 52,
        "tactical": 46,
        "defending": 30,
        "creativity": 49,
        "position": "F",
        "yearShift": 1
      }
    ],
    "averageAttributeOverviews": [
      {
        "id": 19812,
        "attacking": 61,
        "technical": 54,
        "tactical": 43,
        "defending": 32,
        "creativity": 46,
        "position": "F",
        "yearShift": 0
      }
    ],
    "sportSlug": "football"
  },
  "source": "live",
  "cacheHit": false,
  "timezone": {
    "name": "Europe/Amsterdam",
    "utcOffset": "+02:00",
    "source": "auto",
    "country": "NL"
  }
}

​Base URL

​Player Profile

​Player Details

​Player Image

​Characteristics

​Attribute Overviews

​Last Year Summary

​Statistics

​Overall Statistics

​Statistics Seasons

​Career Stats by Match Type

​Tournament Season Statistics (aggregated per player)

​National Team Statistics

​Visual Data

​Match Heatmap

​Season Heatmap

​Season Ratings

​Near Events

​Near Events

​Events

​Last Events (Paginated)

​Season Summary

​Tournament Season Summary

​Transfer & Career

​Transfer History

​Unique Tournaments

​Penalty History

​Tournament Penalty History

​Media

​Media

​Media Videos

​Media Summary

​Fantasy

​Fantasy Competitions

​Example Requests

​Historical Depth of Player Statistics

​Example responses

Base URL

Player Profile

Player Details

Player Image

Characteristics

Attribute Overviews

Last Year Summary

Statistics

Overall Statistics

Statistics Seasons

Career Stats by Match Type

Tournament Season Statistics (aggregated per player)

National Team Statistics

Visual Data

Match Heatmap

Season Heatmap

Season Ratings

Near Events

Near Events

Events

Last Events (Paginated)

Season Summary

Tournament Season Summary

Transfer & Career

Transfer History

Unique Tournaments

Penalty History

Tournament Penalty History

Media

Media

Media Videos

Media Summary

Fantasy

Fantasy Competitions

Example Requests

Historical Depth of Player Statistics

Example responses