---
title: "Proxied provider search; previews are free and unlicensed."
method: GET
path: "/api/v1/stock/search"
tags: ["Stock Media"]
---

# Proxied provider search; previews are free and unlicensed.

`GET /api/v1/stock/search`

## Request

- Base URL: `https://api.avatarfactory.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avatarfactory.io/api/v1/stock/search`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

## Query parameters

- `type` 'music' | 'footage', required
- `q` string, required
- `page` integer

## Response `200`

OK

- StockSearchResponse
  - `has_more` boolean, required
  - `items` StockSearchItemOut[], required
    - `artist` string, nullable
    - `asset_type` string, required
    - `duration_seconds` number, nullable
    - `preview_url` string, required
    - `provider_asset_id` string, required
    - `thumbnail_url` string, nullable
    - `title` string, required
  - `total_count` integer, required

## Other responses

- `422`: Unprocessable Entity
- `502`: Bad Gateway

---

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