---
title: "Search Stock"
method: POST
path: "/tools/search/stock"
tags: ["accepts-api-key"]
---

# Search Stock

`POST /tools/search/stock`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/tools/search/stock`
- Auth: none declared

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- SearchStockRequest
  - `prompt` string, required: Search query for stock content.
  - `type` 'image' | 'video': Type of content to search.
  - `format` '16:9' | '9:16', nullable: Filter by aspect ratio.
  - `limit` integer: Number of results.

## Response `200`

Successful Response

- SearchStockResponse
  - `results` StockAssetSearchResult[], required
    - `asset_id` string, required: The ID of the asset.
    - `title` string, required: The title of the asset.
    - `description` string, required: The description of the asset.
    - `duration_seconds` number, required: The duration of the asset in seconds. 0.0 for images.
    - `width` integer, nullable, required: The width of the asset in pixels, when Pexels reports it.
    - `height` integer, nullable, required: The height of the asset in pixels, when Pexels reports it.

## Other responses

- `402`: Not enough Tellers tokens to run this tool. The call was refused before the tool ran, so nothing was charged. Buy more tokens or wait for the next subscription grant.
- `403`: The account's email is not verified yet, so it cannot spend tokens. Nothing was charged. `detail.code` is `EMAIL_NOT_VERIFIED`.
- `422`: Validation Error

---

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