YouTube tools
Channel overview, top videos, traffic sources, subscriber trend and comparison with Google Ads. Read only.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools6 tools
youtube_channel_overview
読み取り1 creditsChannel(s) of the connected account with subscribers, total views, video count, plus views, watch time, average view duration and subscriber change for the period versus the previous period. Read only.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–730) | — |
startOptional | string | YYYY-MM-DD |
endOptional | string | YYYY-MM-DD |
youtube_top_videos
読み取り1 creditsTop videos of the period ranked by watch time (default) or views, with average view duration and percentage. Read only.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–730) | — |
startOptional | string | YYYY-MM-DD |
endOptional | string | YYYY-MM-DD |
byOptional | watch_time | views | — |
limitOptional | integer (1–200) | — |
youtube_traffic_sources
読み取り1 creditsHow viewers found the channel or one video: YouTube search, suggested videos, external sites, playlists, subscriptions, ads… with share of views and organic vs paid split. Read only.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–730) | — |
startOptional | string | YYYY-MM-DD |
endOptional | string | YYYY-MM-DD |
video_idOptional | string | — |
top_videoOptional | boolean | analyse the most viewed video of the period |
youtube_subscriber_trend
読み取り1 creditsSubscribers gained/lost per week (and per day on request) over the period; with since=date compares the daily average before and after a campaign start. Read only.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–730) | — |
startOptional | string | YYYY-MM-DD |
endOptional | string | YYYY-MM-DD |
sinceOptional | string | campaign start date YYYY-MM-DD to compare before/after |
dailyOptional | boolean | — |
youtube_high_retention_videos
読み取り2 creditsVideos with few views but high average view percentage (above the channel median): candidates to replicate or promote. Read only.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–730) | — |
startOptional | string | YYYY-MM-DD |
endOptional | string | YYYY-MM-DD |
min_viewsOptional | integer | — |
limitOptional | integer (1–50) | — |
youtube_vs_google_ads
読み取り2 creditsOrganic YouTube views and watch time versus Google Ads VIDEO campaign spend and paid views for the same period. Each source reports honestly if not connected. Read only.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–730) | — |
startOptional | string | YYYY-MM-DD |
endOptional | string | YYYY-MM-DD |