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 streaming15 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
36
Ejemplos
15
Snapshot en vivo del catálogo
Cobertura de SofaScore
Endpoints activos
15
Métodos
GET
Parámetros obligatorios
35
Referencias de esquema
15
Event1
Event H2h1
Event Incidents1
Event Lineups1
{
"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 — 15 endpoints, 36 parámetros de solicitud documentados y 15 esquemas de respuesta publicados — el mismo catálogo contra el que corren Docs y Playground.
Documented endpoint coverage
15 documented SofaScore endpoints, grouped into 15 request families — Event, Event H2h and Event Incidents, plus 12 more.
Published request surface
36 request parameters are documented across those SofaScore endpoints, 35 of them required — the full input contract is public before you write any integration code.
Known response shape
15 of the 15 SofaScore endpoints ship a recorded example response, and 15 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
15 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
Estas tarjetas se generan a partir del catálogo de endpoints activo, así que la landing page refleja la misma superficie de API que usan Docs y Playground.
1 endpoints
Event
/sofascore/event
GETapiKey
1 endpoints
Event H2h
/sofascore/event-h2h
GETapiKey
1 endpoints
Event Incidents
/sofascore/event-incidents
GETapiKey
1 endpoints
Event Lineups
/sofascore/event-lineups
GETapiKey
1 endpoints
Event Odds
/sofascore/event-odds
GETapiKey
1 endpoints
Event Statistics
/sofascore/event-statistics
GETapiKey
Endpoints destacados
Endpoints de la API de SofaScore
GETapiKeyexample
/sofascore/searchSofaScore universal search
Searches SofaScore's credential-free public JSON 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. Example response: ```json { "code": 200, "msg": "OK", "data": { "query": "barcelona", "count": 2, "source_url": "https://api.sofascore.com/api/v1/search/all?q=barcelona", "fetched_at": "2026-07-08T16:45:00Z", "results": [ { "type": "team", "id": 2817, "name": "FC Barcelona", "slug": "barcelona", "sport": "Football", "country": "Spain" }, { "type": "player", "id": 1102841, "name": "Alejandro Balde", "slug": "alejandro-balde", "team_id": 2817, "team_name": "FC Barcelona" } ] } } ```
Herramienta MCP sofascore_search
q:queryx-api-key:header
GETapiKeyexample
/sofascore/live-eventsSofaScore live events
Returns currently live events for a sport from SofaScore's credential-free public JSON. The `sport` enum accepts `football`, `basketball`, and `tennis`. 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. Example response: ```json { "code": 200, "msg": "OK", "data": { "sport": "football", "count": 1, "source_url": "https://api.sofascore.com/api/v1/sport/football/events/live", "fetched_at": "2026-07-08T16:45:00Z", "events": [ { "id": 16467444, "slug": "pfc-cska-ii-sofia-fc-marek-1915-dupnitsa", "start_timestamp": 1751980800, "start_time": "2026-07-08T12:00:00Z", "status": { "code": 6, "description": "1st half", "type": "inprogress" }, "tournament": { "id": 1339, "name": "Club Friendly Games", "category": "World", "unique_tournament_id": 853, "unique_tournament_name": "Club Friendly Games" }, "home_team": { "id": 1, "name": "PFC CSKA II Sofia", "short_name": "CSKA II Sofia", "slug": "pfc-cska-ii-sofia", "country": "Bulgaria" }, "away_team": { "id": 2, "name": "FC Marek 1915 Dupnitsa", "short_name": "Marek Dupnitsa", "slug": "fc-marek-1915-dupnitsa", "country": "Bulgaria" }, "home_score": { "current": 0 }, "away_score": { "current": 1 } } ] } } ```
Herramienta MCP sofascore_live_events
sport:queryx-api-key:header
GETapiKeyexample
/sofascore/eventSofaScore event detail
Returns one match's detail (teams, score, status, venue, referee) from SofaScore's credential-free public JSON.
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). Example response: ```json { "code": 200, "msg": "OK", "data": { "source_url": "https://api.sofascore.com/api/v1/event/14025013", "fetched_at": "2026-07-08T16:45:00Z", "event": { "id": 14025013, "slug": "bournemouth-liverpool", "start_timestamp": 1755288000, "start_time": "2025-08-15T19:00:00Z", "status": { "code": 100, "description": "Ended", "type": "finished" }, "winner_code": 2, "tournament": { "id": 52, "name": "Premier League", "category": "England", "unique_tournament_id": 17, "unique_tournament_name": "Premier League" }, "home_team": { "id": 60, "name": "Bournemouth", "short_name": "Bournemouth", "slug": "bournemouth", "country": "England" }, "away_team": { "id": 44, "name": "Liverpool", "short_name": "Liverpool", "slug": "liverpool", "country": "England" }, "home_score": { "current": 2, "period1": 1, "period2": 1 }, "away_score": { "current": 4, "period1": 1, "period2": 3 }, "venue": { "name": "Vitality Stadium", "city": "Bournemouth", "country": "England", "capacity": 11307 }, "referee": { "id": 69853, "name": "Anthony Taylor", "country": "England" }, "attendance": 11036 } } } ```
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) from SofaScore's credential-free public JSON. Returns 404 when SofaScore has no tracked statistics for the match.
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. - 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`. Example response: ```json { "code": 200, "msg": "OK", "data": { "event_id": 14025013, "source_url": "https://api.sofascore.com/api/v1/event/14025013/statistics", "fetched_at": "2026-07-08T16:45:00Z", "periods": [ { "period": "ALL", "groups": [ { "name": "Match overview", "items": [ { "name": "Ball possession", "key": "ballPossession", "home": "61%", "away": "39%" } ] } ] } ] } } ```
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, from SofaScore's credential-free public JSON. Returns 404 when SofaScore has no lineups for the match.
Notas de la respuesta
- Returns `404` when SofaScore has no lineups for the match (not yet announced or not tracked). - `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. Example response: ```json { "code": 200, "msg": "OK", "data": { "event_id": 14025013, "confirmed": true, "source_url": "https://api.sofascore.com/api/v1/event/14025013/lineups", "fetched_at": "2026-07-08T16:45:00Z", "home": { "formation": "4-3-3", "players": [ { "player": { "id": 66101, "name": "Alisson", "short_name": "Alisson", "position": "G", "country": "Brazil" }, "jersey_number": "1", "position": "G", "substitute": false } ] }, "away": { "formation": "4-4-2", "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's credential-free public JSON. 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`. Example response: ```json { "code": 200, "msg": "OK", "data": { "event_id": 14025013, "count": 3, "source_url": "https://api.sofascore.com/api/v1/event/14025013/incidents", "fetched_at": "2026-07-08T16:45:00Z", "incidents": [ { "type": "goal", "time": 23, "is_home": true, "home_score": 1, "away_score": 0, "player": "A. Player" }, { "type": "card", "time": 60, "is_home": false, "card_color": "yellow", "player": "B. Player" }, { "type": "substitution", "time": 70, "is_home": true, "player_in": "C. Sub", "player_out": "A. Player" } ] } } ```
Herramienta MCP sofascore_event_incidents
id:queryx-api-key:header
APIs relacionadas
Más cobertura de medios y streaming
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.
Media & Streaming
Apple Books
Turn Apple Books ebook and audiobook pages into structured data — search, catalog detail, paginated customer reviews, similar titles, author bibliographies, series listings, and chart rankings as normalized JSON. Credential-free.
Cómo hacer scraping de SofaScore
Extrae datos de SofaScore en 4 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 datos en vivo o construir datasets en bloque
Consulta eventos en vivo por deporte (fútbol, baloncesto o tenis) para datos en tiempo real, o itera sobre IDs de los endpoints de detalle para construir datasets de tablas de posiciones, calendarios o alineaciones.
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í. Los endpoints de eventos en vivo devuelven los partidos en curso de un deporte — fútbol, baloncesto o tenis; una lista de eventos vacía es una respuesta válida cuando no hay partidos en curso. Con un ID de evento puedes luego obtener estadísticas, alineaciones, eventos, cuotas y datos históricos de enfrentamientos.
¿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.