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çãoPermalink for this section

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

Parâmetros de ConsultaPermalink for this section

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çõesPermalink for this section

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

RespostaPermalink for this section

Sucesso (200)Permalink for this section


{
  "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 TeamPermalink for this section

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 MetaPermalink for this section

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 UsoPermalink for this section

Mapeamento de Nomes de TimesPermalink for this section

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 / AutocompletarPermalink for this section

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 AtivosPermalink for this section

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

Endpoints RelacionadosPermalink for this section

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