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ónEnlace permanente a esta sección

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

Parámetros de consultaEnlace permanente a esta sección

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 solicitudesEnlace permanente a esta sección

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

RespuestaEnlace permanente a esta sección

Éxito (200)Enlace permanente a esta sección


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

Esquema del objeto TeamEnlace permanente a esta sección

Campo	Tipo	Descripción
`id`	string	Identificador único del equipo (formato slug, p. ej., `atlanta-dream`)
`name`	string	Nombre para mostrar (p. ej., `Atlanta Dream`)
`sport`	string	Deporte principal (p. ej., `basketball`, `soccer`, `football`, `hockey`)
`leagues`	array	Ligas en las que aparece este equipo (p. ej., `["NBA", "WNBA"]`)
`aliases`	array	Nombres alternativos utilizados por diferentes sportsbooks (p. ej., `["Atlanta Dream", "ATL Dream"]`)
`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 MetaEnlace permanente a esta sección

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 usoEnlace permanente a esta sección

Mapeo de nombres de equiposEnlace permanente a esta sección

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 / AutocompletadoEnlace permanente a esta sección

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 activosEnlace permanente a esta sección

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

Endpoints relacionadosEnlace permanente a esta sección

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