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çãoLink permanente para esta seção

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

Parâmetros de ConsultaLink permanente para esta seção

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çõesLink permanente para esta seção

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

RespostaLink permanente para esta seção

Sucesso (200)Link permanente para esta seção


{
  "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": "atlanta-dream",
      "name": "Atlanta Dream",
      "sport": "basketball",
      "leagues": [
        "WNBA"
      ],
      "aliases": [
        "Atlanta Dream",
        "ATL Dream"
      ],
      "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 TeamLink permanente para esta seção

Campo	Tipo	Descrição
`id`	string	Identificador único do time (formato slug, ex.: `atlanta-dream`)
`name`	string	Nome de exibição (ex.: `Atlanta Dream`)
`sport`	string	Esporte principal (ex.: `basketball`, `soccer`, `football`, `hockey`)
`leagues`	array	Ligas em que este time aparece (ex.: `["NBA", "WNBA"]`)
`aliases`	array	Nomes alternativos usados por diferentes sportsbooks (ex.: `["Atlanta Dream", "ATL Dream"]`)
`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 MetaLink permanente para esta seção

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 UsoLink permanente para esta seção

Mapeamento de Nomes de TimesLink permanente para esta seção

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 / AutocompletarLink permanente para esta seção

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 AtivosLink permanente para esta seção

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

Endpoints RelacionadosLink permanente para esta seção

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