Endpoint Playground

Try the SofaScore event commentary API

Returns a match's text commentary (minute, type, text, and the players involved, plus the running score on scoring lines) from SofaScore, newest first. Works for football and basketball matches that have commentary. An empty `comments` list is a valid response (a live match with no lines yet). Returns 404 when SofaScore has no commentary for the match, which includes matches that have not started.

What a live request returned

14 Oct 2026: 114 comments; 3 fields had a value in every checked item and 9 varied between items.

Observed request: GET /sofascore/event-comments?id=16363867
Fields with a value in every checked item: id, type, text

Sample value profiles: minute: 1 to 94, median 52; is_home: true in 52 of 107; home_score: 1 to 5, median 2.

Request: GET /sofascore/event-comments
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.7%, median 1.28 s
Monitored request: GET /sofascore/event-comments?id=16363867

SofaScore event commentary API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/event-comments?id=16363867' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	Yes	16363867	Numeric SofaScore event (match) id

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "event_id": 16363867,
    "source_url": "https://api.sofascore.com/api/v1/event/16363867/comments",
    "fetched_at": "2026-07-08T00:00:00Z",
    "count": 114,
    "comments": [
      {
        "id": 40442273,
        "type": "scoreChange",
        "text": "Goal! Manchester City 5, Sunderland 3. Erling Haaland (Manchester City) right footed shot from very close range to the bottom right corner. Assisted by Josko Gvardiol.Goal awarded following VAR Review.",
        "period": "2ND",
        "minute": 81,
        "is_home": true,
        "home_score": 5,
        "away_score": 3,
        "player": {
          "id": 839956,
          "name": "Erling Haaland",
          "short_name": "E. Haaland",
          "slug": "erling-haaland",
          "position": "F",
          "jersey_number": "9"
        },
        "assist": {
          "id": 964994,
          "name": "Joško Gvardiol",
          "short_name": "J. Gvardiol",
          "slug": "josko-gvardiol",
          "position": "D",
          "jersey_number": "24"
        }
      },
      {
        "id": 40442362,
        "type": "substitution",
        "text": "Substitution, Manchester City. Nico O'Reilly replaces Rayan Cherki.",
        "period": "2ND",
        "minute": 85,
        "is_home": true,
        "player": {
          "id": 1142703,
          "name": "Nico O'Reilly",
          "short_name": "N. O’Reilly",
          "slug": "nico-o-reilly",
          "position": "D",
          "jersey_number": "33"
        },
        "player_in": {
          "id": 1142703,
          "name": "Nico O'Reilly",
          "short_name": "N. O’Reilly",
          "slug": "nico-o-reilly",
          "position": "D",
          "jersey_number": "33"
        },
        "player_out": {
          "id": 979128,
          "name": "Rayan Cherki",
          "short_name": "R. Cherki",
          "slug": "cherki-rayan",
          "position": "M",
          "jersey_number": "10"
        }
      }
    ]
  }
}

More SofaScore endpoints

SofaScore categories for a sport SofaScore competitions in a category SofaScore league draft SofaScore league draft picks SofaScore esports game detail SofaScore event detail SofaScore event at-bat pitches SofaScore event at-bats SofaScore event average positions SofaScore event baseball top performers SofaScore event best players SofaScore event esports games All 109 SofaScore endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestsofascore.eventCommentsResponseDocSofaScore

GET /sofascore/event-comments

SofaScore event commentary

Response behavior

- Verified for football and basketball matches. Football lines carry `player`, `player_in`/`player_out` (substitutions), `assist`, `is_home` and `minute`; basketball lines additionally carry `time_seconds`, `goal_type` and `penalty_drawn_by`. - `minute` is the elapsed match minute including stoppage time (a goal in the tenth minute of stoppage time after 90 shows `100`); this differs from the shot map, which reports `minute: 90` plus `added_time`. - `type` is SofaScore's own line type (for example `shotSaved`, `scoreChange`, `substitution`, `freeKickWon`, `cornerKick`, `periodEnd`) and is not a closed set the API validates. - An empty `comments` array is a valid response (a live match with no lines yet), not an error. - Returns `404` when SofaScore has no commentary for the match. This includes matches that have not started and tennis matches. - Basketball matches can return several hundred lines (about 500), so responses can be large.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

requiredstring

Numeric SofaScore event (match) id

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "event_id": 16363867,
    "source_url": "https://api.sofascore.com/api/v1/event/16363867/comments",
    "fetched_at": "2026-07-08T00:00:00Z",
    "count": 114,
    "comments": [
      {
        "id": 40442273,
        "type": "scoreChange",
        "text": "Goal! Manchester City 5, Sunderland 3. Erling Haaland (Manchester City) right footed shot from very close range to the bottom right corner. Assisted by Josko Gvardiol.Goal awarded following VAR Review.",
        "period": "2ND",
        "minute": 81,
        "is_home": true,
        "home_score": 5,
        "away_score": 3,
        "player": {
          "id": 839956,
          "name": "Erling Haaland",
          "short_name": "E. Haaland",
          "slug": "erling-haaland",
          "position": "F",
          "jersey_number": "9"
        },
        "assist": {
          "id": 964994,
          "name": "Joško Gvardiol",
          "short_name": "J. Gvardiol",
          "slug": "josko-gvardiol",
          "position": "D",
          "jersey_number": "24"
        }
      },
      {
        "id": 40442362,
        "type": "substitution",
        "text": "Substitution, Manchester City. Nico O'Reilly replaces Rayan Cherki.",
        "period": "2ND",
        "minute": 85,
        "is_home": true,
        "player": {
          "id": 1142703,
          "name": "Nico O'Reilly",
          "short_name": "N. O’Reilly",
          "slug": "nico-o-reilly",
          "position": "D",
          "jersey_number": "33"
        },
        "player_in": {
          "id": 1142703,
          "name": "Nico O'Reilly",
          "short_name": "N. O’Reilly",
          "slug": "nico-o-reilly",
          "position": "D",
          "jersey_number": "33"
        },
        "player_out": {
          "id": 979128,
          "name": "Rayan Cherki",
          "short_name": "R. Cherki",
          "slug": "cherki-rayan",
          "position": "M",
          "jersey_number": "10"
        }
      }
    ]
  }
}

