---
title: "Search vetted stock media providers"
method: GET
path: "/workspace/stock-media/search"
tags: ["Media Library"]
---

# Search vetted stock media providers

`GET /workspace/stock-media/search`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/workspace/stock-media/search`
- Auth: API key in header `Authorization`

Search vetted stock media providers.

## Query parameters

- `query` string, required
- `asset_type` 'image' | 'video' | 'audio', required
- `provider` 'pexels' | 'freesound', nullable
- `orientation` 'landscape' | 'portrait' | 'square', nullable
- `page` integer
- `limit` integer

## Response `200`

Successful response

- object
  - `items` object[], required
    - `provider` 'pexels' | 'freesound', required
    - `provider_asset_id` string, required
    - `asset_type` 'image' | 'video' | 'audio', required
    - `title` string, required
    - `preview_url` string, nullable, required
    - `thumbnail_url` string, nullable, required
    - `source_url` string, required
    - `author_name` string, nullable, required
    - `author_url` string, nullable, required
    - `license_code` string, required
    - `license_url` string, nullable, required
    - `requires_attribution` boolean, required
    - `width` number, nullable, required
    - `height` number, nullable, required
    - `duration_seconds` number, nullable, required
    - `variants` object[], required
      - `id` string, required
      - `label` string, required
      - `url` string, required
      - `mime_type` string, required
      - `width` number, nullable, required
      - `height` number, nullable, required
      - `quality` string, nullable, required
  - `warnings` string[], required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)