YouTube content-link lookup
YouTube content-link lookup. Follow concrete contracts, examples and reviewable steps using YouTube.
Copy the agent prompt manually
YouTube content lookup
Paste a complete link or identifier, then explicitly run a fictional local sample. The source URL is never requested and no credits are spent.
Use a complete URL or platform identifier. Open short links yourself and copy the complete address. Editing clears the old result and does not execute anything.
Fictional fixture · 0 live calls · 0 charges
Inspect complete JSON
Input and result
This tool maps the task to youtube.videos.get. Check the input fields below, then run it in the local console; results are fixtures.
Input contract
Inspect meanings, examples and conditional rules for the selected method. view and fields control the response without changing the TEST unit price.
- GET: supply exactly one of id / url.
| Method | Field | Type | Requirement | Meaning | Enum or bound | Example |
|---|---|---|---|---|---|---|
| GET | id | string | Optional / conditional | Video ID | — | "dQw4w9WgXcQ" |
| GET | url | string | Optional / conditional | Link to the video: a watch, shorts, embed, live or youtu.be link | — | — |
| GET | view | string | Optional / conditional | How much of each item: compact (the most used fields, long text cut short), standard, or full (adds `ext`). | ["compact","standard","full"] | — |
| GET | fields | array | Optional / conditional | Return only these fields of each item, by path (`author.name`). | maxItems: 64 | — |
Try it locally
Use demo to inspect the fields, then explicitly select simulated with a customer test key to exercise settlement. Never put a customer key in a URL.
{
"capability": "youtube.videos.get",
"method": "GET",
"params": {
"id": "dQw4w9WgXcQ"
}
}Output fields and interpretation
The post object permits missing or null values; do not replace missing measurements with zero. This table shows the main structure; the object reference covers nested fields.
| Field | Type | Meaning | Source scope |
|---|---|---|---|
| id | string | null | ID; pass it unchanged to the get endpoint | YouTube |
| url | string | null | Link that opens the post | YouTube |
| type | string | null | Content format | YouTube |
| title | string | null | Title | YouTube |
| text | string | null | Body text | YouTube |
| lang | string | null | Language of the text (standard view and up) | YouTube |
| published_at | string | null | When it was published | YouTube |
| author | object | null | Author | YouTube |
| author.id | string | null | Author's account ID | YouTube |
| author.username | string | null | Author's handle | YouTube |
| author.name | string | null | Author's display name | YouTube |
| author.avatar_url | string | null | Author's avatar (standard view and up) | YouTube |
| author.verified | boolean | null | Whether the author is verified (standard view and up) | YouTube |
| author.followers | integer | null | Author's follower count (standard view and up) | YouTube |
| metrics | object | null | Engagement counts | YouTube |
| metrics.likes | integer | null | Likes | YouTube |
| metrics.comments | integer | null | Comments | YouTube |
| metrics.shares | integer | null | Shares | YouTube |
| metrics.favorites | integer | null | Saves | YouTube |
| metrics.views | integer | null | Views | YouTube |
| metrics.reposts | integer | null | Reposts | YouTube |
| images | array | null | Image addresses (standard view and up) | YouTube |
| hashtags | array | null | Hashtags, without the # (standard view and up) | YouTube |
| mentions | array | null | Accounts mentioned in the text (standard view and up) | YouTube |
| mentions[].id | string | null | Account ID (standard view and up) | YouTube |
| mentions[].username | string | null | Handle (standard view and up) | YouTube |
| mentions[].name | string | null | Display name (standard view and up) | YouTube |
| is_pinned | boolean | null | Whether the author pinned it (standard view and up) | YouTube |
| post_id | string | null | ID of the thread's root post when this is a reply; otherwise null | YouTube |
| parent_id | string | null | ID of the item it replies to directly; otherwise null | YouTube |
| root_id | string | null | ID of the first-level reply its thread hangs under | YouTube |
| approximate | array | null | Which numbers of this item are approximate or lower bounds; absent when all are exact | YouTube |
| approximate[].field | string | null | Path of the field, such as metrics.views | YouTube |
| approximate[].kind | string | null | Approximate, or a lower bound | YouTube |
| ext | object | The platform's own fields (full view). | YouTube |
| ext.duration | number | null | Length of the video, in seconds (full view) | YouTube |
| ext.category | string | null | The section the video is filed under, in the platform's words (数码, 美食制作, say) (full view) | YouTube |
| ext.video_id | string | null | ID of the video a channel post carries: pass it unchanged to the video endpoint; null for a post without one (full view) | YouTube |
| ext.keywords | array | null | The tags (keywords) the author set on the video, not shown on its page; an empty list where none were set (full view) | YouTube |
| ext.chapters | array | null | The video's chapters (the parts its progress bar is divided into), in order of time; an empty list where it has none (full view) | YouTube |
| ext.chapters[].title | string | null | The chapter's title (full view) | YouTube |
| ext.chapters[].start | number | null | Second of the video the chapter starts at (full view) | YouTube |
Clear inputs. Inspectable output.
Each click runs a local fixture. Advanced JSON inputs are checked against the selected method. Editing does not execute a request.
Copying does not execute. CLI quote is read-only and needs a local customer TEST key. Configure MCP in demo mode first. GET and POST batches both return only fictional local fixtures.
Download contract example (no execution) ↗For TEST budgets, Key scopes or failure scenarios, open the account console. Customer sandbox ↗