---
search:
  tags:
    - Media
    - GET
seo:
  description: >-
    Full-text search across images, videos, and files in an… Reference for the
    GET /api/v1/{app_id}/media/search endpoint in the Digital Assets Management
    API.
sidebar:
  label: Search Media
  badge: GET
title: Search Media
type: openapi-operation
---
Full-text search across images, videos, and files in an app, matching title, alt_text, description, and translations. The response also includes the attribute facets available on the matching media, with distinct-item counts and active flags reflecting `attributes=` filters. Per-template exclusion: when computing facet counts, filters on the same template_key are ignored while filters on other templates still apply (OR-within-template, AND-across-template).

`GET /api/v1/{app_id}/media/search`

**Responses**

- `200` — Search results with facets
- `400` — Invalid request
- `500` — Internal server error

Response example, 200:

```json
{
  "data": [
    {
      "alt_text": "string",
      "attributes": [
        {
          "description": "string",
          "id": "string",
          "key": "string",
          "name": "string",
          "values": {
            "property1": [
              {
                "type": "string",
                "value": "string"
              }
            ],
            "property2": [
              {
                "type": "string",
                "value": "string"
              }
            ]
          }
        }
      ],
      "blurhash": "string",
      "copyright": "string",
      "created_at": "string",
      "custom": [
        0
      ],
      "description": "string",
      "file_type": "string",
      "folder": {
        "id": "string",
        "name": "string",
        "public": true,
        "slug": "string"
      },
      "id": "string",
      "status": "string",
      "title": "string",
      "translations": {
        "alt": [
          {
            "id": "string",
            "locale": "string",
            "value": "string"
          }
        ],
        "description": [
          {
            "id": "string",
            "locale": "string",
            "value": "string"
          }
        ],
        "title": [
          {
            "id": "string",
            "locale": "string",
            "value": "string"
          }
        ],
        "type": [
          {
            "id": "string",
            "locale": "string",
            "value": "string"
          }
        ]
      },
      "type": "string",
      "updated_at": "string",
      "url": "string",
      "variants": [
        {
          "created_at": "string",
          "format": "string",
          "height": 0,
          "id": "string",
          "updated_at": "string",
          "url": "string",
          "width": 0
        }
      ]
    }
  ],
  "facets": [
    {
      "active": true,
      "count": 0,
      "description": "string",
      "filter_key": "string",
      "key": "string",
      "name": "string",
      "template_key": "string",
      "values": [
        {
          "count": 0,
          "type": "string",
          "value": "string"
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "per_page": 0,
    "total_items": 0,
    "total_pages": 0
  },
  "success": true
}
```