# YouTube API: Get video comments > Gets public top-level comments on a YouTube video, found by link, video ID or title. Reply text is not included. Unofficial. Not affiliated with or endorsed by YouTube. - Page: https://fous.com/methods/youtube.com/get-video-comments - Method: `youtube.com/get_video_comments`, version 1 - Website: youtube.com - Returns: video title, link, total comment count, comments with author, text, likes, posted time, replies, pinned and creator flags - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | `"top"` | Comment order, for example newest. One of "top", "newest". Default "top". | | `video` | string | yes | `"https://www.youtube.com/watch?v=jNQXAC9IVRw"` | Video link or title, for example https://www.youtube.com/watch?v=jNQXAC9IVRw. | | `max_results` | integer | no | `500` | Maximum number of top-level comments, for example 50. Default 50. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "sort": "top", "video": "https://www.youtube.com/watch?v=jNQXAC9IVRw", "max_results": 500 } ``` Its output: ```json { "comments": [ { "likes": 4800000, "pinned": "yes", "author_name": "@SanDiegoZoo", "posted_time": "6 years ago", "comment_link": "https://www.youtube.com/watch?v=jNQXAC9IVRw&lc=UgzuC3zzpRZkjc5Qzsd4AaABAg", "comment_text": "We're so honored that the first ever YouTube video was filmed here!", "video_creator": "no", "number_of_replies": 986, "estimated_posted_date": "2020-10-31" }, { "likes": 12000, "pinned": "no", "author_name": "@JoaoGoofyAhh", "posted_time": "1 month ago", "comment_link": "https://www.youtube.com/watch?v=jNQXAC9IVRw&lc=Ugztdj9x7C3LKBY7ewR4AaABAg", "comment_text": "Okay guys I'm on the 1st of September of 2026, and... Why YouTube?", "video_creator": "no", "number_of_replies": 385, "estimated_posted_date": "2026-09-30" }, { "likes": 213000, "pinned": "no", "author_name": "@TapL", "posted_time": "1 year ago", "comment_link": "https://www.youtube.com/watch?v=jNQXAC9IVRw&lc=UgwVNlctFgmvFU1PTuN4AaABAg", "comment_text": "Seeing \"20 years ago\" on a YouTube video makes me feel a certain type of way", "video_creator": "no", "number_of_replies": 996, "estimated_posted_date": "2025-10-31" } ], "video_link": "https://www.youtube.com/watch?v=jNQXAC9IVRw", "video_title": "Me at the zoo", "comments_turned_off": "no", "total_comment_count": 10000000 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"youtube.com/get_video_comments","input":{"sort":"top","video":"https://www.youtube.com/watch?v=jNQXAC9IVRw","max_results":500}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Pull the top 30 comments on this video https://www.youtube.com/watch?v=dQw4w9WgXcQ and show who posted them and how many likes each got - Get the newest 20 comments under the video titled "Me at the zoo" - I need the total comment count and the first 100 comments, sorted by newest, for the YouTube video with ID 9bZkp7q19f0 - Show me the most-liked comments on my latest tutorial video, including whether the creator pinned any of them - Fetch the top-level comments on https://www.youtube.com/watch?v=kJQP7kiw5Fk sorted by top, limit 75, with posted times ## Input schema ```json { "type": "object", "required": [ "video" ], "properties": { "sort": { "enum": [ "top", "newest" ], "type": "string", "default": "top", "description": "Comment order, for example newest." }, "video": { "type": "string", "description": "Video link or title, for example https://www.youtube.com/watch?v=jNQXAC9IVRw." }, "max_results": { "type": "integer", "default": 50, "maximum": 500, "minimum": 1, "description": "Maximum number of top-level comments, for example 50." } } } ``` ## Output schema ```json { "type": "object", "required": [ "video_title", "video_link", "total_comment_count", "comments_turned_off", "comments" ], "properties": { "comments": { "type": "array", "items": { "type": "object", "properties": { "likes": { "type": "integer" }, "pinned": { "enum": [ "yes", "no" ], "type": "string" }, "author_name": { "type": [ "string", "null" ] }, "posted_time": { "type": "string" }, "comment_link": { "type": "string" }, "comment_text": { "type": "string" }, "video_creator": { "enum": [ "yes", "no" ], "type": "string" }, "number_of_replies": { "type": "integer" }, "estimated_posted_date": { "type": [ "string", "null" ] } } } }, "video_link": { "type": "string" }, "video_title": { "type": "string" }, "comments_turned_off": { "enum": [ "yes", "no" ], "type": "string" }, "total_comment_count": { "type": "integer" } } } ``` ## See more - [YouTube API: Get video](https://fous.com/methods/youtube.com/get-video.md): Gets public details and statistics for one YouTube video by link, ID or title. A title selects the top search match. - [YouTube API: List channel videos](https://fous.com/methods/youtube.com/list-channel-videos.md): Lists a YouTube channel's public videos, Shorts, or live uploads, newest first or most popular first, along with channel details. Counts and dates taken from displayed text may be approximate. - [YouTube API: List top songs chart](https://fous.com/methods/youtube.com/list-top-songs.md): Lists the latest weekly YouTube Music Top Songs chart for a country or globally, with ranks, weekly views and video links. - [YouTube API: Get video transcript](https://fous.com/methods/youtube.com/get-video-transcript.md): Returns the spoken captions and timed segments of a YouTube video, given a video link or a title (top search match). Only captions the video has are returned. - [YouTube API: Find a company's channel](https://fous.com/methods/youtube.com/find-company-channel.md): Finds a company's verified YouTube channel by name and returns its name, link, subscriber count, description, country and official website when identifiable. - [YouTube API: Get channel](https://fous.com/methods/youtube.com/get-channel.md): Gets a public YouTube channel's profile, links and statistics from its name, @handle or link. Subscriber totals may be rounded as YouTube displays them. - [Vimeo API: Get video details](https://fous.com/methods/vimeo.com/get-video.md): Gets a public Vimeo video's title, creator, play, like and comment counts, length, upload date, description, tags, thumbnail and link from its video link. - [Hacker News API: Search stories](https://fous.com/methods/news.ycombinator.com/search-stories.md): Searches Hacker News stories or comments by words, date range and sort order. Comments include their parent story's website link when one exists; text-only stories have no website link. - [All YouTube methods](https://fous.com/methods/youtube.com.md)