Skip to main content

​
Base URL

https://v2.football.sportsapipro.com
Season IDs must be discovered dynamically. Always call /api/tournaments/{id}/seasons first to get valid season IDs. Season IDs change every year and are specific to each tournament. Never hardcode them.

​
Seasons

​
Get Tournament Seasons

GET /api/tournaments/{id}/seasons
Returns all available seasons for a tournament. Call this first to discover valid seasonId values for other endpoints.
​
id
number
required
Numeric tournament ID. Use /api/search?q=premier+league or /api/leagues to discover.

​
Standings

​
Overall Standings

GET /api/tournament/{tournamentId}/season/{seasonId}/standings
Returns the full league table with points, wins, draws, losses, goals for/against, and goal difference.

​
Home Standings

GET /api/tournament/{tournamentId}/season/{seasonId}/standings/home
Returns standings based on home matches only.

​
Away Standings

GET /api/tournament/{tournamentId}/season/{seasonId}/standings/away
Returns standings based on away matches only.

​
Statistics & Rankings

​
Top Players

GET /api/tournament/{tournamentId}/season/{seasonId}/top-players?type={type}
Returns top-performing players in the tournament season (top scorers, assists, etc.).
​
type
string
default:"overall"
Filter by match location: overall, home, or away.

​
Top Teams

GET /api/tournament/{tournamentId}/season/{seasonId}/top-teams?type={type}
Returns top-performing teams by various metrics.

​
Top Ratings

GET /api/tournament/{tournamentId}/season/{seasonId}/top-ratings?type={type}
Returns player ratings leaderboard for the season.

​
Season Statistics

GET /api/tournament/{tournamentId}/season/{seasonId}/statistics
Returns aggregate season statistics: total goals, cards, average goals per match, etc.

​
Statistics Info

GET /api/tournament/{tournamentId}/season/{seasonId}/statistics/info
Returns metadata about available statistics types for the season.

​
Player Statistics Types

GET /api/tournament/{tournamentId}/season/{seasonId}/player-statistics/types
Returns available player statistic categories (e.g., goals, assists, tackles, saves).

​
Team Statistics Types

GET /api/tournament/{tournamentId}/season/{seasonId}/team-statistics/types
Returns available team statistic categories.

​
Player of the Season

GET /api/tournament/{tournamentId}/season/{seasonId}/player-of-the-season
Returns the player of the season award details, including nominees and winner.

​
Rounds & Events

​
All Rounds

GET /api/tournament/{tournamentId}/season/{seasonId}/rounds
Returns all matchday rounds for the season with round numbers and status.

​
Round Matches

GET /api/tournament/{tournamentId}/season/{seasonId}/round/{round}
Returns all matches in a specific round/matchday.

​
Events by Round

GET /api/tournament/{tournamentId}/season/{seasonId}/events/round/{round}
Returns detailed event data for a specific round.

​
Events by Round & Slug

GET /api/tournament/{tournamentId}/season/{seasonId}/events/round/{round}/slug/{slug}
Returns events filtered by round and slug identifier.

​
Last Events (Paginated)

GET /api/tournament/{tournamentId}/season/{seasonId}/events/last/{page}
Returns recent completed matches in the tournament, paginated. Page 0 returns the most recent.
​
page
number
required
Page number (0-indexed). Start with 0 for the most recent events.

​
Brackets & Cup Tournaments

​
Knockout / Cup Tree

GET /api/tournament/{tournamentId}/season/{seasonId}/knockout
Returns the bracket/knockout tree for cup tournaments (e.g., FA Cup, Champions League). Includes all rounds from Round of 32 to the Final.
Only available for cup/knockout tournaments. League tournaments will return empty data.

​
Team of the Week

​
Available Periods

GET /api/tournament/{tournamentId}/season/{seasonId}/team-of-the-week/periods
Returns available Team of the Week periods (matchdays). Use the returned periodId values to fetch specific team-of-the-week selections.

​
Team of the Week by Period

GET /api/tournament/{tournamentId}/season/{seasonId}/team-of-the-week/{periodId}
Returns the best XI for a specific matchday period, including formation, player ratings, and key stats.
​
periodId
number
required
Period ID from the /team-of-the-week/periods endpoint.

​
Team Performance

​
Team Performance Graph

GET /api/tournament/{tournamentId}/season/{seasonId}/team/{teamId}/performance-graph
Returns a team’s performance trajectory over the season — position changes after each matchday.

​
Team Events

GET /api/tournament/{tournamentId}/season/{seasonId}/team-events?type={type}
Returns all events for teams in the tournament season.
​
type
string
default:"total"
Filter: total, home, or away.

​
Tournament Info

​
Tournament Details

GET /api/tournament/{tournamentId}/info
Returns tournament metadata: name, country, logo, tier, and current season.

​
Season Info

GET /api/tournament/{tournamentId}/season/{seasonId}/info
Returns season-specific information: start/end dates, number of teams, current round. 
GET /api/tournament/{tournamentId}/featured-events
Returns highlighted/featured matches for the tournament (e.g., derbies, title deciders).

​
Tournament Image

GET /api/tournament/{tournamentId}/image
Returns the tournament logo/badge image URL.

​
Tournament Media

GET /api/tournament/{tournamentId}/media
GET /api/tournament/{tournamentId}/season/{seasonId}/media
Returns media content (photos, videos) for the tournament or a specific season.
Not all tournaments have media content. Top-tier leagues are more likely to have media available.

​
Venues

GET /api/tournament/{tournamentId}/season/{seasonId}/venues
Returns all venues used in the tournament season, with capacity, location, and coordinates.

​
Example Requests

# Step 1: Discover seasons
curl -X GET "https://v2.football.sportsapipro.com/api/tournaments/17/seasons" \
  -H "x-api-key: YOUR_API_KEY"

# Step 2: Use a valid seasonId from the response
curl -X GET "https://v2.football.sportsapipro.com/api/tournament/17/season/61627/standings" \
  -H "x-api-key: YOUR_API_KEY"