API Reference › AI Mode › Videos

Videos

The videos array captures the inline video cards Google surfaces inside an AI Mode answer, giving you each recommendation as structured data.

Overview

Video cards are delivered as part of the standard Google AI Mode response, so there is no dedicated request for them — you never call a separate endpoint. Whenever a prompt causes Google to embed video recommendations, cloro parses those cards and returns them alongside the answer text.

In practice the embedded cards point to YouTube watch pages and carry the video title, the owning channel, a duration label, and a public thumbnail. The link is normalized to the canonical watch URL, with any timestamp query parameters removed so the same video always resolves to a stable key. Cards keep the order in which Google places them in the answer, so index 0 is the first card the user sees.

Triggering video cards

Videos are intent-driven rather than flag-driven. Send a prompt likely to prompt Google into recommending clips — buying guides and how-to queries tend to surface them — and cloro will populate the videos array automatically.

{
  "prompt": "best 3d printer to buy",
  "country": "US"
}

Video structure

Field	Type	Description
title	string	Display title shown on the video card.
link	string	Canonical watch URL with timestamp parameters stripped.
platform	string	Hosting service inferred from the card byline, such as YouTube.
channel	string	Name of the channel or uploader credited on the card.
duration	string	Runtime label as rendered (mm:ss or hh:mm:ss).
thumbnail	string	Publicly reachable preview image URL.

Response example

{
  "success": true,
  "result": {
    "text": "Here are a few well-reviewed 3D printers worth comparing...",
    "videos": [
      {
        "title": "How to Pick Your First 3D Printer (2026 Guide)",
        "link": "https://www.youtube.com/watch?v=g0DZnQdI-xQ",
        "platform": "YouTube",
        "channel": "Maker Bench",
        "duration": "08:49",
        "thumbnail": "https://i.ytimg.com/vi/g0DZnQdI-xQ/hqdefault.jpg"
      }
    ]
  }
}

Notes

The videos array is omitted or empty when the AI Mode answer contains no embedded clips, so treat its presence as optional and iterate defensively. Individual fields may also be absent when Google does not expose them on a given card. For access issues or unexpected parsing gaps, reach out at [email protected].