# YouTube Comments API. Comments, page by page. Newest or top first, with likes and reply counts. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dyoutube.comments) ## YouTube Comments API at a glance Returns the public top-level comments of a YouTube video, short or live replay, a page at a time, newest first or by YouTube's Top ranking. Each comment has its text, author handle and channel, posting time, likes, reply count, and whether it is pinned, hearted, edited or written by the creator. Newest first also takes since and until. Accepts any YouTube video link or an 11-character video ID. GET `/v1/youtube/comments` [Read the API reference](https://socialtap.dev/docs/reference/youtube/comments/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **16 typed fields** null when unknown - **20** comments per page, newest first - **`url`** is all it needs, e.g. `https://www.youtube.com/watch?v=jNQXAC9IVRw` ## Send one request. Get up to 20 comments back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `url = https://www.youtube.com/watch?v=jNQXAC9IVRw` [Open in playground](https://socialtap.dev/playground/?endpoint=youtube.comments) cURL: ```shell curl 'https://socialtap.dev/v1/youtube/comments?sort=newest&url=jNQXAC9IVRw' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.youtube.comments.list({ url: "jNQXAC9IVRw", sort: "newest" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ sort: "newest", url: "jNQXAC9IVRw", }); const res = await fetch(`https://socialtap.dev/v1/youtube/comments?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/youtube/comments", params={"sort": "newest", "url": "jNQXAC9IVRw"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("sort", "newest") q.Set("url", "jNQXAC9IVRw") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/youtube/comments?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [ "published_at", "metrics.like_count", "metrics.reply_count" ], "author": { "avatar_url": "https://yt3.ggpht.com/i8RqA9tYqbbnOi4mlnYEY7IR3kXAoDqQbM_5Sfzw7OjTubiGsOaTdlrIZmj-I0q0Vup68eqs=s88-c-k-c0x00ffffff-no-rj", "display_name": null, "id": "UCC5NfQ6Mf0dq_eEwv4P_hWA", "is_verified": true, "url": "https://www.youtube.com/channel/UCC5NfQ6Mf0dq_eEwv4P_hWA", "username": "SanDiegoZoo" }, "edited_at": null, "id": "UgzuC3zzpRZkjc5Qzsd4AaABAg", "is_by_post_author": false, "is_edited": false, "is_liked_by_author": true, "is_pinned": true, "metrics": { "like_count": 4800000, "reply_count": 1000 }, "parent_id": null, "platform": "youtube", "platform_specific": {}, "post_id": "jNQXAC9IVRw", "published_at": "2020-10-26T18:59:19Z", "text": "We're so honored that the first ever YouTube video was filmed here!", "unknown_fields": [], "url": "https://www.youtube.com/watch?v=jNQXAC9IVRw&lc=UgzuC3zzpRZkjc5Qzsd4AaABAg" }, { "approximate_fields": [ "published_at" ], "author": { "avatar_url": "https://yt3.ggpht.com/U9zdJRwdpo6WwsenxMf6AyMyRMBTWoKsyAWCnJXdbPbNKh-YNEWP3AQRgFto91lckyGCBYENnaw=s88-c-k-c0x00ffffff-no-rj", "display_name": null, "id": "UCjoZE_5A9tO470CK3G6U7dg", "is_verified": false, "url": "https://www.youtube.com/channel/UCjoZE_5A9tO470CK3G6U7dg", "username": "CTwGary" }, "edited_at": null, "id": "UgxHbErLhWMUy5GlFnp4AaABAg", "is_by_post_author": false, "is_edited": false, "is_liked_by_author": false, "is_pinned": false, "metrics": { "like_count": 0, "reply_count": 0 }, "parent_id": null, "platform": "youtube", "platform_specific": {}, "post_id": "jNQXAC9IVRw", "published_at": "2026-10-26T18:58:19Z", "text": "I can’t believe it, but it’s 21 years old now", "unknown_fields": [], "url": "https://www.youtube.com/watch?v=jNQXAC9IVRw&lc=UgxHbErLhWMUy5GlFnp4AaABAg" }, { "approximate_fields": [ "published_at" ], "author": { "avatar_url": "https://yt3.ggpht.com/Ar50xvd1O4GCXVttK6DgX0Y0cuhBl2b_HUFQjh-gajKbmS-qjuNAHOT5fw_RX_DS5gzfphkcKAI=s88-c-k-c0x00ffffff-no-rj", "display_name": null, "id": "UCFgjcRO4y8XFQL7E8_TcLlg", "is_verified": false, "url": "https://www.youtube.com/channel/UCFgjcRO4y8XFQL7E8_TcLlg", "username": "Nihal-poke" }, "edited_at": null, "id": "UgzLOxwwIAUe0jUI4RR4AaABAg", "is_by_post_author": false, "is_edited": false, "is_liked_by_author": false, "is_pinned": false, "metrics": { "like_count": 0, "reply_count": 0 }, "parent_id": null, "platform": "youtube", "platform_specific": {}, "post_id": "jNQXAC9IVRw", "published_at": "2026-10-26T18:58:19Z", "text": "I watch this video many times 😭", "unknown_fields": [], "url": "https://www.youtube.com/watch?v=jNQXAC9IVRw&lc=UgzLOxwwIAUe0jUI4RR4AaABAg" } ], "page": { "has_more": true, "next_cursor": "c1.EXAMPLE_CURSOR", "next_cursor_expires_at": "2026-10-26T12:00:00Z", "end_reason": null }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "youtube", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 316, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "video", "id": "jNQXAC9IVRw", "url": "https://www.youtube.com/watch?v=jNQXAC9IVRw" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 9 platforms. The [response reference](https://socialtap.dev/docs/reference/youtube/comments/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/comment/index.md). - ### Null means unknown A field YouTube doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts YouTube video URL (watch, youtu.be, shorts, live, embed, m./music. hosts) or an 11-character video ID. - ### Write one parser YouTube, TikTok, Instagram and 6 more platforms answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktok, youtube, …). - **`id`string**: Platform-native comment ID (string; Reddit with its t1_ prefix). - **`post_id`string**: ID of the post commented on (equals post.id). - **`parent_id`string**: ID of the comment this replies to; null for top-level comments. - **`url`string**: Permalink, when the platform has one. - **`text`string**: Comment body as plain text. - **`author`object**: The commenting account. An account the platform no longer names (a deleted account) has a null id and username and the platform's label as display_name (Reddit: \[deleted\]). - **`published_at`string**: When the comment was posted, RFC 3339 UTC. Where the platform shows only a relative time ("3 weeks ago"), the latest time that label allows (the fetch time minus the stated amount), listed in approximate_fields. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the YouTube Comments API. - ### Track sentiment on your videos and competitors' - ### Monitor new comments since a date - ### Find questions and feedback to answer - ### Build comment datasets for research ## Good to know before you build. - YouTube shows comment times as relative labels ("3 weeks ago"). published_at is the latest time the label allows and is listed in approximate_fields, so since and until are approximate to the label's unit. - YouTube rounds like and reply counts above a thousand ("4.8K"), and approximate_fields lists them. - Comments show the author's @handle, and author.display_name is null. - The newest order includes comments YouTube's Top ranking holds back as potential spam. - Videos with comments turned off and private videos return private_or_unavailable, and deleted videos not_found. - Replies are not included. metrics.reply_count says how many a comment has. ## 1 credit per page. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/youtube/comments/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the YouTube Comments API. More in the [API reference](https://socialtap.dev/docs/reference/youtube/comments/index.md). **How much does the YouTube Comments API cost?** A page of up to 20 comments costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 1 hour. Other platforms ## Comments on 8 more platforms. - [TikTok Comments API](https://socialtap.dev/apis/tiktok/comments/index.md) (1 credit / page · `GET /v1/tiktok/comments`) - [Instagram Comments API](https://socialtap.dev/apis/instagram/comments/index.md) (1 credit / page · `GET /v1/instagram/comments`) - [Facebook Comments API](https://socialtap.dev/apis/facebook/comments/index.md) (1 credit / page · `GET /v1/facebook/comments`) - [Reddit Comments API](https://socialtap.dev/apis/reddit/comments/index.md) (1 credit / page · `GET /v1/reddit/comments`) - [Threads Comments API](https://socialtap.dev/apis/threads/comments/index.md) (1 credit / page · `GET /v1/threads/comments`) - [Rumble Comments API](https://socialtap.dev/apis/rumble/comments/index.md) (1 credit / page · `GET /v1/rumble/comments`) - [Bluesky Comments API](https://socialtap.dev/apis/bluesky/comments/index.md) (1 credit / page · `GET /v1/bluesky/comments`) - [Snapchat Comments API](https://socialtap.dev/apis/snapchat/comments/index.md) (1 credit / page · `GET /v1/snapchat/comments`) More YouTube ## YouTube API. 6 endpoints, one key. - [YouTube Video API](https://socialtap.dev/apis/youtube/post/index.md) (1 credit · `GET /v1/youtube/post`) - [YouTube Channel Videos API](https://socialtap.dev/apis/youtube/posts/index.md) (1 credit / page · `GET /v1/youtube/posts`) - [YouTube Channel API](https://socialtap.dev/apis/youtube/profile/index.md) (1 credit · `GET /v1/youtube/profile`) - [YouTube Transcript API](https://socialtap.dev/apis/youtube/transcript/index.md) (From 1 credit · `GET /v1/youtube/transcript`) - [YouTube Engagement API](https://socialtap.dev/apis/youtube/engagement/index.md) (1 credit · `GET /v1/youtube/engagement`) ## Try it on a link you already have. Paste it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/youtube/comments/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)