Skip to main content

​
Base URL

https://v2.football.sportsapipro.com
Finding Team IDs: Use /api/search?q=arsenal to find team IDs, or extract them from match details (homeTeam.id, awayTeam.id).

​
Team Profile

​
Team Details

GET /api/teams/{teamId}
Returns team metadata: name, short name, country, venue, manager, founded year, and competition info.
​
teamId
number
required
Numeric team ID. Discover via /api/search or match details.

​
Team Squad / Players

GET /api/teams/{teamId}/players
Returns the full squad with player details: name, position, nationality, jersey number, age, market value, and contract expiry.

​
Team Image

GET /api/teams/{teamId}/image
Returns the team crest/badge image URL.

​
Events

​
Last Events (Paginated)

GET /api/teams/{teamId}/events/last/{page}
Returns the team’s most recent completed matches, paginated.
​
page
number
required
Page number (0-indexed). Start with 0 for the most recent events.

​
Next Events (Paginated)

GET /api/teams/{teamId}/events/next/{page}
Returns upcoming scheduled matches for the team, paginated.

​
Near Events

GET /api/teams/{teamId}/near-events
Returns the closest past and upcoming events around the current date. 
GET /api/teams/{teamId}/featured-event
Returns the team’s most prominent upcoming match (e.g., next league fixture, derby, or cup match).

​
Statistics

​
Team Statistics in Tournament Season

GET /api/teams/{teamId}/tournament/{tournamentId}/season/{seasonId}/statistics?type={type}
Returns detailed team statistics for a specific tournament and season.
​
type
string
default:"overall"
Filter by match location: overall, home, or away.
Use /api/tournaments/{id}/seasons to discover valid seasonId values.

​
Goal Distributions

GET /api/teams/{teamId}/tournament/{tournamentId}/season/{seasonId}/goal-distributions
Returns when goals were scored and conceded, broken down by time intervals (0–15, 16–30, 31–45, 46–60, 61–75, 76–90 minutes).

​
Performance / Recent Form

GET /api/teams/{teamId}/performance
Returns the team’s recent form: last N results, win/draw/loss streak, and performance trend.

​
Metadata

​
Tournaments

GET /api/teams/{teamId}/unique-tournaments
Returns all competitions the team participates in (e.g., Premier League, Champions League, FA Cup).

​
Transfers

GET /api/teams/{teamId}/transfers
Returns the team’s transfer activity: signings, departures, loan deals, and transfer fees.

​
Media

GET /api/teams/{teamId}/media
Returns media content associated with the team (photos, videos).

​
Available Seasons

Discover which seasons have data available for this team: 
GET /api/teams/{teamId}/player-statistics/seasons
GET /api/teams/{teamId}/standings/seasons
GET /api/teams/{teamId}/team-statistics/seasons
Use these endpoints to find valid season IDs before calling season-specific statistics endpoints.

​
Example Requests

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