Monitoreo de eventos en vivo
Usa los endpoints de SofaScore para convertir monitoreo de eventos en vivo en solicitudes API repetibles con inputs documentados y respuestas JSON.
Medios y streaming109 endpoints activosapiKey
API de SofaScore
Recopila eventos deportivos en vivo, equipos, jugadores, tablas de posiciones, alineaciones, cuotas, eventos, estadísticas y datos históricos de enfrentamientos de SofaScore como JSON normalizado.
Extrae eventos en vivo, equipos, jugadores, tablas de posiciones, estadísticas de partidos, alineaciones, cuotas, eventos y datos históricos de enfrentamientos de SofaScore como JSON estructurado.
Familias de endpoints
6
Parámetros documentados
310
Ejemplos
109
Snapshot en vivo del catálogo
Cobertura de SofaScore
Endpoints activos
109
Métodos
GET
Parámetros obligatorios
267
Referencias de esquema
109
Categories1
Category Tournaments1
Draft1
Draft Picks1
{
"platform": "SofaScore",
"endpoint": "sofascore-search",
"method": "GET",
"path": "/sofascore/search",
"auth": "apiKey"
}Casos de uso
Workflows que encajan con SofaScore
Extrae eventos en vivo, equipos, jugadores, tablas de posiciones, estadísticas de partidos, alineaciones, cuotas, eventos y datos históricos de enfrentamientos de SofaScore como JSON estructurado.
Enriquecimiento de datos de equipos y jugadores
Usa los endpoints de SofaScore para convertir enriquecimiento de datos de equipos y jugadores en solicitudes API repetibles con inputs documentados y respuestas JSON.
Análisis de datos deportivos
Usa los endpoints de SofaScore para convertir análisis de datos deportivos en solicitudes API repetibles con inputs documentados y respuestas JSON.
Ejecución gestionada
Cómo maneja Crawlora esta plataforma
Cada cifra de abajo se lee directamente del catálogo de endpoints en vivo de SofaScore — 109 endpoints, 310 parámetros de solicitud documentados y 109 esquemas de respuesta publicados — el mismo catálogo contra el que corren Docs y Playground.
Documented endpoint coverage
109 documented SofaScore endpoints, grouped into 109 request families — Categories, Category Tournaments and Draft, plus 106 more.
Published request surface
310 request parameters are documented across those SofaScore endpoints, 267 of them required — the full input contract is public before you write any integration code.
Known response shape
109 of the 109 SofaScore endpoints ship a recorded example response, and 109 carry a documented response schema — you can code against the real JSON before the first request.
Documented failure modes
SofaScore endpoints document their error responses (400, 404, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
Agent-callable MCP tools
109 hosted MCP tools back the SofaScore endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Mapa de cobertura
Descubre qué puede recopilar la API antes de integrarla
1 endpoints
Categories
/sofascore/categories
GETapiKey
1 endpoints
Category Tournaments
/sofascore/category-tournaments
GETapiKey
1 endpoints
Draft
/sofascore/draft
GETapiKey
1 endpoints
Draft Picks
/sofascore/draft-picks
GETapiKey
1 endpoints
Esports Game
/sofascore/esports-game
GETapiKey
1 endpoints
Event
/sofascore/event
GETapiKey
Endpoints destacados
Endpoints de la API de SofaScore
GETapiKeyexample
/sofascore/searchSofaScore universal search
Searches SofaScore for teams, players, and competitions matching a free-text query. An empty `results` list is a valid response when nothing matches.
Notas de la respuesta
- An empty `results` array is a valid response when nothing matches the query (not an error). - Each result carries a `type` (e.g. `team`, `player`, `uniqueTournament`); player results also carry `team_id`/`team_name` for their current club. - A missing `q` value returns an invalid-parameter error before upstream IO.
Herramienta MCP sofascore_search
q:queryx-api-key:header
GETapiKeyexample
/sofascore/live-eventsSofaScore live events
Returns currently live events for a sport. The `sport` enum accepts `american-football`, `aussie-rules`, `badminton`, `bandy`, `baseball`, `basketball`, `beach-volley`, `cricket`, `darts`, `esports`, `floorball`, `football`, `futsal`, `handball`, `ice-hockey`, `mma`, `minifootball`, `padel`, `rugby`, `snooker`, `table-tennis`, `tennis`, `volleyball`, and `waterpolo`; the sports endpoint lists them. An empty `events` list is a valid response when nothing is live right now.
Notas de la respuesta
- An empty `events` array is a valid response when nothing is live right now (not an error). - Invalid `sport` values return an invalid-parameter error before upstream IO.
Herramienta MCP sofascore_live_events
sport:queryx-api-key:header
GETapiKeyexample
/sofascore/eventSofaScore event detail
Returns one SofaScore match by event id: home and away teams and scores, status, start time, tournament, attendance and winner code, plus venue and referee when SofaScore has them. An unknown or malformed id surfaces as an upstream error.
Notas de la respuesta
- `venue` and `referee` are omitted when SofaScore has no data for them (e.g. neutral/unconfirmed venues). - An unknown or malformed id surfaces as an upstream error (SofaScore returns 404 for a missing event).
Herramienta MCP sofascore_event
id:queryx-api-key:header
GETapiKeyexample
/sofascore/event-statisticsSofaScore event statistics
Returns one match's statistics (possession, shots, passes, and more, grouped and split by period). Returns 404 when SofaScore has no tracked statistics for the match.
Notas de la respuesta
- Successful responses are cached for 10 minutes by default. - A genuine not-found response is cached for 30 minutes by default. Repeating the same request during that window returns the cached `404`; upstream blocks and other failures are not cached by this policy. - Statistics can appear later for an upcoming or live match. A cached absence can delay their visibility by up to 30 minutes, so avoid immediate retries and recheck after that interval when new coverage is expected. - `404` responses consume the plan’s request-rate allowance but do not consume credits. - Returns `404` when SofaScore has no tracked statistics for the match (common for lower-tier/friendly fixtures). - `periods` groups statistics by period (e.g. `ALL`, `1ST`, `2ND`); each period has named `groups` (e.g. "Match overview", "Shots") of home/away `items`.
Herramienta MCP sofascore_event_statistics
id:queryx-api-key:header
GETapiKeyexample
/sofascore/event-lineupsSofaScore event lineups
Returns one match's starting XI and substitutes per side, with formation. Returns 404 when SofaScore has no lineups for the match. A missing-lineup result may be reused for up to two minutes before checking again.
Notas de la respuesta
- Returns `404` when SofaScore has no lineups for the match (not yet announced or not tracked). - A missing-lineup result may be reused for up to two minutes. Newly announced lineups can become visible after that window; upstream failures remain retryable. - An upstream `200` with `confirmed=false` and explicit empty player arrays on both sides also returns `404`. Predicted lineups with players remain valid; malformed or confirmed-empty payloads return `503`. - `confirmed` indicates whether the lineup is the official confirmed lineup rather than a predicted one. - `home`/`away` each carry a `formation` (e.g. `4-3-3`) and a `players` list; `substitute` marks bench players.
Herramienta MCP sofascore_event_lineups
id:queryx-api-key:header
GETapiKeyexample
/sofascore/event-incidentsSofaScore event incidents
Returns one match's goal, card, substitution, and period timeline from SofaScore. An empty `incidents` list is a valid response before kickoff.
Notas de la respuesta
- Successful responses are cached for 30 seconds, so repeated calls for the same event id within that window return the cached result rather than re-fetching from SofaScore. Errors are never cached. - An empty `incidents` array is a valid response before kickoff (not an error). - `type` is one of `period`, `goal`, `card`, `substitution`, `injuryTime`, or another SofaScore incident type; fields not relevant to a given type are omitted. - Card incidents carry `card_color` (`yellow` or `red`); substitutions carry `player_in`/`player_out`.
Herramienta MCP sofascore_event_incidents
id:queryx-api-key:header
APIs relacionadas
Más cobertura de medios y streaming
Media & Streaming
FUSSBALL.DE
Follow German football from the Bundesliga down to the lowest Kreisklasse. Discover competitions in all 22 federations, then read matchdays, standings, scorers, clubs, teams, and players from the DFB's own amateur-football portal.
Media & Streaming
Sportskeeda
Browse Sportskeeda's sports and entertainment coverage, community wikis, quizzes, and fan games with the catalog's current slugs and filter limits.
Media & Streaming
JustWatch
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
Cómo hacer scraping de SofaScore
Extrae datos de SofaScore en 5 pasos
SofaScore no ofrece una API documentada para desarrolladores externos, por lo que todas las integraciones leen la misma interfaz JSON pública. Los 15 endpoints de SofaScore de Crawlora encapsulan esa interfaz: cada llamada es una solicitud GET autenticada con el header x-api-key, y los IDs de equipos, jugadores y eventos provienen todos del endpoint de búsqueda.
- Paso 1
Obtener IDs mediante búsqueda
Envía una consulta de texto libre (q=barcelona) al endpoint de búsqueda de SofaScore para obtener equipos, jugadores y eventos coincidentes, cada uno con su ID numérico y deporte.
- Paso 2
Elegir el endpoint según lo que necesites
Los endpoints de evento, estadísticas, alineaciones, eventos, cuotas e historial de enfrentamientos aceptan un id de evento; los endpoints de equipo, calendario de equipo, jugadores de equipo y jugador aceptan su propio id; los endpoints de tabla de posiciones y calendario de jornada también aceptan season.
- Paso 3
Llamar con tu API key
Cada endpoint de SofaScore es una solicitud GET con el header x-api-key — sin inicio de sesión, cookies ni tokens de sesión de SofaScore.
- Paso 4
Consultar respetando las ventanas de caché
Obtén eventos en vivo de fútbol, baloncesto o tenis y usa sus IDs para el detalle. Las estadísticas correctas se guardan 10 minutos por defecto y los resultados reales de no encontrado 30 minutos, por lo que reintentar de inmediato no revela antes una cobertura nueva.
- Paso 5
Size the lookup routes before pulling events
On 2026-10-30 football categories returned 299 entries, category-tournaments for id 1 returned 20 tournaments with user_count, and NBA 2025 round-1 draft picks returned 30 picks plus 9 teams without a round-1 pick. Resolve ids with the lookup routes first.
Librerías cliente
Paquetes cliente oficiales para la API de SofaScore
Instala el cliente dedicado de SofaScore para tu lenguaje. Cada paquete cubre los endpoints de SofaScore de esta página y llama a la API alojada de Crawlora con tu clave de API.
JavaScript / TypeScript
npm install @crawlora-org/sofascorenpmPython
pip install crawlora-sofascorePyPIGo
go get github.com/Crawlora-org/crawlora-sofascorepkg.go.devRuby
gem install crawlora-sofascoreRubyGemsJava
net.crawlora:crawlora-sofascoreMaven CentralPHP
composer require crawlora/sofascorePackagistRust
cargo add crawlora-sofascorecrates.io
Agent Skills
Usa datos de SofaScore desde tu agente de código
Instala un agent skill de Crawlora y tu agente obtiene datos de SofaScore como JSON mediante la API documentada, sin escribir un scraper. Estos skills cubren SofaScore:
Football match (soccer) performance analysis
Explain a completed football (soccer) match from SofaScore statistics, incidents, and lineups, including beginner-friendly briefs for coaches or…
npx skills add github.com/Crawlora-org/crawlora-skills --skill football-match-performance-analysisSports betting research
Compare public sportsbook odds, live states, and source-attributed sports-market commentary across FanDuel, DraftKings, ESPN, SofaScore, and…
npx skills add github.com/Crawlora-org/crawlora-skills --skill sports-betting-researchSports & athletics research
Pulls sports scores, standings, rosters, player/team stats, public sports news, editorial, wiki/video content, and betting odds through the Crawlora…
npx skills add github.com/Crawlora-org/crawlora-skills --skill sports-scores-research
Preguntas frecuentes
Scraping de SofaScore: preguntas frecuentes
¿Existe una API oficial de SofaScore? ¿Necesito una API key de SofaScore?
SofaScore no ofrece una API documentada ni un programa para desarrolladores externos, por lo que no existe una API key de SofaScore que solicitar. Detrás de su app hay una interfaz JSON pública sin credenciales que todas las integraciones leen. Crawlora no está afiliada a SofaScore — normaliza esa interfaz pública en endpoints estables y documentados que autenticas con tu propia key de Crawlora en el header x-api-key. El plan gratuito incluye 2000 créditos al mes, sin tarjeta de crédito, facturado por llamada exitosa.
¿Cómo obtengo IDs de SofaScore para jugadores, equipos o eventos?
Usa el endpoint de búsqueda. Acepta el parámetro de texto libre q y devuelve equipos, jugadores y eventos coincidentes con su id numérico, slug, deporte y país — exactamente los IDs que necesitan el resto de endpoints de SofaScore. Una lista de resultados vacía es una respuesta válida cuando no hay coincidencias.
¿A qué rutas de api.sofascore.com corresponden los endpoints de Crawlora?
Cada respuesta incluye un campo source_url con su origen, así que la correspondencia es visible en la propia respuesta — por ejemplo, el endpoint de jugador muestra https://api.sofascore.com/api/v1/player/<id>, y el de búsqueda muestra https://api.sofascore.com/api/v1/search/all?q=<query>. Las respuestas también incluyen una marca de tiempo fetched_at para saber qué tan reciente es el dato.
¿Puedo obtener marcadores en vivo y estadísticas en tiempo real?
Sí. El endpoint de eventos en vivo devuelve partidos en curso de fútbol, baloncesto o tenis; una lista vacía es válida cuando no hay ninguno. Las estadísticas correctas se guardan 10 minutos por defecto y un 404 real 30 minutos. El 404 cuenta para el límite de solicitudes del plan, pero no consume créditos. Las alineaciones también devuelven 404 cuando no están disponibles, incluida una respuesta upstream no confirmada con listas de jugadores explícitamente vacías; las alineaciones previstas con jugadores siguen siendo válidas.
¿Es legal hacer scraping de SofaScore?
Recopilar datos deportivos públicamente accesibles suele distinguirse del acceso a cuentas privadas, pero no es incondicional. Recopila solo datos públicos, respeta los términos y límites de tasa de SofaScore, y verifica los derechos correspondientes antes de reenviar o redistribuir — los datos de calendarios y cuotas deportivas pueden tener requisitos de licencia independientes. Esto no es asesoramiento legal; verifica la legislación de tu región antes de un uso comercial.