{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/linkdigest-dev/json-schema/linkdigest-dev-capture-result-schema.json",
  "title": "CaptureResult",
  "description": "A capture still being read, or the digest it produced. A capture is private to the account that sent it.",
  "x-generated": "2026-11-17",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/linkdigest-dev-openapi.json#/components/schemas/CaptureResult",
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "running or done."
    },
    "stage": {
      "type": [
        "string",
        "null"
      ],
      "description": "What the reader is doing now (running)."
    },
    "retryAfter": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Seconds to wait before polling again (running)."
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "The digest's title (done)."
    },
    "credits": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Credits this capture cost, charged once (done)."
    },
    "view_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "The digest's page on the site (done)."
    },
    "digest": {
      "$ref": "#/$defs/Digest"
    },
    "annotation": {
      "$ref": "#/$defs/Annotation"
    }
  },
  "$defs": {
    "Annotation": {
      "type": "object",
      "description": "Present only when format=annotation: the read as a timeline — speech with start and end, timed frame descriptions, on-screen spans, chapters and key points with quotes. Ends are derived, not measured.",
      "properties": {
        "version": {
          "type": "string",
          "description": "The shape's version, \"1\"."
        },
        "source": {
          "type": "string",
          "description": "The link or page the video came from."
        },
        "platform": {
          "type": "string",
          "description": "Where it came from."
        },
        "title": {
          "type": "string",
          "description": "The post's title."
        },
        "duration_seconds": {
          "type": [
            "number",
            "null"
          ],
          "description": "Length of the video."
        },
        "depth": {
          "type": "string",
          "description": "full, transcript or script."
        },
        "speech": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "One speech segment.",
            "properties": {
              "start": {
                "type": "number",
                "description": "Seconds."
              },
              "end": {
                "type": "number",
                "description": "Seconds: the next segment's start, the last one the end of what was read."
              },
              "text": {
                "type": "string",
                "description": "What was said."
              },
              "approx": {
                "type": "boolean",
                "description": "True when start was estimated inside a recogniser chunk."
              }
            }
          },
          "description": "What was said, in order."
        },
        "frames": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "One sampled frame.",
            "properties": {
              "t": {
                "type": "number",
                "description": "Seconds."
              },
              "description": {
                "type": "string",
                "description": "What the frame shows."
              },
              "ocr": {
                "type": "string",
                "description": "Its text, verbatim."
              }
            }
          },
          "description": "Every sampled frame, in time order (empty on reads cached before 2026-11-07)."
        },
        "on_screen": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "On-screen text with its span.",
            "properties": {
              "start": {
                "type": "number",
                "description": "Seconds."
              },
              "end": {
                "type": "number",
                "description": "Seconds; derived from the next item's start."
              },
              "text": {
                "type": "string",
                "description": "On-screen text"
              }
            }
          },
          "description": "On-screen text: until the next text appears or the next frame, else the end."
        },
        "chapters": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "One chapter.",
            "properties": {
              "t": {
                "type": "number",
                "description": "Seconds."
              },
              "title": {
                "type": "string",
                "description": "The chapter title."
              }
            }
          },
          "description": "Chapters the author or platform marked."
        },
        "outline": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "One outline section.",
            "properties": {
              "start": {
                "type": "number",
                "description": "Seconds."
              },
              "end": {
                "type": "number",
                "description": "Seconds."
              },
              "title": {
                "type": "string",
                "description": "What the section is about."
              },
              "summary": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "One line."
                },
                "description": "What is said in it."
              }
            }
          },
          "description": "The timed outline of a long video (the digest's `outline`); empty when it has none."
        },
        "key_points": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "One key point with its quote.",
            "properties": {
              "text": {
                "type": "string",
                "description": "The point."
              },
              "quote": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The words in the post that back it."
              },
              "t": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Seconds, when the quote is from the speech, the screen or a chapter."
              },
              "verified": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "True when the quote was found word for word."
              }
            }
          },
          "description": "The key points, each with the quote it rests on."
        },
        "coverage": {
          "type": [
            "object",
            "null"
          ],
          "description": "The digest's coverage receipt."
        }
      }
    },
    "Digest": {
      "type": "object",
      "description": "A post as LLM-ready text. chapters, chapter_source, category, music, image_count, images_read, coverage and key_point_support (added 2026-10-05) may be absent from links cached before then, as may links (added the same day).",
      "properties": {
        "platform": {
          "type": "string",
          "description": "xiaohongshu, douyin, tiktok, youtube, x or web."
        },
        "author": {
          "type": "string",
          "description": "The author's display name."
        },
        "title": {
          "type": "string",
          "description": "The post's title. On Douyin its own title (item_title) when it has one, else the caption's first 120 characters; on YouTube the watch page's title when the page can be read, else Gemini's reading of the video."
        },
        "posted_at": {
          "type": "string",
          "description": "When it was posted (YYYY-MM-DD), when known."
        },
        "caption": {
          "type": "string",
          "description": "The post's own text."
        },
        "transcript": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "One transcript segment.",
            "properties": {
              "t": {
                "type": "number",
                "description": "Start time in seconds."
              },
              "text": {
                "type": "string",
                "description": "What was said."
              },
              "approx": {
                "type": "boolean",
                "description": "True when t was estimated from the sentence's place inside a longer recogniser chunk."
              }
            }
          },
          "description": "What is said in the video, with times. Empty for image notes."
        },
        "transcript_source": {
          "type": "string",
          "description": "native_captions, asr or none."
        },
        "ocr_text": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A piece of on-screen text."
          },
          "description": "Every distinct piece of text read from the images or frames."
        },
        "on_screen": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "Text on screen at a time.",
            "properties": {
              "t": {
                "type": "number",
                "description": "Approximate time in seconds."
              },
              "text": {
                "type": "string",
                "description": "The text on screen."
              }
            }
          },
          "description": "Video only: on-screen text with roughly when it appeared. Text shown for most of the video is in on_screen_persistent instead, once."
        },
        "on_screen_persistent": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A line of text shown for most of the video."
          },
          "description": "Video only: the title card, watermark or slogan that stayed on screen, taken out of each on_screen entry."
        },
        "frames": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "One sampled frame.",
            "properties": {
              "t": {
                "type": "number",
                "description": "Seconds into the video the frame was taken."
              },
              "description": {
                "type": "string",
                "description": "What the frame shows, in a few words."
              },
              "ocr": {
                "type": "string",
                "description": "The text in that frame, verbatim."
              }
            }
          },
          "description": "Video only (2026-11-07; absent on links cached before then): every sampled frame with its time, a short description and its text."
        },
        "annotation": {
          "$ref": "#/$defs/Annotation"
        },
        "images": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "One post image.",
            "properties": {
              "description": {
                "type": "string",
                "description": "What the image shows."
              },
              "ocr": {
                "type": "string",
                "description": "The text inside it, verbatim."
              }
            }
          },
          "description": "Each post image described and read (image notes)."
        },
        "key_points": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A takeaway."
          },
          "description": "The substantive takeaways, in the post's language."
        },
        "key_point_support": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "The words behind one key point.",
            "properties": {
              "point_index": {
                "type": "integer",
                "description": "0-based index into key_points."
              },
              "kind": {
                "type": "string",
                "description": "Where the quote was found: transcript, on_screen, image, caption or chapter.",
                "enum": [
                  "transcript",
                  "on_screen",
                  "image",
                  "caption",
                  "chapter"
                ]
              },
              "t": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Seconds into the video where the quote is (transcript, on-screen text, chapter)."
              },
              "image_index": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "0-based index into images, when the quote is in one image."
              },
              "quote": {
                "type": "string",
                "description": "A short phrase, verbatim from the post."
              },
              "verified": {
                "type": "boolean",
                "description": "True when the engine found the quote word for word in the post; false rows are kept."
              },
              "approx": {
                "type": "boolean",
                "description": "True when t is an estimate: a sentence placed inside a recogniser chunk, or a sampled frame's time."
              }
            }
          },
          "description": "One quote per key point the model could quote, checked against the post by code. A point with no verified row has no evidence in the post's own words."
        },
        "stats": {
          "type": [
            "object",
            "null"
          ],
          "description": "Engagement counts as the platform reported them at fetch time.",
          "properties": {
            "likes": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Likes (点赞) the platform showed when the post was read."
            },
            "comments": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Comments (评论)."
            },
            "shares": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Shares (分享)."
            },
            "collects": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Saves (收藏)."
            },
            "plays": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Plays (播放), when the platform reports them."
            },
            "as_of": {
              "type": "string",
              "description": "The day the counts were read (YYYY-MM-DD) — a snapshot, not a live figure."
            }
          }
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A hashtag, without #."
          },
          "description": "The post's hashtags."
        },
        "comments": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "One comment from the post's share page.",
            "properties": {
              "text": {
                "type": "string",
                "description": "The comment, verbatim."
              },
              "likes": {
                "type": "number",
                "description": "Likes on the comment, or null."
              },
              "replies": {
                "type": "number",
                "description": "Replies under it, or null."
              },
              "posted_at": {
                "type": "string",
                "description": "YYYY-MM-DD, or empty."
              },
              "reply_texts": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "A reply, verbatim."
                },
                "description": "The first replies under it, text only."
              }
            }
          },
          "description": "The first comments the post's public share page served with it (Xiaohongshu: the top few), read with no second request and no login. Never the whole thread; coverage says how many of the post's comments these are. Empty on other platforms and on links cached before 2026-10-17."
        },
        "chapters": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "One chapter.",
            "properties": {
              "t": {
                "type": "number",
                "description": "When the chapter starts, in seconds."
              },
              "title": {
                "type": "string",
                "description": "The chapter's title, as marked."
              },
              "summary": {
                "type": "string",
                "description": "Douyin's one-line summary of a chapter it generated, or empty."
              }
            }
          },
          "description": "Chapters marked on the video by its author or the platform — never inferred. On a partial read, only those in the part read. Empty when the video has none."
        },
        "chapter_source": {
          "type": "string",
          "description": "Who marked the chapters: \"author\", \"platform\" (generated by Douyin), or empty."
        },
        "outline": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "One section.",
            "properties": {
              "start": {
                "type": "number",
                "description": "Where the section starts, in seconds: a transcript line's own time."
              },
              "end": {
                "type": "number",
                "description": "Where it ends: the next section's start, the last one the end of what was read."
              },
              "title": {
                "type": "string",
                "description": "What the section is about."
              },
              "summary": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "One line."
                },
                "description": "One to three lines saying what is said in the section."
              },
              "quote": {
                "type": "string",
                "description": "A phrase from the section's own lines, kept only when it was found there word for word; else empty."
              },
              "generated": {
                "type": "string",
                "description": "\"model\" (the model's plan, checked by code) or \"fallback\" (equal stretches titled by their opening words)."
              }
            }
          },
          "description": "A timed outline of a long video: for a transcript of 8 minutes or more on a video with no marked chapters, 5 to 20 sections in order that cover everything read. Included in the read, no extra credit. Empty on shorter videos, on videos that have chapters, and on links cached before 2026-11-10."
        },
        "parts": {
          "type": [
            "object",
            "null"
          ],
          "description": "A multi-part Bilibili video's own parts (分P). Null for a single video and on links cached before 2026-11-10. Each part is its own read: send the same link with ?p=<number>, one by one or as a batch.",
          "properties": {
            "count": {
              "type": "integer",
              "description": "How many parts the video has."
            },
            "current": {
              "type": "integer",
              "description": "The part this digest is (the link's ?p=, 1 when it names none)."
            },
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "description": "One part.",
                "properties": {
                  "p": {
                    "type": "integer",
                    "description": "The part number: read it with ?p=<number> on the same link."
                  },
                  "title": {
                    "type": "string",
                    "description": "The part's own title."
                  },
                  "seconds": {
                    "type": "number",
                    "description": "Its length in seconds."
                  }
                }
              },
              "description": "The parts in order, at most 200."
            }
          }
        },
        "category": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "One level, broadest first."
          },
          "description": "The platform's own category for the post, e.g. 财经 › 投资理财 › 股票 on Douyin, Education on YouTube."
        },
        "music": {
          "type": "string",
          "description": "The soundtrack (title — artist) when it is not the poster's own voice; else empty."
        },
        "links": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "A link the post points to. Nothing behind it was read.",
            "properties": {
              "url": {
                "type": "string",
                "description": "The address as found, scheme and host lower-cased. wxp://, alipays:// and other app links are kept."
              },
              "found_in": {
                "type": "string",
                "description": "Where it was found: caption, description (YouTube), wechat_read_more (a WeChat article's 阅读原文), qr_code (decoded from an image or frame the read downloaded), on_screen (a well-formed URL in the on-screen or image text) or chapter.",
                "enum": [
                  "caption",
                  "description",
                  "wechat_read_more",
                  "qr_code",
                  "on_screen",
                  "chapter"
                ]
              },
              "label": {
                "type": "string",
                "description": "What it is when known (\"WeChat Pay\", \"QQ group\", \"阅读原文\"), else the words before it in the post, or empty."
              },
              "kind": {
                "type": "string",
                "description": "What opening it would do: web, payment (a WeChat Pay, Alipay or other payment code), group_invite (joins a WeChat, QQ, Telegram… group), app_deeplink (opens an app) or other (a contact card, an account to follow).",
                "enum": [
                  "web",
                  "payment",
                  "group_invite",
                  "app_deeplink",
                  "other"
                ]
              }
            }
          },
          "description": "The links the post points to — in its caption or description, WeChat's 阅读原文, QR codes in its images or frames, on-screen text and chapters — deduplicated, at most 20, and never opened: a link worth reading is a separate digest. Payment codes and group invites are labelled by kind."
        },
        "breakdown": {
          "type": [
            "object",
            "null"
          ],
          "description": "爆款拆解 — how the post is built. Present only when breakdown=true (+1 credit). Quotes are checked against the post; engagement and tags come from the platform, never the model.",
          "properties": {
            "language": {
              "type": "string",
              "description": "The language the analysis is written in, e.g. zh-CN or en."
            },
            "format": {
              "type": "string",
              "description": "The kind of post, e.g. 口播 talking head, 图文笔记 image note, 教程 tutorial."
            },
            "hook": {
              "type": "object",
              "description": "How the post holds people in its first seconds (first image for an image note).",
              "properties": {
                "spoken": {
                  "type": "string",
                  "description": "The opening words, verbatim from the transcript, or empty."
                },
                "on_screen": {
                  "type": "string",
                  "description": "The opening on-screen or cover text, verbatim, or empty."
                },
                "visual": {
                  "type": "string",
                  "description": "What is shown at the start."
                },
                "why": {
                  "type": "string",
                  "description": "Why the opening holds attention."
                }
              }
            },
            "beats": {
              "type": "array",
              "items": {
                "type": "object",
                "description": "One step of the post's structure.",
                "properties": {
                  "t": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Start time in seconds, approximate to a keyframe (video)."
                  },
                  "image": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "description": "1-based image number (image notes)."
                  },
                  "label": {
                    "type": "string",
                    "description": "The step, e.g. 痛点 pain point, 方法 method, 行动号召 call to action."
                  },
                  "summary": {
                    "type": "string",
                    "description": "What happens in this step."
                  },
                  "quote": {
                    "type": "string",
                    "description": "A short line copied verbatim from the post, or empty."
                  }
                }
              },
              "description": "The structure, 3 to 10 steps in order."
            },
            "title_formula": {
              "type": "string",
              "description": "The pattern behind the title, e.g. 数字 + 结果 + 人群."
            },
            "cover_text": {
              "type": "string",
              "description": "Cover or first-frame text, verbatim, or empty."
            },
            "cta": {
              "type": "string",
              "description": "The call to action, verbatim, or empty."
            },
            "audience": {
              "type": "string",
              "description": "Who the post is made for."
            },
            "tags": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "A hashtag, without #."
              },
              "description": "The post's own hashtags, from the platform."
            },
            "engagement": {
              "type": [
                "object",
                "null"
              ],
              "description": "Engagement counts as the platform reported them at fetch time.",
              "properties": {
                "likes": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "Likes (点赞) the platform showed when the post was read."
                },
                "comments": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "Comments (评论)."
                },
                "shares": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "Shares (分享)."
                },
                "collects": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "Saves (收藏)."
                },
                "plays": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "Plays (播放), when the platform reports them."
                },
                "as_of": {
                  "type": "string",
                  "description": "The day the counts were read (YYYY-MM-DD) — a snapshot, not a live figure."
                }
              }
            },
            "template": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "One step with [placeholders]."
              },
              "description": "4 to 8 steps to make your own version."
            },
            "remix_ideas": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "An angle."
              },
              "description": "2 or 3 angles for a different version of the same idea."
            },
            "missing": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "A missing signal."
              },
              "description": "What the analysis could not see (no speech, a partial read…)."
            }
          }
        },
        "answer": {
          "type": [
            "object",
            "null"
          ],
          "description": "The caller's question answered from the post. Present only when ask was sent (+1 credit).",
          "properties": {
            "question": {
              "type": "string",
              "description": "The question, as cleaned by the engine."
            },
            "answer": {
              "type": "string",
              "description": "The answer, from the post only; says the post does not say when it does not."
            },
            "found": {
              "type": "boolean",
              "description": "False when the post does not address the question — nothing was invented."
            },
            "support": {
              "type": "array",
              "items": {
                "type": "object",
                "description": "One quote behind the answer, checked by code.",
                "properties": {
                  "kind": {
                    "type": "string",
                    "description": "Where the quote is: transcript, on_screen, image, caption or chapter."
                  },
                  "t": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Seconds into the video, when the quote has a time."
                  },
                  "image_index": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "description": "0-based image index, when the quote is in one image."
                  },
                  "quote": {
                    "type": "string",
                    "description": "A short phrase the answer rests on, verbatim from the post."
                  },
                  "verified": {
                    "type": "boolean",
                    "description": "True when the engine found the quote word for word in the post."
                  },
                  "approx": {
                    "type": "boolean",
                    "description": "True when t is an estimate."
                  }
                }
              },
              "description": "The quotes the answer rests on (1-3); empty when found is false."
            }
          }
        },
        "insight": {
          "type": [
            "object",
            "null"
          ],
          "description": "消费者洞察 — what the post says about the people it speaks to. Present only when insight=true (+1 credit). Every item is a quote checked against the post and its top comments; nothing is invented.",
          "properties": {
            "language": {
              "type": "string",
              "description": "The language the insight is written in, e.g. zh-CN or en."
            },
            "audience": {
              "type": "object",
              "description": "Who the post speaks to.",
              "properties": {
                "found": {
                  "type": "boolean",
                  "description": "False when the post and its comments do not support this section; items is then empty."
                },
                "items": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "description": "One finding and the quote behind it, checked by code.",
                    "properties": {
                      "text": {
                        "type": "string",
                        "description": "The finding, in the insight's language."
                      },
                      "quote": {
                        "type": "string",
                        "description": "The words it rests on, verbatim from the post or a comment."
                      },
                      "kind": {
                        "type": "string",
                        "description": "Where the quote is: caption, transcript, on_screen, image, chapter or comment."
                      },
                      "verified": {
                        "type": "boolean",
                        "description": "True when the engine found the quote word for word in the post or its comments."
                      },
                      "t": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Seconds into the video, when the quote has a time."
                      },
                      "image_index": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "0-based image index, when the quote is in one image."
                      },
                      "approx": {
                        "type": "boolean",
                        "description": "True when t is an estimate."
                      }
                    }
                  },
                  "description": "The findings; empty when found is false."
                }
              }
            },
            "claims": {
              "type": "object",
              "description": "The benefits and claims the post makes.",
              "properties": {
                "found": {
                  "type": "boolean",
                  "description": "False when the post and its comments do not support this section; items is then empty."
                },
                "items": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "description": "One finding and the quote behind it, checked by code.",
                    "properties": {
                      "text": {
                        "type": "string",
                        "description": "The finding, in the insight's language."
                      },
                      "quote": {
                        "type": "string",
                        "description": "The words it rests on, verbatim from the post or a comment."
                      },
                      "kind": {
                        "type": "string",
                        "description": "Where the quote is: caption, transcript, on_screen, image, chapter or comment."
                      },
                      "verified": {
                        "type": "boolean",
                        "description": "True when the engine found the quote word for word in the post or its comments."
                      },
                      "t": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Seconds into the video, when the quote has a time."
                      },
                      "image_index": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "0-based image index, when the quote is in one image."
                      },
                      "approx": {
                        "type": "boolean",
                        "description": "True when t is an estimate."
                      }
                    }
                  },
                  "description": "The findings; empty when found is false."
                }
              }
            },
            "objections": {
              "type": "object",
              "description": "Pain points, complaints and doubts — from the comments when they were read.",
              "properties": {
                "found": {
                  "type": "boolean",
                  "description": "False when the post and its comments do not support this section; items is then empty."
                },
                "items": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "description": "One finding and the quote behind it, checked by code.",
                    "properties": {
                      "text": {
                        "type": "string",
                        "description": "The finding, in the insight's language."
                      },
                      "quote": {
                        "type": "string",
                        "description": "The words it rests on, verbatim from the post or a comment."
                      },
                      "kind": {
                        "type": "string",
                        "description": "Where the quote is: caption, transcript, on_screen, image, chapter or comment."
                      },
                      "verified": {
                        "type": "boolean",
                        "description": "True when the engine found the quote word for word in the post or its comments."
                      },
                      "t": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Seconds into the video, when the quote has a time."
                      },
                      "image_index": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "0-based image index, when the quote is in one image."
                      },
                      "approx": {
                        "type": "boolean",
                        "description": "True when t is an estimate."
                      }
                    }
                  },
                  "description": "The findings; empty when found is false."
                }
              }
            },
            "purchase_intent": {
              "type": "object",
              "description": "Purchase-intent cues: 求链接, 多少钱, 哪里买 and the like.",
              "properties": {
                "found": {
                  "type": "boolean",
                  "description": "False when the post and its comments do not support this section; items is then empty."
                },
                "items": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "description": "One finding and the quote behind it, checked by code.",
                    "properties": {
                      "text": {
                        "type": "string",
                        "description": "The finding, in the insight's language."
                      },
                      "quote": {
                        "type": "string",
                        "description": "The words it rests on, verbatim from the post or a comment."
                      },
                      "kind": {
                        "type": "string",
                        "description": "Where the quote is: caption, transcript, on_screen, image, chapter or comment."
                      },
                      "verified": {
                        "type": "boolean",
                        "description": "True when the engine found the quote word for word in the post or its comments."
                      },
                      "t": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Seconds into the video, when the quote has a time."
                      },
                      "image_index": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "0-based image index, when the quote is in one image."
                      },
                      "approx": {
                        "type": "boolean",
                        "description": "True when t is an estimate."
                      }
                    }
                  },
                  "description": "The findings; empty when found is false."
                }
              }
            },
            "products": {
              "type": "object",
              "description": "Products, brands and prices named.",
              "properties": {
                "found": {
                  "type": "boolean",
                  "description": "False when the post and its comments do not support this section; items is then empty."
                },
                "items": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "description": "One finding and the quote behind it, checked by code.",
                    "properties": {
                      "text": {
                        "type": "string",
                        "description": "The finding, in the insight's language."
                      },
                      "quote": {
                        "type": "string",
                        "description": "The words it rests on, verbatim from the post or a comment."
                      },
                      "kind": {
                        "type": "string",
                        "description": "Where the quote is: caption, transcript, on_screen, image, chapter or comment."
                      },
                      "verified": {
                        "type": "boolean",
                        "description": "True when the engine found the quote word for word in the post or its comments."
                      },
                      "t": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Seconds into the video, when the quote has a time."
                      },
                      "image_index": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "0-based image index, when the quote is in one image."
                      },
                      "approx": {
                        "type": "boolean",
                        "description": "True when t is an estimate."
                      }
                    }
                  },
                  "description": "The findings; empty when found is false."
                }
              }
            },
            "questions": {
              "type": "object",
              "description": "Questions readers ask.",
              "properties": {
                "found": {
                  "type": "boolean",
                  "description": "False when the post and its comments do not support this section; items is then empty."
                },
                "items": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "description": "One finding and the quote behind it, checked by code.",
                    "properties": {
                      "text": {
                        "type": "string",
                        "description": "The finding, in the insight's language."
                      },
                      "quote": {
                        "type": "string",
                        "description": "The words it rests on, verbatim from the post or a comment."
                      },
                      "kind": {
                        "type": "string",
                        "description": "Where the quote is: caption, transcript, on_screen, image, chapter or comment."
                      },
                      "verified": {
                        "type": "boolean",
                        "description": "True when the engine found the quote word for word in the post or its comments."
                      },
                      "t": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Seconds into the video, when the quote has a time."
                      },
                      "image_index": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "0-based image index, when the quote is in one image."
                      },
                      "approx": {
                        "type": "boolean",
                        "description": "True when t is an estimate."
                      }
                    }
                  },
                  "description": "The findings; empty when found is false."
                }
              }
            },
            "comments_read": {
              "type": "integer",
              "description": "How many comments were in the material the insight was drawn from."
            },
            "missing": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "A section name."
              },
              "description": "The sections the material could not support."
            }
          }
        },
        "translation": {
          "type": [
            "object",
            "null"
          ],
          "description": "Present only when translate_to was given (+1 credit). The originals are always kept.",
          "properties": {
            "language": {
              "type": "string",
              "description": "The language it was translated into."
            },
            "title": {
              "type": "string",
              "description": "Translated title."
            },
            "caption": {
              "type": "string",
              "description": "Translated caption."
            },
            "key_points": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "A translated takeaway."
              },
              "description": "Translated key points."
            },
            "transcript_text": {
              "type": "string",
              "description": "Translated transcript, as one text."
            },
            "ocr_text": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "Translated on-screen text."
              },
              "description": "Translated on-screen text."
            },
            "image_descriptions": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "Translated description."
              },
              "description": "Translated image descriptions."
            },
            "note": {
              "type": "string",
              "description": "What the translation leaves out, else empty. A transcript past 24,000 characters is translated from its start only, said here and in coverage.not_captured, e.g. \"translation covers the first 27:12 of 60:00 of the transcript\". The original transcript is always whole. Added 2026-10-06."
            }
          }
        },
        "raw_markdown": {
          "type": "string",
          "description": "The whole digest as Markdown, including any breakdown and translation."
        },
        "credits": {
          "type": "integer",
          "description": "What this call cost. 0 when served from cache."
        },
        "credits_left": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Free accounts: credits left after this call (pack credits included). Absent on paying plans. In markdown, the X-Credits-Left header."
        },
        "credits_note": {
          "type": [
            "string",
            "null"
          ],
          "description": "Free accounts with 3 credits or fewer left: the balance and the starter pack's pay link, in English."
        },
        "offer_zh": {
          "type": [
            "string",
            "null"
          ],
          "description": "The same in Chinese, its link opening the ¥ Alipay page; for an agent to relay to its user."
        },
        "cached": {
          "type": "boolean",
          "description": "True when someone had already read this link — free."
        },
        "degraded": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A note."
          },
          "description": "Anything that did not read fully, said plainly."
        },
        "duration_seconds": {
          "type": [
            "number",
            "null"
          ],
          "description": "Media length, when it has one."
        },
        "read_seconds": {
          "type": [
            "number",
            "null"
          ],
          "description": "How much of the media was read."
        },
        "partial": {
          "type": [
            "object",
            "null"
          ],
          "description": "Present only when partial_ok was set and the budget did not cover the whole video, or (since 2026-10-06) the whole image post: then image_count and images_read say how many images were taken.",
          "properties": {
            "read_seconds": {
              "type": "number",
              "description": "Seconds read from the start; 0 for an image post read in part."
            },
            "duration_seconds": {
              "type": "number",
              "description": "The whole video's length; 0 for an image post read in part."
            },
            "read_credits": {
              "type": "integer",
              "description": "What this read cost."
            },
            "full_credits": {
              "type": "integer",
              "description": "What a complete read costs — a fresh digest, not a top-up."
            },
            "transcript_credits": {
              "type": [
                "integer",
                "null"
              ],
              "description": "What a transcript-first read (depth=transcript) of the whole video costs — the cheaper read to ask for next. Equal to full_credits on a transcript-first partial; null when the video is past the transcript-first length cap too."
            }
          }
        },
        "depth": {
          "type": "string",
          "description": "How the video was read: full (frames sampled densely), transcript (transcript-first: the whole transcript plus about a frame a minute, which coverage.not_captured says) or script (the speech only, no frames or on-screen text). A YouTube video read by Gemini is always full. Absent on links cached before 2026-10-05, which were all full.",
          "enum": [
            "full",
            "transcript",
            "script"
          ]
        },
        "auto_depth": {
          "type": [
            "object",
            "null"
          ],
          "description": "Present when the read was switched to transcript-first by the service (2026-11-05): a long video that a full read would not fit in the caller's credits, read whole at transcript depth instead of in part at full depth. Only on the console and the keyless look of a free account; an API call gets the depth it asked for. full_credits is what a full read costs. Since 2026-11-12 also when the video is past the free plan's full-read length (10 minutes), pack credits or not: reason is then length, and the read goes transcript-first as far as that depth's own length cap.",
          "properties": {
            "from": {
              "type": "string",
              "description": "The depth asked for: full."
            },
            "full_credits": {
              "type": "integer",
              "description": "What a full read of the whole video costs."
            },
            "reason": {
              "type": "string",
              "description": "length when the switch was for the plan's full-read length cap rather than the credits. Absent otherwise."
            },
            "full_limit_seconds": {
              "type": "integer",
              "description": "With reason length: the full-read length cap, in seconds."
            }
          }
        },
        "image_count": {
          "type": [
            "integer",
            "null"
          ],
          "description": "How many images the post has, on posts with images."
        },
        "images_read": {
          "type": [
            "integer",
            "null"
          ],
          "description": "How many of them were taken and priced: every one up to 60; past that the first 60, and with partial_ok the first ones the budget covers; degraded says so. Taken is not read: a failed download or vision read still counts here; coverage.images_read is how many were actually read."
        },
        "coverage": {
          "type": [
            "object",
            "null"
          ],
          "description": "How much of the post this digest captured, computed in code. Null on links cached before 2026-10-05.",
          "properties": {
            "seconds_transcribed": {
              "type": [
                "number",
                "null"
              ],
              "description": "Video: seconds whose speech is in the transcript; 0 when there is none."
            },
            "duration_seconds": {
              "type": [
                "number",
                "null"
              ],
              "description": "Video: its length."
            },
            "largest_frame_gap_seconds": {
              "type": [
                "number",
                "null"
              ],
              "description": "Video: the longest stretch of the part read with no new sampled frame, start and end included."
            },
            "images_read": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Image posts: images that came back read."
            },
            "images_total": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Image posts: how many images the post has."
            },
            "transcript_source": {
              "type": "string",
              "description": "native_captions, asr, gemini_video or none."
            },
            "not_captured": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "A plain statement, e.g. \"minutes 12:00-43:58 not read (budget)\" or \"3 of 21 images skipped\"."
              },
              "description": "What was not read, and why. Always names comments, which are never read."
            },
            "links_found": {
              "type": [
                "integer",
                "null"
              ],
              "description": "How many distinct links the post points to; links lists the first 20."
            }
          }
        },
        "source_url": {
          "type": "string",
          "description": "The link as resolved."
        }
      }
    }
  }
}