ライブ試合のモニタリング
SofaScoreエンドポイントを使えば、「ライブ試合のモニタリング」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
SofaScoreのライブスポーツ試合、チーム、選手、順位表、フォーメーション、オッズ、イベント、統計、対戦成績データを正規化JSONで収集できます。
公開されているSofaScoreのライブ試合、チーム、選手、順位表、試合統計、フォーメーション、オッズ、イベント、対戦成績データを構造化JSONとして抽出できます。
エンドポイントファミリー
6
ドキュメント化されたパラメータ
36
サンプル数
15
ライブカタログスナップショット
稼働エンドポイント
15
メソッド
GET
必須パラメータ
35
スキーマ参照
15
{
"platform": "SofaScore",
"endpoint": "sofascore-search",
"method": "GET",
"path": "/sofascore/search",
"auth": "apiKey"
}ユースケース
公開されているSofaScoreのライブ試合、チーム、選手、順位表、試合統計、フォーメーション、オッズ、イベント、対戦成績データを構造化JSONとして抽出できます。
SofaScoreエンドポイントを使えば、「ライブ試合のモニタリング」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
SofaScoreエンドポイントを使えば、「チーム・選手データの拡充」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
SofaScoreエンドポイントを使えば、「スポーツデータ分析」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のSofaScoreエンドポイントカタログから取得しています(エンドポイント15件、ドキュメント化されたリクエストパラメータ36個、公開レスポンススキーマ15件)。DocsとPlaygroundが参照しているカタログと同じものです。
SofaScoreのエンドポイントは15件、15つのリクエストファミリーに分類されています(Event、Event H2h、Event Incidentsほか12件)。
これらのSofaScoreエンドポイントには36個のリクエストパラメータがドキュメント化されており、うち35個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
15件のSofaScoreエンドポイントのうち15件が実際のサンプルレスポンスを、15件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
SofaScoreのエンドポイントは成功時のスキーマに加えてエラーレスポンス(400、404、429、503)もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
SofaScoreのエンドポイントは15個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
これらのカードは稼働中のエンドポイントカタログから生成されるため、このページはDocsとPlaygroundが使うAPIサーフェスをそのまま反映します。
/sofascore/event
/sofascore/event-h2h
/sofascore/event-incidents
/sofascore/event-lineups
/sofascore/event-odds
/sofascore/event-statistics
主要エンドポイント
/sofascore/searchSearches 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.
レスポンスに関する注記
- 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ツール sofascore_search
/sofascore/live-eventsReturns 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.
レスポンスに関する注記
- 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ツール sofascore_live_events
/sofascore/eventReturns one match's detail (teams, score, status, venue, referee) from SofaScore's credential-free public JSON.
レスポンスに関する注記
- `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ツール sofascore_event
/sofascore/event-statisticsReturns 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.
レスポンスに関する注記
- 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ツール sofascore_event_statistics
/sofascore/event-lineupsReturns 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.
レスポンスに関する注記
- 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ツール sofascore_event_lineups
/sofascore/event-incidentsReturns 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.
レスポンスに関する注記
- 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ツール sofascore_event_incidents
関連API
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
Media & Streaming
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
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.
SofaScoreのスクレイピング方法
SofaScoreはサードパーティ開発者向けにドキュメント化されたAPIを提供していないため、あらゆる統合先は同じ公開JSONインターフェースを読み取っています。Crawloraの15個のSofaScoreエンドポイントはこのインターフェースをラップしており、各呼び出しはx-api-keyヘッダーで認証されるGETリクエストです。チーム・選手・試合のIDはすべて検索エンドポイントから取得します。
SofaScoreの検索エンドポイントにフリーテキストのクエリ(q=barcelona)を送ると、該当するチーム・選手・試合が数値IDとスポーツ種目とともに返されます。
試合、統計、フォーメーション、イベント、オッズ、対戦成績のエンドポイントはevent idを受け付け、チーム、チームの試合日程、チームの選手、選手のエンドポイントはそれぞれのidを受け付けます。順位表と節ごとの試合日程エンドポイントはさらにseasonも受け付けます。
各SofaScoreエンドポイントはx-api-keyヘッダー付きのGETリクエストです。SofaScoreへのログイン、Cookie、セッショントークンは不要です。
スポーツ種目(サッカー、バスケットボール、テニス)ごとにライブ試合をポーリングして試合中のデータを取得するか、各詳細エンドポイントのIDを巡回して順位表・日程・フォーメーションのデータセットを構築します。
FAQ
SofaScoreはサードパーティ向けにドキュメント化されたAPIや開発者プログラムを提供していないため、申請できるSofaScore APIキーは存在しません。そのアプリの背後には認証不要の公開JSONインターフェースがあり、あらゆる統合先はそれを読み取っています。CrawloraはSofaScoreと提携関係にありません。この公開インターフェースを、x-api-keyヘッダーでご自身のCrawloraキーを使って認証する、安定したドキュメント化済みエンドポイントに正規化しています。無料プランは月2000クレジットを含み、クレジットカード不要で、成功呼び出しごとに課金されます。
検索エンドポイントを使用してください。フリーテキストパラメータqを受け付け、該当するチーム・選手・試合を数値id、slug、スポーツ種目、国とともに返します。これらのIDが他のすべてのSofaScoreエンドポイントに必要な値です。一致する結果がない場合、空の結果リストも正常なレスポンスです。
各レスポンスには収集元を示すsource_urlフィールドが含まれるため、対応関係はレスポンス自体から確認できます。例えば選手のエンドポイントはhttps://api.sofascore.com/api/v1/player/<id>を、検索エンドポイントはhttps://api.sofascore.com/api/v1/search/all?q=<query>を表示します。レスポンスにはfetched_atのタイムスタンプも含まれるため、データの鮮度を判断できます。
はい。ライブ試合エンドポイントは、あるスポーツ(サッカー、バスケットボール、テニス)で現在進行中の試合を返します。進行中の試合がない場合は空の試合リストも正常なレスポンスです。試合IDを取得すれば、統計、フォーメーション、イベント、オッズ、対戦成績データをさらに取得できます。
公開されているスポーツデータの収集は、一般にプライベートアカウントへのアクセスとは区別されますが、それは無条件に成立するわけではありません。公開データのみを収集し、SofaScoreの規約とレート制限を遵守し、転送や再配布の前に該当する権利を確認してください。スポーツの日程やオッズデータには個別のライセンス要件がある場合があります。これは法的助言ではありません。商用利用の前に、お住まいの地域の法律を確認してください。