Teams

Look up teams and players across all sports and leagues. Returns team names, aliases, league memberships, and current event counts. Useful for building search/autocomplete, mapping team names across sportsbooks, and understanding what’s currently active.


GET /api/v1/teams

Authentication

Public endpoint. No API key required.

Query Parameters

Parameter	Type	Default	Description
`sport`	string	all	Filter by sport (e.g., `basketball`, `football`, `soccer`)
`league`	string	all	Filter by league (e.g., `NBA`, `NFL`, `EPL`)
`q`	string	-	Search teams by name or alias (case-insensitive)

The q parameter searches both the team name and aliases fields. For example, q=man city will match “Manchester City” via its alias.

Example Requests

cURL


# Get all NBA teams
curl "https://api.sharpapi.io/api/v1/teams?league=NBA"
 
# Search for a team by name
curl "https://api.sharpapi.io/api/v1/teams?q=lakers"
 
# Get all basketball teams
curl "https://api.sharpapi.io/api/v1/teams?sport=basketball"

JavaScript


// Search for a team
const response = await fetch(
  'https://api.sharpapi.io/api/v1/teams?q=arsenal'
);
const { data, meta } = await response.json();
 
data.forEach(team => {
  console.log(`${team.name} (${team.sport}) - ${team.event_count} events`);
  if (team.aliases.length) {
    console.log(`  Also known as: ${team.aliases.join(', ')}`);
  }
});

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/teams',
    params={'sport': 'basketball', 'league': 'NBA'}
)
result = response.json()
 
print(f"Found {result['meta']['count']} NBA teams")
for team in result['data'][:10]:
    aliases = ', '.join(team['aliases']) if team['aliases'] else 'none'
    print(f"  {team['name']} ({team['id']}) - aliases: {aliases}")

Response

Success (200)


{
  "data": [
    {
      "id": "arsenal",
      "name": "Arsenal",
      "sport": "soccer",
      "leagues": [
        "EPL",
        "England - FA Cup",
        "England - Premier League",
        "England - EFL Cup"
      ],
      "aliases": [
        "Arsenal Fc"
      ],
      "event_count": 18,
      "live_count": 0
    },
    {
      "id": "alabama-crimson-tide",
      "name": "Alabama Crimson Tide",
      "sport": "basketball",
      "leagues": [
        "NCAAB"
      ],
      "aliases": [
        "Alabama",
        "Bama",
        "Crimson Tide"
      ],
      "event_count": 6,
      "live_count": 0
    }
  ],
  "meta": {
    "count": 15038,
    "sport_filter": null,
    "league_filter": null,
    "query": null,
    "total_events": 17113,
    "total_live": 13160,
    "updated": "2026-02-11T21:00:00.000Z"
  }
}

Team Object Schema

Field	Type	Description
`id`	string	Unique team identifier (slug format, e.g., `alabama-crimson-tide`)
`name`	string	Display name (e.g., `Alabama Crimson Tide`)
`sport`	string	Primary sport (e.g., `basketball`, `soccer`, `football`, `hockey`)
`leagues`	array	Leagues this team appears in (e.g., `["NBA", "NCAAB"]`)
`aliases`	array	Alternative names used by different sportsbooks (e.g., `["Alabama", "Bama"]`)
`event_count`	integer	Number of current events involving this team
`live_count`	integer	Number of currently live events involving this team

Meta Object

Field	Type	Description
`count`	integer	Total teams returned
`sport_filter`	string \| null	Echo of the `sport` filter applied
`league_filter`	string \| null	Echo of the `league` filter applied
`query`	string \| null	Echo of the `q` search query
`total_events`	integer	Total events across all returned teams
`total_live`	integer	Total live events across all returned teams
`updated`	string	ISO 8601 timestamp of when team data was last refreshed

Use Cases

Team Name Mapping

Different sportsbooks use different names for the same team. The aliases field helps you map across books:


curl "https://api.sharpapi.io/api/v1/teams?q=man%20city"


{
  "id": "manchester-city",
  "name": "Manchester City",
  "aliases": ["Man City", "Manchester City Fc", "Man. City"]
}

Search / Autocomplete

Use the q parameter to power a search-as-you-type UI:


curl "https://api.sharpapi.io/api/v1/teams?q=lak"

Active Teams

Filter by event_count or live_count client-side to show only teams with current or live events.

Events - Get events for specific teams
Leagues - List available leagues
Sports - List available sports