Equipos

Consulta equipos y jugadores en todos los deportes y ligas. Devuelve nombres de equipos, alias, pertenencia a ligas y recuentos de eventos actuales. Útil para crear búsquedas/autocompletado, mapear nombres de equipos entre sportsbooks y comprender qué está activo en este momento.


GET /api/v1/teams

Autenticación

Requiere una API key. Disponible en todos los planes (Free incluido). Las solicitudes no autenticadas devuelven 401.

Parámetros de consulta

Parámetro	Tipo	Por defecto	Descripción
`sport`	string	all	Filtrar por deporte (p. ej., `basketball`, `football`, `soccer`)
`league`	string	all	Filtrar por liga (p. ej., `NBA`, `NFL`, `EPL`)
`q`	string	-	Buscar equipos por nombre o alias (no distingue mayúsculas/minúsculas)

El parámetro q busca tanto en el campo name como en aliases del equipo. Por ejemplo, q=man city coincidirá con “Manchester City” a través de su alias.

Ejemplos de solicitudes

cURL


# Obtener todos los equipos de la NBA
curl "https://api.sharpapi.io/api/v1/teams?league=NBA" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Buscar un equipo por nombre
curl "https://api.sharpapi.io/api/v1/teams?q=lakers" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Obtener todos los equipos de baloncesto
curl "https://api.sharpapi.io/api/v1/teams?sport=basketball" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


// Buscar un equipo
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}")

Respuesta

Éxito (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"
  }
}

Esquema del objeto Team

Campo	Tipo	Descripción
`id`	string	Identificador único del equipo (formato slug, p. ej., `alabama-crimson-tide`)
`name`	string	Nombre para mostrar (p. ej., `Alabama Crimson Tide`)
`sport`	string	Deporte principal (p. ej., `basketball`, `soccer`, `football`, `hockey`)
`leagues`	array	Ligas en las que aparece este equipo (p. ej., `["NBA", "NCAAB"]`)
`aliases`	array	Nombres alternativos utilizados por diferentes sportsbooks (p. ej., `["Alabama", "Bama"]`)
`event_count`	integer	Número de eventos actuales que involucran a este equipo
`live_count`	integer	Número de eventos en directo actuales que involucran a este equipo

Objeto Meta

Campo	Tipo	Descripción
`count`	integer	Total de equipos devueltos
`sport_filter`	string \| null	Reflejo del filtro `sport` aplicado
`league_filter`	string \| null	Reflejo del filtro `league` aplicado
`query`	string \| null	Reflejo de la consulta de búsqueda `q`
`total_events`	integer	Total de eventos en todos los equipos devueltos
`total_live`	integer	Total de eventos en directo en todos los equipos devueltos
`updated`	string	Marca de tiempo ISO 8601 de la última actualización de los datos de equipos

Casos de uso

Mapeo de nombres de equipos

Diferentes sportsbooks utilizan distintos nombres para el mismo equipo. El campo aliases te ayuda a mapear entre casas de apuestas:


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

Búsqueda / Autocompletado

Utiliza el parámetro q para alimentar una interfaz de búsqueda mientras el usuario escribe:


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

Equipos activos

Filtra por event_count o live_count en el lado del cliente para mostrar solo los equipos con eventos actuales o en directo.

Endpoints relacionados

Events - Obtener eventos para equipos específicos
Leagues - Listar ligas disponibles
Sports - Listar deportes disponibles