AI commentary
GET
/
View as MarkdownTry in Playground →
AI-written commentary on a football fixture, oldest first by seq (newest 100): a short entry per goal, missed penalty, red card, VAR decision, period start or end, big chance and sustained swing in momentum. Events seconds apart are merged into one entry, and there are summaries at half-time and full time. Available on Pro, Business and Enterprise plans.
DataSportsAPI AI writes every line from our own match data alone (score, clock, events, statistics, shot map and our win-probability model) and stays clear of betting language. Entries are generated only while the match is being followed, either through this endpoint or through a fixture:{id} WebSocket channel, so request it while the game is on; a match that nobody followed has no entries. Featured top-league matches on datasportsapi.com always get commentary. Every entry is written a single time and served identically to all clients, and its seq is permanent. kind takes one of these values: kickoff, goal, redCard, missedPenalty, varDecision, bigChance, momentum, periodStart, periodEnd, halfTime, fullTime, update. The minute of a fullTime summary is 90 (120 after extra time). On Business and Enterprise, fixture:{id} channels receive a commentary frame for each new entry.
Parameters
idpathrequired
fixture id issued by DataSportsAPI, a positive integer
Response
- data
Commentary- meta
- count, generatedBy
- errors
- 403
endpoint_not_in_plan— returned to keys on the Free and Starter plans404not_supported— the fixture is not a football match
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/fixtures/{id}/commentary"Example
{ "data": { "fixtureId": 236923, "entries": [ …,
{ "seq": 2, "kind": "goal", "minute": 36, "addedMinute": null, "model": "datasportsapi-ai", "createdAt": "2026-10-18T13:37:41.000Z",
"text": "Nico Paz doubles Como's lead, finishing after a pass from Álex Valle, four minutes after Mattia Liberali's opener. Our model now gives Como an 85% win probability, up from 65%." },
{ "seq": 3, "kind": "halfTime", "minute": 45, "addedMinute": null, "model": "datasportsapi-ai", "createdAt": "2026-10-18T13:52:04.000Z",
"text": "Como lead Fiorentina 2-1 at the break. Mattia Liberali and Nico Paz struck in the 32nd and 36th minutes before Marin Pongračić pulled one back, a goal confirmed by VAR in first-half stoppage time." } ] },
"meta": { "count": 3, "generatedBy": "datasportsapi-ai" } }