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

# Videos

> Schema for inline video cards embedded within the Google AI Mode response, including titles, thumbnails, durations, channels, and source links.

This section documents the **videos** data returned by the [Google AI Mode endpoint](/api-reference/endpoint/monitor-aimode). Videos are part of the AI Mode response — no separate API call is needed.

## Example request

Videos are intent-detected: send a prompt that surfaces video recommendations in the AI response. No flag is required.

```json theme={null}
{
  "prompt": "best 3d printer to buy",
  "country": "US"
}
```

This produces a response containing the `videos` array documented below.

## Overview

Inline video cards Google embeds inside an AI Mode answer. In observed traffic these are YouTube watch links, returned with the title, channel, duration, and a public thumbnail. The `link` is the canonical watch URL with timestamp parameters stripped. Videos appear in the order Google AI Mode embeds them in the answer; array index `0` is the first card shown.

<Frame caption="Videos in AI Mode">
  <img src="https://mintcdn.com/cloro/Qv2xgJAgMecwTTRq/images/aimode/videos.webp?fit=max&auto=format&n=Qv2xgJAgMecwTTRq&q=85&s=6cfe1b1a02279c35949d2c9ae12a4bef" alt="Videos in AI Mode" width="1406" height="1094" data-path="images/aimode/videos.webp" />
</Frame>

## Video structure

| Field       | Type   | Description                                                 |
| ----------- | ------ | ----------------------------------------------------------- |
| `title`     | string | Video title                                                 |
| `link`      | string | Canonical watch URL (timestamp parameters stripped)         |
| `platform`  | string | Hosting platform parsed from the card byline (e.g. YouTube) |
| `channel`   | string | Channel or uploader name                                    |
| `duration`  | string | Visible duration label (`mm:ss` or `hh:mm:ss`)              |
| `thumbnail` | string | Public thumbnail URL                                        |

## Response example

```json theme={null}
{
  "success": true,
  "result": {
    "text": "Here are some highly-rated 3D printers to consider...",
    "videos": [
      {
        "title": "The BEST 3D Printer for YOU - Don't Buy the Wrong One!",
        "link": "https://www.youtube.com/watch?v=g0DZnQdI-xQ",
        "platform": "YouTube",
        "channel": "3D Print Dood",
        "duration": "08:49",
        "thumbnail": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS5Bntg3F0Y7P3YgTPgdyillyeCguV_YQJ99KFUmNYxmQtVt1f2"
      }
    ]
  }
}
```