Live-Event-Monitoring
Mit SofaScore-Endpunkten verwandelst du live-event-monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Medien & Streaming15 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
36
Beispiele
15
Live-Katalog-Snapshot
SofaScore-Abdeckung
Aktive Endpunkte
15
Methoden
GET
Pflichtparameter
35
Schema-Referenzen
15
Event1
Event H2h1
Event Incidents1
Event Lineups1
{
"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 — 15 Endpunkte, 36 dokumentierte Request-Parameter und 15 veröffentlichte Response-Schemas — demselben Katalog, gegen den auch Docs und Playground laufen.
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.
Abdeckungskarte
Wissen, was die API sammeln kann, bevor du integrierst
Diese Karten werden aus dem aktiven Endpunktkatalog generiert, damit die Landingpage dieselbe API-Oberfläche widerspiegelt, die auch Docs und Playground nutzen.
1 Endpunkte
Event
/sofascore/event
GETapiKey
1 Endpunkte
Event H2h
/sofascore/event-h2h
GETapiKey
1 Endpunkte
Event Incidents
/sofascore/event-incidents
GETapiKey
1 Endpunkte
Event Lineups
/sofascore/event-lineups
GETapiKey
1 Endpunkte
Event Odds
/sofascore/event-odds
GETapiKey
1 Endpunkte
Event Statistics
/sofascore/event-statistics
GETapiKey
Ausgewählte Endpunkte
SofaScore-API-Endpunkte
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.
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. 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" } ] } } ```
MCP-Tool 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.
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. 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 } } ] } } ```
MCP-Tool 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.
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). 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 } } } ```
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) from SofaScore's credential-free public JSON. Returns 404 when SofaScore has no tracked statistics for the match.
Hinweise zur Response
- 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%" } ] } ] } ] } } ```
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, from SofaScore's credential-free public JSON. Returns 404 when SofaScore has no lineups for the match.
Hinweise zur Response
- 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": [] } } } ```
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's credential-free public JSON. An empty `incidents` list is a valid response before kickoff.
Hinweise zur Response
- 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" } ] } } ```
MCP-Tool sofascore_event_incidents
id:queryx-api-key:header
Verwandte APIs
Weitere Abdeckung im Bereich medien & streaming
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.
Media & Streaming
Ticketmaster
Search public Ticketmaster events and browse the full discovery hierarchy by category or city, with pagination plus event, attraction, and venue detail endpoints -- including fan reviews, related attractions, trending attractions, and enhanced venue branding -- for live-entertainment research.
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
Live-Daten pollen oder Datensätze im Batch aufbauen
Polle Live-Events nach Sportart (Fußball, Basketball oder Tennis) für In-Game-Daten, oder iteriere über IDs der Detail-Endpunkte, um Tabellen-, Spielplan- oder Aufstellungsdatensätze aufzubauen.
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. Die Live-Event-Endpunkte liefern die gerade laufenden Spiele einer Sportart — Fußball, Basketball oder Tennis; eine leere Eventliste ist bei keinem laufenden Spiel eine gültige Antwort. Mit einer Event-ID kannst du anschließend Statistiken, Aufstellungen, Ereignisse, Quoten und historische Duelldaten abrufen.
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.