Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Fixtures

Highlights

GET

/v2/fixtures/{id}/highlights

All plans

View as MarkdownTry in Playground →

Match highlight videos, each with a title, its URL on the hosting platform (YouTube, X), the host name, the host’s thumbnail, a flag for the source’s main highlight and any country restrictions. DataSportsAPI does not host video; link to it or embed it from the original platform.

The main highlight is listed first, with the rest ordered by publication. Videos typically turn up a few hours after the final whistle; before that, and for matches that never get any, the array is empty. countries restricts a video to the listed countries because of broadcast rights; an empty list means it is available everywhere. thumbnailUrl links to an image on the video host itself (i.ytimg.com, pbs.twimg.com); for any other host it is null.

Parameters

id

pathrequired

fixture id issued by DataSportsAPI, a positive integer

Response

data
Highlight[]
meta
count
errors
403 history_not_in_plan — the fixture predates the history your plan covers

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}/highlights"
Example
{ "data": [
    { "title": "Liverpool FC 0-1 Arsenal", "subtitle": "Full Highlights", "url": "https://www.youtube.com/watch?v=8r5GeRg4xDQ",
      "provider": "youtube", "thumbnailUrl": "https://i.ytimg.com/vi/8r5GeRg4xDQ/maxresdefault.jpg", "main": true, "countries": [],
      "publishedAt": "2026-11-01T22:02:51.000Z" },
    { "title": "Liverpool 0 - 1 Arsenal", "subtitle": "Full Highlights", "url": "https://www.youtube.com/watch?v=Q5xBT-Ovbq8",
      "provider": "youtube", "thumbnailUrl": "https://i.ytimg.com/vi/Q5xBT-Ovbq8/hqdefault.jpg", "main": false,
      "countries": ["BA", "HR", "ME", "MK", "RS", "SI"], "publishedAt": "2026-11-01T21:36:56.000Z" } ],
  "meta": { "count": 2 } }