Live-Event-Monitoring
Mit SofaScore-Endpunkten verwandelst du live-event-monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Medien & Streaming109 aktive EndpunkteapiKey
SofaScore API
Live-Sportevents, Teams, Spieler, Tabellen, Aufstellungen, Quoten, Ereignisse, Statistiken und historische Duelldaten von SofaScore als normalisiertes JSON sammeln.
Öffentliche SofaScore-Live-Events, Teams, Spieler, Tabellen, Match-Statistiken, Aufstellungen, Quoten, Ereignisse und historische Duelldaten als strukturiertes JSON extrahieren.
Endpunkt-Familien
6
Dokumentierte Parameter
310
Beispiele
109
Live-Katalog-Snapshot
SofaScore-Abdeckung
Aktive Endpunkte
109
Methoden
GET
Pflichtparameter
267
Schema-Referenzen
109
Categories1
Category Tournaments1
Draft1
Draft Picks1
{
"platform": "SofaScore",
"endpoint": "sofascore-search",
"method": "GET",
"path": "/sofascore/search",
"auth": "apiKey"
}Use Cases
Workflows, die zu SofaScore passen
Öffentliche SofaScore-Live-Events, Teams, Spieler, Tabellen, Match-Statistiken, Aufstellungen, Quoten, Ereignisse und historische Duelldaten als strukturiertes JSON extrahieren.
Anreicherung von Team- und Spielerdaten
Mit SofaScore-Endpunkten verwandelst du anreicherung von team- und spielerdaten in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Sportdatenanalyse
Mit SofaScore-Endpunkten verwandelst du sportdatenanalyse in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Managed Execution
So verarbeitet Crawlora diese Plattform
Jede Zahl unten stammt direkt aus dem Live-SofaScore-Endpunktkatalog — 109 Endpunkte, 310 dokumentierte Request-Parameter und 109 veröffentlichte Response-Schemas — demselben Katalog, gegen den auch Docs und Playground laufen.
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.
Abdeckungskarte
Wissen, was die API sammeln kann, bevor du integrierst
1 Endpunkte
Categories
/sofascore/categories
GETapiKey
1 Endpunkte
Category Tournaments
/sofascore/category-tournaments
GETapiKey
1 Endpunkte
Draft
/sofascore/draft
GETapiKey
1 Endpunkte
Draft Picks
/sofascore/draft-picks
GETapiKey
1 Endpunkte
Esports Game
/sofascore/esports-game
GETapiKey
1 Endpunkte
Event
/sofascore/event
GETapiKey
Ausgewählte Endpunkte
SofaScore-API-Endpunkte
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.
Hinweise zur Response
- 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.
MCP-Tool 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.
Hinweise zur Response
- 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.
MCP-Tool 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.
Hinweise zur Response
- `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).
MCP-Tool 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.
Hinweise zur Response
- 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`.
MCP-Tool 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.
Hinweise zur Response
- 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.
MCP-Tool 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.
Hinweise zur Response
- 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`.
MCP-Tool sofascore_event_incidents
id:queryx-api-key:header
Verwandte APIs
Weitere Abdeckung im Bereich medien & 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.
So scrapst du SofaScore
SofaScore-Daten in 4 Schritten extrahieren
SofaScore bietet keine dokumentierte API für Drittentwickler:innen, weshalb alle Integrationen dieselbe öffentliche JSON-Schnittstelle auslesen. Crawloras 15 SofaScore-Endpunkte kapseln diese Schnittstelle: Jeder Aufruf ist ein per x-api-key authentifizierter GET-Request, und Team-, Spieler- und Event-IDs stammen alle aus dem Such-Endpunkt.
- Schritt 1
IDs über die Suche ermitteln
Sende eine Freitextsuche (q=barcelona) an den SofaScore-Such-Endpunkt und erhalte passende Teams, Spieler und Events samt numerischer ID und Sportart.
- Schritt 2
Den passenden Endpunkt wählen
Event-, Statistik-, Aufstellungs-, Ereignis-, Quoten- und Duell-Endpunkte akzeptieren eine Event-ID; Team-, Team-Spielplan-, Team-Spieler- und Spieler-Endpunkte ihre jeweilige ID; Tabellen- und Runden-Spielplan-Endpunkte akzeptieren zusätzlich season.
- Schritt 3
Mit deinem API-Key aufrufen
Jeder SofaScore-Endpunkt ist ein GET-Request mit x-api-key-Header — kein SofaScore-Login, Cookie oder Session-Token nötig.
- Schritt 4
Cache-Fenster beim Polling beachten
Rufe Live-Events für Fußball, Basketball oder Tennis ab und nutze Event-IDs für Details. Erfolgreiche Statistikantworten werden standardmäßig 10 Minuten, echte Nicht-gefunden-Ergebnisse 30 Minuten gecacht; sofortige Wiederholungen zeigen neue Daten daher nicht früher.
Client-Bibliotheken
Offizielle Client-Pakete für die SofaScore API
Installiere den dedizierten SofaScore-Client für deine Sprache. Jedes Paket deckt die SofaScore-Endpunkte dieser Seite ab und ruft die gehostete Crawlora API mit deinem API-Key auf.
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
FAQ
SofaScore scrapen: häufige Fragen
Gibt es eine offizielle SofaScore-API? Brauche ich einen SofaScore-API-Key?
SofaScore bietet keine dokumentierte API oder ein Developer-Programm für Drittparteien, daher gibt es keinen SofaScore-API-Key, den man beantragen könnte. Hinter der App steckt eine öffentliche, credential-freie JSON-Schnittstelle, die alle Integrationen auslesen. Crawlora ist nicht mit SofaScore verbunden — es normalisiert diese öffentliche Schnittstelle zu stabilen, dokumentierten Endpunkten, die du mit deinem eigenen Crawlora-Key im x-api-key-Header authentifizierst. Der kostenlose Plan enthält 2000 Credits pro Monat, ohne Kreditkarte, abgerechnet nach erfolgreichem Aufruf.
Wie bekomme ich SofaScore-IDs für Spieler, Teams oder Events?
Nutze den Such-Endpunkt. Er akzeptiert den Freitextparameter q und liefert passende Teams, Spieler und Events samt numerischer id, Slug, Sportart und Land — genau die IDs, die alle anderen SofaScore-Endpunkte benötigen. Eine leere Ergebnisliste ist bei keinem Treffer eine gültige Antwort.
Welchen api.sofascore.com-Pfaden entsprechen Crawloras Endpunkte?
Jede Antwort trägt ein source_url-Feld mit der Herkunft, die Zuordnung ist also direkt in der Antwort sichtbar — der Spieler-Endpunkt zeigt z. B. https://api.sofascore.com/api/v1/player/<id>, der Such-Endpunkt https://api.sofascore.com/api/v1/search/all?q=<query>. Ein fetched_at-Zeitstempel zeigt zusätzlich, wie aktuell die Daten sind.
Kann ich Live-Spielstände und In-Game-Statistiken abrufen?
Ja. Der Live-Event-Endpunkt liefert laufende Spiele für Fußball, Basketball oder Tennis; eine leere Liste ist gültig, wenn nichts läuft. Statistik-Erfolge werden standardmäßig 10 Minuten, echte 404-Antworten 30 Minuten gecacht. Eine 404 zählt zum Request-Rate-Limit des Plans, verbraucht aber keine Credits. Aufstellungen liefern ebenfalls 404, wenn sie fehlen — auch bei einer ausdrücklich unbestätigten Upstream-Antwort mit leeren Spielerlisten beider Teams; vorhergesagte Aufstellungen mit Spielern bleiben gültig.
Ist das Scrapen von SofaScore legal?
Das Sammeln öffentlich zugänglicher Sportdaten unterscheidet sich meist vom Zugriff auf private Konten, ist aber nicht bedingungslos zulässig. Sammle ausschließlich öffentliche Daten, halte dich an SofaScores Bedingungen und Ratenlimits, und prüfe vor Weiterverbreitung die entsprechenden Rechte — Spielplan- und Quotendaten können eigenen Lizenzanforderungen unterliegen. Das ist keine Rechtsberatung; prüfe vor kommerzieller Nutzung die Rechtslage in deiner Region.