Skip to main content
This section documents the videos data returned by the Google AI Mode endpoint. 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.
{
  "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.
Videos in AI Mode

Video structure

FieldTypeDescription
titlestringVideo title
linkstringCanonical watch URL (timestamp parameters stripped)
platformstringHosting platform parsed from the card byline (e.g. YouTube)
channelstringChannel or uploader name
durationstringVisible duration label (mm:ss or hh:mm:ss)
thumbnailstringPublic thumbnail URL

Response example

{
  "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"
      }
    ]
  }
}