Team Endpoints

Base URL

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

Finding Team IDs: Use /api/search?q=lakers to find team IDs, or extract them from match details (homeTeam.id, awayTeam.id). Example: Lakers = 3427.

Team Profile

Team Details

GET /api/teams/{teamId}

Returns team metadata: name, venue/arena, manager/head coach, and competition info.

number

required

Numeric team ID. Discover via /api/search or match details.

Team Roster / Players

GET /api/teams/{teamId}/players

Returns the full roster with player details: name, position (G/F/C), nationality, jersey number, height, weight, and age.

Team Image

GET /api/teams/{teamId}/image

Returns the team logo/badge image URL.

Events

Last Events (Paginated)

GET /api/teams/{teamId}/events/last/{page}

Returns the team’s most recent completed games, paginated.

number

required

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

Next Events (Paginated)

GET /api/teams/{teamId}/events/next/{page}

Returns upcoming scheduled games for the team, paginated.

Near Events

GET /api/teams/{teamId}/near-events

Returns the closest past and upcoming events around the current date.

Featured Event

GET /api/teams/{teamId}/featured-event

Returns the team’s next big game.

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.

string

default:"overall"

Filter: overall, home, or away.

Performance / Recent Form

GET /api/teams/{teamId}/performance

Returns the team’s recent form: last N results, win/loss streak, and performance trend.

Metadata

Tournaments

GET /api/teams/{teamId}/unique-tournaments

Returns all competitions the team participates in.

Transfers

GET /api/teams/{teamId}/transfers

Returns the team’s player transactions: signings, departures, and trades.

Media

GET /api/teams/{teamId}/media

Returns media content associated with the team.

Available Seasons

Discover which seasons have data available:

GET /api/teams/{teamId}/player-statistics/seasons
GET /api/teams/{teamId}/standings/seasons
GET /api/teams/{teamId}/team-statistics/seasons

Example Requests

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

const response = await fetch(
  'https://api.sportsapipro.com/v2/basketball/teams/3427/players',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const roster = await response.json();

import requests

response = requests.get(
    'https://api.sportsapipro.com/v2/basketball/teams/3427/players',
    headers={'x-api-key': 'YOUR_API_KEY'}
)
roster = response.json()

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Base URL

Team Profile

Team Details

Team Roster / Players

Team Image

Events

Last Events (Paginated)

Next Events (Paginated)

Near Events

Featured Event

Statistics

Team Statistics in Tournament Season

Performance / Recent Form

Metadata

Tournaments

Transfers

Media

Available Seasons

Example Requests

​Base URL

​Team Profile

​Team Details

​Team Roster / Players

​Team Image

​Events

​Last Events (Paginated)

​Next Events (Paginated)

​Near Events

​Featured Event

​Statistics

​Team Statistics in Tournament Season

​Performance / Recent Form

​Metadata

​Tournaments

​Transfers

​Media

​Available Seasons

​Example Requests

Base URL

Team Profile

Team Details

Team Roster / Players

Team Image

Events

Last Events (Paginated)

Next Events (Paginated)

Near Events

Featured Event

Statistics

Team Statistics in Tournament Season

Performance / Recent Form

Metadata

Tournaments

Transfers

Media

Available Seasons

Example Requests