List YouTube videos
Tool ID: youtube_videos_list
Summary
Pages through videos already on the connected channel, including privacy and view, like, and comment counts.
When to use it
- Recent uploads — See what is on the channel and how each video is doing.
- Find a video id — Use the id with Get video, Get transcript, or Update video.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| YouTube credentials | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
max_results |
No | How many videos per page, from 1 to 50. Default 25. |
page_token |
No | Token from the previous page. Leave it out for the first page. |
What you get back
A list of videos with title, publish time, privacy (public, unlisted, or private), view count, like count, comment count, and a watch URL. next_page_token is null on the last page.
Example prompts
List the latest videos on my YouTube channel with views and privacy.
Show the next page of uploads.
Which of my recent videos are still unlisted?
Tips
- This lists videos already uploaded. It does not search all of YouTube.
- Ask for the next page when you need more than one page.