Skip to main content

​
Base URL

https://v2.football.sportsapipro.com
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.
​
playerId
number
required
Numeric player ID (e.g., 934235 for Haaland). Discover via search, lineups, or squads.

​
Player Image

GET /api/players/{playerId}/image
Returns the player’s profile photo URL.

​
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.

​
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.

​
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.

​
Statistics

​
Overall Statistics

GET /api/players/{playerId}/statistics
Returns career statistics across all competitions: goals, assists, appearances, minutes, cards, and ratings.

​
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.

​
Career Stats by Match Type

GET /api/players/{playerId}/statistics/match-type?type={type}
Returns career statistics filtered by match type.
​
type
string
Match type filter (e.g., domestic league, cup, international).

​
Tournament Season Statistics

GET /api/players/{playerId}/tournament/{tournamentId}/season/{seasonId}/statistics?type={type}
Returns player statistics for a specific tournament and season.
​
type
string
default:"overall"
Filter: overall, home, or away.

​
National Team Statistics

GET /api/players/{playerId}/national-team-statistics
Returns international career statistics: caps, goals, and assists for the national team.

​
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.

​
Season Heatmap

GET /api/players/{playerId}/tournament/{tournamentId}/season/{seasonId}/heatmap?type={type}
Returns an aggregated heatmap across all matches in a tournament season.
​
type
string
default:"overall"
Filter: overall, home, or away.

​
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.
​
type
string
default:"overall"
Filter: overall, home, or away.

​
Near Events

​
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.

​
Events

​
Last Events (Paginated)

GET /api/players/{playerId}/events/last/{page}
Returns the player’s most recent matches with stats and ratings, paginated.
​
page
number
required
Page number (0-indexed). Start with 0 for the most recent.

​
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.

​
Transfer & Career

​
Transfer History

GET /api/players/{playerId}/transfer-history
Returns complete transfer history: clubs, dates, fees, and transfer types (permanent, loan, free).

​
Unique Tournaments

GET /api/players/{playerId}/unique-tournaments
Returns all competitions the player has participated in throughout their career.

​
Penalty History

GET /api/players/{playerId}/penalty-history
Returns the player’s career penalty record: taken, scored, missed, and saved.

​
Tournament Penalty History

GET /api/players/{playerId}/tournament/{tournamentId}/season/{seasonId}/penalty-history
Returns penalty record for a specific tournament season.

​
Media

​
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.
​
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 Requests

curl -X GET "https://v2.football.sportsapipro.com/api/players/934235/statistics" \
  -H "x-api-key: YOUR_API_KEY"
Last modified on May 30, 2026