> ## 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.

# Google Videos schema

> Schema for the cards of Google's Videos carousel returned by the Google Search endpoint: title, link, platform, channel, date, duration and key moments.

The [Google Search endpoint](https://cloro.dev/docs/api-reference/endpoint/monitor-google.md) returns the cards of Google's Videos carousel as `result.videos`, on desktop and mobile, with no flag and at no extra cost. The carousel shows on how-to, recipe, news and sports queries, among others. `videos` is omitted when the SERP has no Videos carousel.

The videos of the AI Overview are in [`result.aioverview`](https://cloro.dev/docs/api-reference/endpoint/google/ai-overview), not here.

## Videos structure

| Field | Type | Description |
| - | - | - |
| `items` | array | The cards, in page order. See below |

### Video

`position`, `title` and `link` are always present. Every other field is included only when Google shows it on the card.

| Field | Type | Description |
| - | - | - |
| `position` | number | Position within the carousel (1-indexed) |
| `title` | string | Title of the video as shown |
| `link` | string | URL of the video |
| `platform` | string | Site that hosts the video, as shown (`YouTube`, or the site's name) |
| `channel` | string | Channel or uploader, as shown. Absent when the card shows only the site |
| `date` | string | Upload date, as shown |
| `duration` | string | Length of the video, as shown |
| `keyMoments` | array | The chapters of the video. See below |
| `redirectLink` | string | Google's `/goto` redirect for `link`. See [Redirect links](https://cloro.dev/docs/api-reference/endpoint/google/resolve-goto.md). |

### Key moment

| Field | Type | Description |
| - | - | - |
| `title` | string | Title of the chapter |
| `time` | string | Start of the chapter in the video, as shown |
| `link` | string | URL of the video at that time |
| `redirectLink` | string | Google's `/goto` redirect for `link`. See [Redirect links](https://cloro.dev/docs/api-reference/endpoint/google/resolve-goto.md). |

## Response example

A response to `relativitätstheorie einfach erklärt` in Germany, on mobile:

```json theme={null}
{
  "success": true,
  "result": {
    "videos": {
      "items": [
        {
          "position": 1,
          "title": "Albert Einsteins Relativitätstheorie in 5 Minuten erklärt",
          "link": "https://www.youtube.com/watch?v=FLF-WulNUeM",
          "platform": "YouTube",
          "channel": "youknow",
          "date": "10.11.2015",
          "duration": "5:09",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHEIkXXtb_vmSCT…"
        },
        {
          "position": 2,
          "title": "Die Relativitätstheorie für Einsteiger",
          "link": "https://www.youtube.com/watch?v=CRee28w7PGY",
          "platform": "YouTube",
          "channel": "Terra X Lesch & Co",
          "date": "09.03.2016",
          "duration": "7:48",
          "keyMoments": [
            {
              "title": "Das Geheimnis der Gravitation",
              "time": "00:52",
              "link": "https://www.youtube.com/watch?v=CRee28w7PGY&t=52",
              "redirectLink": "https://www.google.com/goto?url=CAESbQHEIkXXQI-JZNe9…"
            }
            // …
          ],
          "redirectLink": "https://www.google.com/goto?url=CAESaAHEIkXX0tbBGxEx…"
        }
        // …
      ]
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.