Times

Consulte times e jogadores em todos os esportes e ligas. Retorna nomes de times, apelidos, vínculos com ligas e contagem atual de eventos. Útil para criar busca/autocompletar, mapear nomes de times entre sportsbooks e entender o que está atualmente ativo.


GET /api/v1/teams

Autenticação

Requer uma API key. Disponível em todos os planos (incluindo Free). Solicitações não autenticadas retornam 401.

Parâmetros de Consulta

Parâmetro	Tipo	Padrão	Descrição
`sport`	string	all	Filtrar por esporte (ex.: `basketball`, `football`, `soccer`)
`league`	string	all	Filtrar por liga (ex.: `NBA`, `NFL`, `EPL`)
`q`	string	-	Pesquisar times por nome ou apelido (não diferencia maiúsculas/minúsculas)

O parâmetro q pesquisa tanto o name quanto os campos aliases do time. Por exemplo, q=man city corresponderá a “Manchester City” através do seu apelido.

Exemplos de Requisições

cURL


# Obter todos os times da NBA
curl "https://api.sharpapi.io/api/v1/teams?league=NBA" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Pesquisar um time por nome
curl "https://api.sharpapi.io/api/v1/teams?q=lakers" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Obter todos os times de basquete
curl "https://api.sharpapi.io/api/v1/teams?sport=basketball" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


// Search for a team
const response = await fetch(
  'https://api.sharpapi.io/api/v1/teams?q=arsenal',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } },
);
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'},
    headers={'X-API-Key': 'YOUR_API_KEY'},
)
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}")

Resposta

Sucesso (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"
  }
}

Schema do Objeto Team

Campo	Tipo	Descrição
`id`	string	Identificador único do time (formato slug, ex.: `alabama-crimson-tide`)
`name`	string	Nome de exibição (ex.: `Alabama Crimson Tide`)
`sport`	string	Esporte principal (ex.: `basketball`, `soccer`, `football`, `hockey`)
`leagues`	array	Ligas em que este time aparece (ex.: `["NBA", "NCAAB"]`)
`aliases`	array	Nomes alternativos usados por diferentes sportsbooks (ex.: `["Alabama", "Bama"]`)
`event_count`	integer	Número de eventos atuais envolvendo este time
`live_count`	integer	Número de eventos atualmente ao vivo envolvendo este time

Objeto Meta

Campo	Tipo	Descrição
`count`	integer	Total de times retornados
`sport_filter`	string \| null	Eco do filtro `sport` aplicado
`league_filter`	string \| null	Eco do filtro `league` aplicado
`query`	string \| null	Eco da consulta de pesquisa `q`
`total_events`	integer	Total de eventos em todos os times retornados
`total_live`	integer	Total de eventos ao vivo em todos os times retornados
`updated`	string	Timestamp ISO 8601 de quando os dados dos times foram atualizados pela última vez

Casos de Uso

Mapeamento de Nomes de Times

Diferentes sportsbooks usam nomes diferentes para o mesmo time. O campo aliases ajuda a mapear entre as casas:


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"]
}

Pesquisa / Autocompletar

Use o parâmetro q para alimentar uma UI de pesquisa em tempo real:


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

Times Ativos

Filtre por event_count ou live_count no lado do cliente para mostrar apenas times com eventos atuais ou ao vivo.

Endpoints Relacionados

Events - Obter eventos para times específicos
Leagues - Listar ligas disponíveis
Sports - Listar esportes disponíveis