Video metadata and captions
video_metadataRead-onlyIdempotent
Video metadata and captions. Use this when the user has a Wikimedia Commons file, an Internet Archive identifier, or a YouTube watch URL and wants the public record. Pass that reference. Commons and the Internet Archive return the licence, attribution, a download link and any caption file the official metadata lists. A YouTube URL returns the title and channel only, from oEmbed or the Data API when a key is configured, with no download and no caption file. We do not rip videos: downloading from TikTok, YouTube, Instagram, X, Douyin, Bilibili or Xiaohongshu, or stripping a watermark, breaks those sites' terms. A TikTok, Instagram, X, Douyin, Bilibili or Xiaohongshu link returns that explanation and is not fetched.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | Yes | A Wikimedia Commons file title or page URL, an Internet Archive identifier or details URL, or a YouTube watch URL |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | Yes | ||
| as_of | Yes | ||
| error | No | Present when status is not ok: a stable code, what went wrong and what to do next. | |
| files | Yes | ||
| title | No | ||
| source | Yes | ||
| status | Yes | ||
| creator | No | ||
| licence | No | ||
| captions | Yes | ||
| page_url | No | ||
| attribution | No | ||
| explanation | No | ||
| licence_url | No | ||
| download_url | No | ||
| licence_note | No | ||
| captions_note | No | ||
| download_kind | Yes | ||
| thumbnail_url | No |