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

Group: Fixtures

Video highlights of a match: title, the link on its host (YouTube, X), the host, the host’s own thumbnail, whether it is the source’s main highlight, and the countries it is limited to. We host no video — link or embed it from its host.

Note: The main highlight comes first, then by publication. Highlights usually appear a few hours after the whistle; until then (and for matches without any) the array is empty. countries lists the only countries the video is meant for (broadcast rights); empty = everywhere. thumbnailUrl is the host’s own image (i.ytimg.com, pbs.twimg.com), null for other hosts.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | our numeric id (positive integer) |

## Response

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

## Errors

- 403 history_not_in_plan — the fixture is older than your plan’s history

Plus the common errors (https://sportsapi.app/markdown/en/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/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
$ sportsapi 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.sportsapi.app. Send your API key as `Authorization: Bearer <key>` on every /v2 request; keys are created in the dashboard (https://sportsapi.app/dashboard).
HTML: https://sportsapi.app/docs/fixtures/highlights · All docs: https://sportsapi.app/markdown/en/docs.md