Matches Commentaries

This endpoint allows you to retrieve the commentaries from matches.

Multi-language: This feature allows the user to manually change the language of the API response by adding value to the lang attribute. Example: lang=en.

Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.

Update Period: The endpoint is updated every 30 seconds.
Recommended Calls: Limit calls every second.

Use Cases

Get commentaries from a specific match_id
https://football.sportdevs.com/matches-commentaries?match_id=eq.{match_id}

Query Parameters

• match_id integer

  Default value: eq.19682

  The id of the match

• offset string

  Default value: 0

  Limiting and Pagination

• limit string

  Default value: 50

  Limiting and Pagination

• lang string

  Default value: en

  Multi-language

Responses

• 200

---

OK

application/json

• Schema
• Example (from schema)

---

Schema array

• match_id integer

  The id of the match

  Note: This is a Foreign Key to injuries.match_id.

• commentaries jsonb

  The commentaries

[
  {
    "match_id": 19682,
    "commentaries": [
      {
        "text": "And here we have a substitution for the away team as Kodai Sano replaces Bas Dost, let's see if this change can make a difference in the game.",
        "minute": 90,
        "player_in_id": 163550,
        "player_out_id": 163852,
        "player_in_name": "Kodai Sano",
        "player_out_name": "Bas Dost",
        "player_in_hash_image": "98336938058ebedf3de46394bf0b421f3ca36f86e2428b8d692c0bb5efe806a9",
        "player_out_hash_image": "dc8ad9a5aaa13feec7b87db70fc2a8a78ccc4d4cf29118f36bc5a10f38bed1df"
      },
      {
        "text": "And here we have a substitution for the home team as Mexx Meerdink replaces Riechedly Bazoer on the field.",
        "minute": 90,
        "player_in_id": 25859,
        "player_out_id": 24620,
        "player_in_name": "Mexx Meerdink",
        "player_out_name": "Riechedly Bazoer",
        "player_in_hash_image": "49999b78ce610a2ea1143818920be5f468e18d2faee7afe787f29d890db7e888",
        "player_out_hash_image": "94a89d411d976859a687256e6013a31c3b60c16f4d765489a011bafdcae17ea1"
      },
      {
        "text": "And here we have a substitution for the home team as Tiago Dantas replaces Denso Kasius on the field.",
        "minute": 90,
        "player_in_id": 99574,
        "player_out_id": 92291,
        "player_in_name": "Tiago Dantas",
        "player_out_name": "Denso Kasius",
        "player_in_hash_image": "87a71e4371f9b2592fa5a9f55c7adc80e084da25da3f8fe3339e88bd415f5caa",
        "player_out_hash_image": "1f81f9a69abd73e3c2d5982716c07bc5ff07aa6bec3e378eb4dedbae66bf4e4b"
      },
      {
        "text": "Bram Nuytinck replaces Lasse Schøne as the away team looks to strengthen their defense.",
        "minute": 90,
        "player_in_id": 161396,
        "player_out_id": 22753,
        "player_in_name": "Bram Nuytinck",
        "player_out_name": "Lasse Schøne",
        "player_in_hash_image": "a8580925072676abed9abf61b1e9bde092d70b89c113d8324f0ea511b8a5f5ad",
        "player_out_hash_image": "3bb9aa8b03fa3bd87cd0fed47a11183f265fd7912d687740188db2cc3e28dfe2"
      },
      {
        "text": "Jens Odgaard with a powerful blocked header assisted by his teammates, finding the bottom right corner of the net, giving the home team a crucial goal!",
        "minute": 90,
        "player_id": 25844,
        "player_name": "Jens Odgaard",
        "player_hash_image": "4b4dbb3006c26b3f4ac9b15a14b6ca175f7ece82ae833bbce658541ceaf4c429"
      },
      {
        "text": "Mexx Meerdink with a powerful left-footed shot, but it sails high over the goal, disappointing the home crowd.",
        "minute": 90,
        "player_id": 25859,
        "player_name": "Mexx Meerdink",
        "player_hash_image": "49999b78ce610a2ea1143818920be5f468e18d2faee7afe787f29d890db7e888"
      },
      {
        "text": "Philippe Sandler enters the field, replacing D'Leanu Arts, as the away team looks to strengthen their defense.",
        "minute": 90,
        "player_in_id": 148939,
        "player_out_id": 163203,
        "player_in_name": "Philippe Sandler",
        "player_out_name": "D'Leanu Arts",
        "player_in_hash_image": "c5ee2f226fdd3d34d76c0dc0a8b38bc377fde91e3e09827cf0a0949150d9047d",
        "player_out_hash_image": "ca12503e06a95ba903955129b2daacffbb0c659fe5baefed2e910451334d285e"
      },
      {
        "text": "Ruben van Bommel unleashes a powerful right-footed shot from a set-piece, but narrowly misses the target on the right side of the goal, disappointing the home crowd.",
        "minute": 90,
        "player_id": 84328,
        "player_name": "Ruben van Bommel",
        "player_hash_image": "856449c2b56a26756877ac4f74941f9c91d65b8a8995eb30416cc51a77a24839"
      },
      {
        "text": "The match has started.",
        "minute": 0
      },
      {
        "text": "Tiago Dantas unleashes a powerful right-footed shot, but it sails high and wide to the right of the goal, much to the disappointment of the home crowd.",
        "minute": 90,
        "player_id": 99574,
        "player_name": "Tiago Dantas",
        "player_hash_image": "87a71e4371f9b2592fa5a9f55c7adc80e084da25da3f8fe3339e88bd415f5caa"
      },
      {
        "text": "Tiago Dantas with a powerful right-footed shot, but it's blocked in the low-centre of the goal-mouth, denying the home team a scoring opportunity.",
        "minute": 90,
        "player_id": 99574,
        "player_name": "Tiago Dantas",
        "player_hash_image": "87a71e4371f9b2592fa5a9f55c7adc80e084da25da3f8fe3339e88bd415f5caa"
      },
      {
        "text": "Vangelis Pavlidis with a powerful blocked header from the low-centre of the goal mouth, showcasing his defensive prowess for the home team.",
        "minute": 90,
        "player_id": 25846,
        "player_name": "Vangelis Pavlidis",
        "player_hash_image": "1abdd786c0c01af2fe4ad21122f81d0df4de43113296bf81548bf1ed9af42d02"
      }
    ]
  }
]

Loading...