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ónPermalink for this section

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

Parámetros de consultaPermalink for this section

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

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

RespuestaPermalink for this section

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

Esquema del objeto TeamPermalink for this section

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

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

Mapeo de nombres de equiposPermalink for this section

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

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

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

Endpoints relacionadosPermalink for this section

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