Comments from YouTube videos for sentiment, FAQ mining and research: text, likes, reply count, publication time, pinned and owner flags, top or newest first, up to 200 videos per run. Deliberately without commenter names, handles or channel ids. Pay only for delivered comments.
One comment (or reply) delivered to the dataset. Videos that fail or have no comments are never charged.
ACTOR=steadydata~youtube-comments URL="https://api.apify.com/v2/acts/$ACTOR/run-sync-get-dataset-items" curl -X POST "$URL?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"videos": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"], "maxCommentsPerVideo": 100, "sort": "top"}'
import os, requests ACTOR = "steadydata~youtube-comments" URL = f"https://api.apify.com/v2/acts/{ACTOR}/run-sync-get-dataset-items" rows = requests.post( URL, params={"token": os.environ["APIFY_TOKEN"]}, json={'videos': ['https://www.youtube.com/watch?v=dQw4w9WgXcQ'], 'maxCommentsPerVideo': 100, 'sort': 'top'}, timeout=900, ).json() # every row carries a status; failures are records, not exceptions ok = [r for r in rows if r.get("status") == "ok"] print(len(ok), "rows delivered")
const ACTOR = "steadydata~youtube-comments"; const url = `https://api.apify.com/v2/acts/${ACTOR}/run-sync-get-dataset-items` + `?token=${process.env.APIFY_TOKEN}`; const rows = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({"videos": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"], "maxCommentsPerVideo": 100, "sort": "top"}), }).then((r) => r.json()); // one object per delivered row, same shape every time console.log(rows.filter((r) => r.status === "ok").length, "rows");
Point an MCP client at Apify's hosted server with this dataset in the tools list, or run our own server locally. The field explanations in the table below travel with the schema, so your agent reads them straight from the platform instead of from this page.
https://mcp.apify.com?tools=steadydata/youtube-comments # the tool arrives in your agent as steadydata--youtube-comments
| Field | Type | Name | What it does |
|---|---|---|---|
videosrequired | array of string | Videos | Video URLs or 11-character video ids, one per row. Each video is one input; a video without comments comes back as a free error record. |
maxCommentsPerVideo | integer | Max comments per video | Cost ceiling: at most this many top-level comments per video, in YouTube's order. One delivered comment is one charged event. |
sort | string | Order | Top comments (YouTube's ranking) or newest first. |
includeReplies | boolean | Include replies | Also fetch the replies under each comment (each reply is a charged comment too, with `parentCommentId` set). Off by default: top-level comments only. |
maxRepliesPerComment | integer | Max replies per comment | Only used when replies are on. |
language | string | Language | Interface language for relative dates such as '2 weeks ago' (hl). |
{
"videoId": string | null,
"commentId": string | null,
"parentCommentId": string | null,
"rank": integer | null,
"text": string | null,
"likeCount": integer | null,
"replyCount": integer | null,
"publishedText": string | null,
"isOwner": boolean | null,
"isPinned": boolean | null,
"hasCreatorHeart": boolean | null,
"isReply": boolean | null,
"commentUrl": string | null,
"status": string | null,
"input": string | null,
"errorCode": string | null,
"error": string | null
}| Field | Type | When it is filled |
|---|---|---|
videoId | string, null | |
commentId | string, null | |
parentCommentId | string, null | |
rank | integer, null | |
text | string, null | |
likeCount | integer, null | |
replyCount | integer, null | |
publishedText | string, null | |
isOwner | boolean, null | |
isPinned | boolean, null | |
hasCreatorHeart | boolean, null | |
isReply | boolean, null | |
commentUrl | string, null | |
status | string, null | Either 'ok' or 'error'. An error row carries errorCode and error, and leaves the data fields empty; it is never charged. |
input | string, null | The input this row was built from, so a row can always be traced back. |
errorCode | string, null | Filled on an error row only; a delivered row leaves it empty. |
error | string, null | Filled on an error row only; a delivered row leaves it empty. |
Channel profiles for up to 500 YouTube channels per run, by handle, id or URL: name, handle, subscribers, exact total views and video count, country, description, verified badge, external links, avatar and banner. No e-mail addresses. Pay only for delivered channels.
$2.50 per 1,000 · Channel fetchedEvery stream on a YouTube channel's Live tab, up to 100 channels per run: live now with viewers watching, scheduled with the start time, and past streams with views and duration. One row per stream, in YouTube's order. No viewer or chat data. Pay per delivered stream.
$1.00 per 1,000 · Stream listedFind YouTube channels by keyword: channel id, name, handle, subscriber count, video count, verified badge and thumbnail, ranked as YouTube ranks them. Up to 200 keywords per run. No email addresses or contact details. Only delivered channels are charged.
$1.00 per 1,000 · Channel listedAlready using this one? Ratings are the first thing other buyers look at, and this dataset has none yet. If it does a job for you, a rating on its Apify page is the one thing that helps. It takes a minute and it is the only thing we ask for.