# YouTube content-link lookup

YouTube content-link lookup. Follow concrete contracts, examples and reviewable steps using YouTube.

Canonical page: https://datanavoapi.com/en/tools/link-youtube/

This is a local simulation. Program-generated samples are not live platform data and do not establish provider availability.

## 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.

```json
{
  "capability": "youtube.videos.get",
  "method": "GET",
  "params": {
    "id": "dQw4w9WgXcQ"
  }
}
```

- [Open this capability in the console](https://datanavoapi.com/console/?mode=demo&capability=youtube.videos.get&method=GET&params=%7B%22id%22%3A%22dQw4w9WgXcQ%22%7D)

## 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 |

- [Complete object reference](https://datanavoapi.com/en/docs/objects/post/)

## Related pages

- [YouTube video detail](https://datanavoapi.com/en/apis/youtube/videos/get/)
- [YouTube APIs](https://datanavoapi.com/en/apis/youtube/)
- [YouTube MCP](https://datanavoapi.com/en/mcp/youtube/)
- [Post fields](https://datanavoapi.com/en/docs/objects/post/)

[中文](https://datanavoapi.com/tools/link-youtube/)
