# GET /v2/fixtures/{id}/highlights

Group: Fixtures

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.

Plans: Every plan, Free included.

Note: 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

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | fixture id issued by DataSportsAPI, a positive integer |

## Response

- `data`: `Highlight[]`
- `meta`: count
- Objects: Highlight (https://datasportsapi.com/markdown/reference.md#highlight)

## Errors

- 403 history_not_in_plan — the fixture predates the history your plan covers

Plus the common errors (https://datasportsapi.com/markdown/docs.md#errors).

## Request

cURL:

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

TypeScript:

```ts
const { data, meta } = await client.fixtures.highlights(id);
```

Python:

```python
res = client.fixtures.highlights(id)
```

Go:

```go
res, err := client.Fixtures.Highlights(ctx, id)
```

CLI:

```bash
$ dsa fixtures highlights <id>
```

## Example response

```json
{ "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 } }
```

---

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/fixtures/highlights/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
