In this guide

Top Videos

The channel's best videos for a date range, ranked.

Action referenceRead

What this action does #

First, connect YouTube Analytics in Services. Then open Actions → + → YouTube Analytics and choose Top Videos.

More about this action

Each row names a video by ID — hand those to YouTube's Get Video Details for titles and thumbnails.

Inputs to fill in #

Open an input to choose its value. Keep a fixed value with Text, receive it from Shortcuts, ask when the action runs, or use an Earlier Step. Read how input sources work.

From

RequiredDate

The first day counted — a date, or words like 28 days ago.

Default: 28 days ago

Example value (replace with your own):

28 days ago

To

RequiredDate

The last day counted. The latest two or three days aren't in yet.

Default: today

Example value (replace with your own):

today

Rank By

OptionalChoice

Most first. -views when empty.

Choices: -views, -estimatedMinutesWatched, -subscribersGained, -likes, -comments, -shares

How Many

OptionalWhole number

1–200. 10 when empty.

Example value (replace with your own):

What comes back #

In the action editor, open Output → Returned Value to choose fields for your shortcut. These are the response fields described by the app; a service may omit an optional field or return an empty list. JSON File contains the full response.

Returned field	Type	Meaning
`rows`	array	A row per video, best first.
`rows[].video`	string	The video ID. Its page is youtube.com/watch?v= followed by it.
`rows[].views`	integer	Whole-number value.
`rows[].estimatedMinutesWatched`	integer	Minutes of watching, all viewers together.
`rows[].averageViewDuration`	integer	Seconds, per view.
`rows[].averageViewPercentage`	number	How much of a video a view lasted, as a percentage.
`rows[].subscribersGained`	integer	Whole-number value.
`rows[].likes`	integer	Whole-number value.
`rows[].comments`	integer	Whole-number value.
`rows[].shares`	integer	Whole-number value.

Run it from Shortcuts #

Give the action a recognizable name and tap Save.
In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
Supply any Param or File slots you bound in the inputs, then run the shortcut.

If the result is unexpected, open Logs in Shortcutify, select the run, and inspect this step’s inputs and response.

Advanced reference #

Request, permissions, and identifiers

Request: GET https://youtubeanalytics.googleapis.com/v2/reports

Action identifier: youtubeanalytics.videos.top.v1

Permissions declared for this action: https://www.googleapis.com/auth/youtube.readonly, https://www.googleapis.com/auth/yt-analytics.readonly. The account’s own access rules also apply.

Input	Request key	Location
From	`startDate`	query
To	`endDate`	query
Rank By	`sort`	query
How Many	`maxResults`	query

YouTube Analytics API reference