# Get Videos

> Learn how to retrieve brand videos from your workspace

- **URL**: https://orshot.com/docs/api-reference/brand-videos-get

---

## Overview

This endpoint allows you to retrieve a list of brand videos from your workspace. Brand videos can be used across your templates and designs.```markdown tab="Endpoint"
https://api.orshot.com/v1/brand-assets/videos/get
```## Query Parameters

| Parameter | Type   | Required | Description                                                                                      |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------ |
| `tag`     | String | No       | Comma-separated list of tags to filter by. Returns only videos that have **all** specified tags. |

## Request

<Tabs items=>
<Tab value="Request">```js
await fetch("https://api.orshot.com/v1/brand-assets/videos/get", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```</Tab>
<Tab value="Filter by Tags">```js
await fetch("https://api.orshot.com/v1/brand-assets/videos/get?tag=intro,brand", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```</Tab>
<Tab value="Response">```json
{
  "data": [
    {
      "id": 789,
      "created_at": "2025-09-10T15:30:45.123Z",
      "name": "brand-intro.mp4",
      "original_filename": "brand-intro.mp4",
      "file_size": 5242880,
      "direct_url": "https://storage.orshot.com/videos/workspace_id/brand-intro.mp4",
      "width": 1920,
      "height": 1080,
      "duration": 30.5,
      "format": "mp4",
      "mime_type": "video/mp4",
      "metadata": {},
      "tags": ["intro", "brand"],
      "workspace_id": 50,
      "user_id": "abcdef01-2345-6789-abcd-ef0123456789"
    }
  ]
}
```</Tab>
</Tabs>

## Rate Limits

- 30 requests per minute per endpoint

## Response Fields

| Field               | Type     | Description                               |
| ------------------- | -------- | ----------------------------------------- |
| `id`                | Number   | Unique identifier for the video           |
| `created_at`        | String   | Timestamp when the video was uploaded     |
| `name`              | String   | Video name                                |
| `original_filename` | String   | Original filename of the uploaded video   |
| `file_size`         | Number   | Size of the video file in bytes           |
| `direct_url`        | String   | URL to access the video                   |
| `width`             | Number   | Video width in pixels                     |
| `height`            | Number   | Video height in pixels                    |
| `duration`          | Number   | Video duration in seconds                 |
| `format`            | String   | Video format (e.g., `mp4`, `webm`)        |
| `mime_type`         | String   | MIME type of the video                    |
| `metadata`          | Object   | Custom metadata associated with the video |
| `tags`              | String[] | Tags associated with the video            |
| `workspace_id`      | Number   | ID of the workspace the video belongs to  |
| `user_id`           | String   | ID of the user who uploaded the video     |