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

# Search stock media

`GET /stock/search`

## Request

- Base URL: `https://api.vidmoat.com/v1`
- URL: `https://api.vidmoat.com/v1/stock/search`
- Auth: HTTP bearer

Search the stock library by keyword, then import a result's downloadUrl with /v1/media/import.

## Query parameters

- `query` string
- `type` 'video' | 'image' | 'audio'
- `limit` integer

## Response `200`

Search stock media

- object
  - `data` unknown[]: Results. Video and image results have `provider`, `id`, `mediaType`, `thumbnailUrl`, `downloadUrl`, `width`, `height`, `duration` (video), `photographer`, `sourceUrl` and licence fields. Audio results (CC0 only) have `id`, `name`, `downloadUrl`, `duration`, `username`, `sourceUrl`, `tags` and `bpm`.
    - unknown
  - `hint` string: What to do with a result.

## Other responses

- `400`: `invalid_request`: `query` is missing for a video or image search.
- `502`: `provider_error`: The search failed.

---

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