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 player traits and playing style descriptions (e.g., “Strong in the air”, “Clinical finisher”).

​
Attribute Overviews

GET /api/players/{playerId}/attribute-overviews
Returns radar chart data for player attributes: attacking, defending, technical, physical, and mental categories with numeric scores.

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

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

​
Next Events (Paginated)

GET /api/players/{playerId}/events/next/{page}
Returns upcoming scheduled matches for the player’s current team, paginated.

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

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