# Get a video

> One gallery video with its prompt or skill, its category, the videos before and after it in that category, and the five most similar videos.

`GET https://motionvideo.xyz/api/catalog/videos/{slug}`

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `slug` | path | string | Yes | The video's slug. |

## Example request

```bash
curl https://motionvideo.xyz/api/catalog/videos/{slug}
```

## Responses

### 200

The video.

| Header | Description |
| --- | --- |
| `Cache-Control` | Browsers reuse a response for 5 minutes and shared caches for an hour, then may serve it stale for up to a day while they revalidate. Value: `public, max-age=300, s-maxage=3600, stale-while-revalidate=86400` |

Body (`application/json`):



### 400

A parameter is unknown or has a value it can't take.

Body (`application/json`):

- `error` (string, required) One of `invalid_parameter`.
- `parameter` (string, required)
- `message` (string, required)
- `allowed` (array of string): The values the parameter can take, when it has a fixed set.

### 404

No video with that slug. Names the video it duplicated when it was removed as a duplicate, and suggests the creator's other videos.

Body (`application/json`):

- `error` (string, required) One of `not_found`.
- `message` (string, required)
- `duplicateOf` (string): When the slug was removed as a duplicate: the video it duplicated.
- `suggestions` (array of VideoRef, required): Up to five videos by the same creator.
  - `slug` (string, required)
  - `title` (string, required)