---
title: "SofaScore event commentary"
method: GET
path: "/sofascore/event-comments"
tags: ["SofaScore"]
---

# SofaScore event commentary

`GET /sofascore/event-comments`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/event-comments`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreEventCommentsResponseDoc
  - `code` integer
  - `data` SofascoreEventCommentsResponse
    - `comments` SofascoreEventComment[]
      - `assist` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `away_score` integer
      - `goal_type` string
      - `home_score` integer
      - `id` integer
      - `is_home` boolean
      - `minute` integer
      - `penalty_drawn_by` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `period` string
      - `player` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `player_in` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `player_out` SofascorePlayerBrief
        - `id` integer
        - `jersey_number` string
        - `name` string
        - `position` string
        - `short_name` string
        - `slug` string
      - `text` string
      - `time_seconds` integer
      - `type` string
    - `count` integer
    - `event_id` integer
    - `fetched_at` string
    - `source_url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)
