> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Video Search

<p style={{ fontSize: "0.8rem", opacity: 0.6 }}>For AI agents: <a href="https://docs.octen.ai/capabilities/video-search.md">docs.octen.ai/capabilities/video-search.md</a></p>

Some answers live in videos: a tutorial that shows the steps, a talk that makes the argument, a demo that proves the product. The hard part is finding the right one across the web.

Octen Video Search searches the web for videos from a text query and returns ranked results with rich metadata, ready to preview, embed, or pass to a model.

For the full list of parameters, see the [Video Search API reference](/api-reference/video-search).

<Note>
  In invite-only beta. Email [support@octen.ai](mailto:support@octen.ai) to request access.
</Note>

## Why Video Search

* **Video lookup and clip discovery.** Find the right video across the whole web from one query.
* **Richer answers.** Let assistants and apps reply with playable videos when showing beats telling.
* **Reference for generation.** Retrieved videos serve as real-world references for generation models, grounding image and video creation.

## How It Works

1. Send a text query.
2. Octen searches videos across the web and ranks them.
3. Each result returns the video and its source page, with title, description, cover image, duration, and publish time.

## Scenarios

### Find the right video

Video lookup from a plain text query.

```bash theme={null}
curl -X POST https://api.octen.ai/video-search \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "inputs": [{ "type": "text", "data": "how to make espresso" }],
    "count": 5
  }'
```

### Answer with videos

When a question is best answered visually, return videos an assistant can show directly in its reply.

```json theme={null}
{
  "inputs": [{ "type": "text", "data": "how to tie a bowline knot" }],
  "count": 3
}
```

### Collect generation references

Search real footage first, then pass the results to a generation model as references for grounded image or video creation.

```json theme={null}
{
  "inputs": [{ "type": "text", "data": "aurora borealis over a fjord" }],
  "count": 5
}
```

### Recent videos

Keep results to a recent time window, filtered by publish time.

```json theme={null}
{
  "inputs": [{ "type": "text", "data": "keynote highlights" }],
  "count": 5,
  "time_range": "week"
}
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Try in Console" icon="play" href="https://octen.ai/platform/video-search">
    Run Video Search live in the Octen console.
  </Card>

  <Card title="Video Search API Reference" icon="code" href="/api-reference/video-search">
    Full request/response schema.
  </Card>
</CardGroup>