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).

API ownership

• API family: DAM public reads
• Best for: Public asset-library folder, media, facet, and shareable-link reads. Use Management API DAM routes for authenticated administration.
• Guide route: /media/dam/latest

The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.

Operation

• Method: GET
• Path: /api/v1/\{app_id\}/media/search
• Summary: Search Media
• Description: 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).
• OpenAPI contract: dam-api
• Operation ID: Not documented in the OpenAPI contract.

Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.

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

{
  "details": [
    "string"
  ],
  "error": "string"
}

{
  "details": [
    "string"
  ],
  "error": "string"
}

Contract identity

Use these fields to confirm you are implementing the intended endpoint contract.

• API family: DAM public reads
• Method: GET
• Path: /api/v1/\{app_id\}/media/search
• Operation ID: Not documented in the OpenAPI contract.
• OpenAPI tag: Media
• OpenAPI summary: Search Media