Skip to content
datasportsAPI

FixturesHighlights

Documentation

/

Type to filter the docs by title or path.

FixturesEndpoint 30 of 116

Highlights

GET

/v2/fixtures/{id}/highlights

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
1 required · 0 optional
Returns
Highlight[]
Try 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.

Worth knowing

  • 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.

01Parameters

  • idpathRequired

    fixture id issued by DataSportsAPI, a positive integer

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/{id}/highlights"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
Highlight[]
meta
count
ObjectsHighlight
Example response
{ "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 } }

04Errors

  • 403history_not_in_plan

    the fixture predates the history your plan covers

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code