Try the SofaScore event commentary API

What a live request returned

14 Oct 2026: 114 comments; 3 fields had a value in every checked item and 9 varied between items.

Observed request: GET /sofascore/event-comments?id=16363867
Fields with a value in every checked item: id, type, text

Sample value profiles: minute: 1 to 94, median 52; is_home: true in 52 of 107; home_score: 1 to 5, median 2.

Request: GET /sofascore/event-comments
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.7%, median 1.28 s
Monitored request: GET /sofascore/event-comments?id=16363867

SofaScore event commentary API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/event-comments?id=16363867' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	Yes	16363867	Numeric SofaScore event (match) id

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "event_id": 16363867,
    "source_url": "https://api.sofascore.com/api/v1/event/16363867/comments",
    "fetched_at": "2026-07-08T00:00:00Z",
    "count": 114,
    "comments": [
      {
        "id": 40442273,
        "type": "scoreChange",
        "text": "Goal! Manchester City 5, Sunderland 3. Erling Haaland (Manchester City) right footed shot from very close range to the bottom right corner. Assisted by Josko Gvardiol.Goal awarded following VAR Review.",
        "period": "2ND",
        "minute": 81,
        "is_home": true,
        "home_score": 5,
        "away_score": 3,
        "player": {
          "id": 839956,
          "name": "Erling Haaland",
          "short_name": "E. Haaland",
          "slug": "erling-haaland",
          "position": "F",
          "jersey_number": "9"
        },
        "assist": {
          "id": 964994,
          "name": "Joško Gvardiol",
          "short_name": "J. Gvardiol",
          "slug": "josko-gvardiol",
          "position": "D",
          "jersey_number": "24"
        }
      },
      {
        "id": 40442362,
        "type": "substitution",
        "text": "Substitution, Manchester City. Nico O'Reilly replaces Rayan Cherki.",
        "period": "2ND",
        "minute": 85,
        "is_home": true,
        "player": {
          "id": 1142703,
          "name": "Nico O'Reilly",
          "short_name": "N. O’Reilly",
          "slug": "nico-o-reilly",
          "position": "D",
          "jersey_number": "33"
        },
        "player_in": {
          "id": 1142703,
          "name": "Nico O'Reilly",
          "short_name": "N. O’Reilly",
          "slug": "nico-o-reilly",
          "position": "D",
          "jersey_number": "33"
        },
        "player_out": {
          "id": 979128,
          "name": "Rayan Cherki",
          "short_name": "R. Cherki",
          "slug": "cherki-rayan",
          "position": "M",
          "jersey_number": "10"
        }
      }
    ]
  }
}

SofaScore event commentary

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "event_id": 16363867, "source_url": "https://api.sofascore.com/api/v1/event/16363867/comments", "fetched_at": "2026-07-08T00:00:00Z", "count": 114, "comments": [ { "id": 40442273, "type": "scoreChange", "text": "Goal! Manchester City 5, Sunderland 3. Erling Haaland (Manchester City) right footed shot from very close range to the bottom right corner. Assisted by Josko Gvardiol.Goal awarded following VAR Review.", "period": "2ND", "minute": 81, "is_home": true, "home_score": 5, "away_score": 3, "player": { "id": 839956, "name": "Erling Haaland", "short_name": "E. Haaland", "slug": "erling-haaland", "position": "F", "jersey_number": "9" }, "assist": { "id": 964994, "name": "Joško Gvardiol", "short_name": "J. Gvardiol", "slug": "josko-gvardiol", "position": "D", "jersey_number": "24" } }, { "id": 40442362, "type": "substitution", "text": "Substitution, Manchester City. Nico O'Reilly replaces Rayan Cherki.", "period": "2ND", "minute": 85, "is_home": true, "player": { "id": 1142703, "name": "Nico O'Reilly", "short_name": "N. O’Reilly", "slug": "nico-o-reilly", "position": "D", "jersey_number": "33" }, "player_in": { "id": 1142703, "name": "Nico O'Reilly", "short_name": "N. O’Reilly", "slug": "nico-o-reilly", "position": "D", "jersey_number": "33" }, "player_out": { "id": 979128, "name": "Rayan Cherki", "short_name": "R. Cherki", "slug": "cherki-rayan", "position": "M", "jersey_number": "10" } } ] } }