In this guide

Get Comments

A video's comments, top or newest first.

Action referenceRead

What this action does #

First, connect YouTube in Services. Then open Actions → + → YouTube and choose Get Comments.

More about this action

The comments under a video, without their replies — each has a reply count, and Get Replies reads them with its ID. A video with comments turned off is an error, not an empty list.

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.

Video

RequiredText

A video link or ID.

Example value (replace with your own):

https://youtu.be/dQw4w9WgXcQ

Sort By

OptionalChoice

relevance is top comments first; time is newest first.

Choices: relevance, time

Containing

OptionalText

Only comments with these words.

How Many

OptionalWhole number

1–100 a page. YouTube sends 20 when it's left empty.

Example value (replace with your own):

Page Token

OptionalText

Where the previous page left off — its nextPageToken.

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
`items`	array	A list of values.
`items[].id`	string	The comment's ID, for Get Replies.
`items[].snippet`	object	A group of named values.
`items[].snippet.totalReplyCount`	integer	Whole-number value.
`items[].snippet.topLevelComment`	object	A group of named values.
`items[].snippet.topLevelComment.snippet`	object	A group of named values.
`items[].snippet.topLevelComment.snippet.textDisplay`	string	The comment as plain text.
`items[].snippet.topLevelComment.snippet.authorDisplayName`	string	Text value.
`items[].snippet.topLevelComment.snippet.authorChannelUrl`	string	Text value.
`items[].snippet.topLevelComment.snippet.likeCount`	integer	Whole-number value.
`items[].snippet.topLevelComment.snippet.publishedAt`	string	ISO 8601.
`items[].snippet.topLevelComment.snippet.updatedAt`	string	Differs from publishedAt when it was edited.
`nextPageToken`	string	Text 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.

This action supports multiple pages of results. Open its Fetch setting to retrieve more pages when one page is not enough. Each page adds a service request.

Advanced reference #

Request, permissions, and identifiers

Request: GET https://www.googleapis.com/youtube/v3/commentThreads

Action identifier: youtube.commentThreads.list.v1

No additional per-action permissions are declared in the app’s catalog. The integration’s connection and account access rules still apply.

Input	Request key	Location
Video	`videoId`	query
Sort By	`order`	query
Containing	`searchTerms`	query
How Many	`maxResults`	query
Page Token	`pageToken`	query

YouTube API reference