# Search Brand Assets

> Search across all brand asset types (images, colors, fonts, videos) in your workspace

- **URL**: https://orshot.com/docs/api-reference/brand-assets-search

---

## Overview

This endpoint allows you to search across all brand asset types in your workspace — images, colors, fonts, and videos — in a single request. You can filter by keyword (matching against names, tags, font families, and color values) and optionally restrict to specific asset types. When no query is provided, it lists all assets of the requested type(s).```markdown tab="Endpoint"
https://api.orshot.com/v1/brand-assets/search
```## Query Parameters

| Parameter | Type   | Required | Description                                                                                                                                 |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`   | String | No       | Search keyword. Matches against file names, font families, color values, video names, and tags (case-insensitive). Omit to list all assets. |
| `types`   | String | No       | Comma-separated asset types to search: `image`, `color`, `font`, `video`. Defaults to all types if omitted.                                 |
| `page`    | Number | No       | Page number for pagination (starts at 1). Defaults to `1`.                                                                                  |
| `limit`   | Number | No       | Number of results per type per page (1–50). Defaults to `10`.                                                                               |

## Request```js
await fetch("https://api.orshot.com/v1/brand-assets/search?query=logo", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```</Tab>```js
await fetch(
  "https://api.orshot.com/v1/brand-assets/search?query=primary&types=color,font",
  {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      Authorization: "Bearer <ORSHOT_API_KEY>",
    },
  }
);
```</Tab>```js
// Omit query to list all assets of the given type
await fetch("https://api.orshot.com/v1/brand-assets/search?types=font", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```</Tab>```json
{
  "images": {
    "data": [
      {
        "id": 101,
        "name": "company-logo.png",
        "url": "https://storage.orshot.com/brand-assets/workspace_id/company-logo.png",
        "tags": ["logo", "brand"],
        "type": "image"
      }
    ],
    "total": 1
  },
  "colors": {
    "data": [
      {
        "id": 5,
        "colorType": "hex",
        "value": "#FF5733",
        "tags": ["primary"],
        "type": "color"
      }
    ],
    "total": 1
  },
  "fonts": {
    "data": [
      {
        "id": 12,
        "name": "Inter",
        "fontFamily": "Inter",
        "url": "https://storage.orshot.com/fonts/workspace_id/Inter.woff2",
        "tags": ["body"],
        "type": "font"
      }
    ],
    "total": 1
  },
  "videos": {
    "data": [
      {
        "id": 8,
        "name": "intro.mp4",
        "url": "https://storage.orshot.com/videos/workspace_id/intro.mp4",
        "thumbnailUrl": "https://storage.orshot.com/videos/workspace_id/intro-thumb.jpg",
        "duration": 15,
        "tags": ["intro"],
        "type": "video"
      }
    ],
    "total": 1
  },
  "page": 1,
  "limit": 10
}
```</Tab>
</Tabs>

## Rate Limits

- 30 requests per minute per endpoint

## Response Fields

The response contains only the requested types, ordered by most recently created. Each type includes a `data` array and a `total` count for pagination. Top-level `page` and `limit` fields reflect the current pagination state.

### Images

| Field  | Type     | Description                     |
| ------ | -------- | ------------------------------- |
| `id`   | Number   | Unique identifier for the image |
| `name` | String   | Original filename               |
| `url`  | String   | Direct URL to the image         |
| `tags` | String[] | Tags associated with the image  |
| `type` | String   | Always `"image"`                |

### Colors

| Field       | Type     | Description                                      |
| ----------- | -------- | ------------------------------------------------ |
| `id`        | Number   | Unique identifier for the color                  |
| `colorType` | String   | Color format: `hex`, `rgb`, `hsl`, or `gradient` |
| `value`     | String   | Color value (e.g. `"#FF5733"`)                   |
| `tags`      | String[] | Tags associated with the color                   |
| `type`      | String   | Always `"color"`                                 |

### Fonts

| Field        | Type     | Description                    |
| ------------ | -------- | ------------------------------ |
| `id`         | Number   | Unique identifier for the font |
| `name`       | String   | Display name of the font       |
| `fontFamily` | String   | CSS font-family name           |
| `url`        | String   | Direct URL to the font file    |
| `tags`       | String[] | Tags associated with the font  |
| `type`       | String   | Always `"font"`                |

### Videos

| Field          | Type     | Description                     |
| -------------- | -------- | ------------------------------- |
| `id`           | Number   | Unique identifier for the video |
| `name`         | String   | Video name                      |
| `url`          | String   | Direct URL to the video         |
| `thumbnailUrl` | String   | URL to the video thumbnail      |
| `duration`     | Number   | Video duration in seconds       |
| `tags`         | String[] | Tags associated with the video  |
| `type`         | String   | Always `"video"`                |