API reference / YouTube / Comment threads list

Comment threads list

Read-only YouTube Data API v3 commentThreads list endpoint.

1 credit per successful call Errors are never charged

Request

GET https://socialgraph.dev/api/v1/youtube/commentThreads

Send your API key as Authorization: Bearer YOUR_API_KEY. Parameters go in the query string.

Parameters

Name	Type	Description
`part` required	string	Required. Comma-separated: id, snippet or replies. For example: snippet
`videoId` optional	string	Comment threads on this video (provide videoId, allThreadsRelatedToChannelId or id). For example: OYp5j2RihPE
`allThreadsRelatedToChannelId` optional	string	Comment threads on all of this channel's videos. For example: UC_x5XG1OV2P6uZZ5FSM9Ttw
`id` optional	string	Comma-separated comment thread IDs.
`searchTerms` optional	string	Only return comments containing these words.
`order` optional	string	time (default) or relevance.
`textFormat` optional	string	html (default) or plainText.
`maxResults` optional	integer	Maximum results per page (1–100). Default 20.
`pageToken` optional	string	Token from a previous response (nextPageToken or prevPageToken).

Code examples

Example response

{
    "etag": "U9id4pbPgL_Ovp0tQMV4fgA12Oo",
    "kind": "youtube#commentThreadListResponse",
    "items": [
        {
            "id": "Ugzy4vvp5q3o0v0ur0l4AaABAg",
            "etag": "sqcmo2w8z-exQG1qUnlY7fLp2AE",
            "kind": "youtube#commentThread",
            "snippet": {
                "videoId": "OYp5j2RihPE",
                "canReply": true,
                "isPublic": true,
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "topLevelComment": {
                    "id": "Ugzy4vvp5q3o0v0ur0l4AaABAg",
                    "etag": "vjKxv1XHlmRifs_uwlEQDPRlDo4",
                    "kind": "youtube#comment",
                    "snippet": {
                        "canRate": true,
                        "videoId": "OYp5j2RihPE",
                        "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                        "likeCount": 0,
                        "updatedAt": "2026-10-14T15:36:44Z",
                        "publishedAt": "2026-10-14T15:36:44Z",
                        "textDisplay": "AI slop. Human art will always be better!",
                        "textOriginal": "AI slop. Human art will always be better!",
                        "viewerRating": "none",
                        "authorChannelId": {
                            "value": "UCvwa4WUjfaxlQNmp8xIQpOw"
                        },
                        "authorChannelUrl": "http://www.youtube.com/@spicytea6821",
                        "authorDisplayName": "@spicytea6821",
                        "authorProfileImageUrl": "https://yt3.ggpht.com/YrFGOIyMquGHiFMihKmxABl2SJW74pD-kEZ0oK1T1YTEWfzIKDFvtYpuPuDXzS_Ohie0T-S7aVc=s48-c-k-c0x00ffffff-no-rj"
                    }
                },
                "totalReplyCount": 0
            }
        },
        {
            "id": "UgzlDHUFcf07olGvxIx4AaABAg",
            "etag": "wwaHD4l3zPCeFvTBK4ve3rbvv2M",
            "kind": "youtube#commentThread",
            "snippet": {
                "videoId": "OYp5j2RihPE",
                "canReply": true,
                "isPublic": true,
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "topLevelComment": {
                    "id": "UgzlDHUFcf07olGvxIx4AaABAg",
                    "etag": "MBo-9CmUES0Q7k9u2sfkpbo6Gq0",
                    "kind": "youtube#comment",
                    "snippet": {
                        "canRate": true,
                        "videoId": "OYp5j2RihPE",
                        "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                        "likeCount": 0,
                        "updatedAt": "2026-10-14T14:30:04Z",
                        "publishedAt": "2026-10-14T14:30:04Z",
                        "textDisplay": "You are gonna find that a lot of pro subscriptions are gonna be canceled soon. Because you&#39;re not giving access to this model in your different applications. This is ridiculous.",
                        "textOriginal": "You are gonna find that a lot of pro subscriptions are gonna be canceled soon. Because you're not giving access to this model in your different applications. This is ridiculous.",
                        "viewerRating": "none",
                        "authorChannelId": {
                            "value": "UCWWCp_DpzO2x2Tl9n0TVKUg"
                        },
                        "authorChannelUrl": "http://www.youtube.com/@penguinlover1986",
                        "authorDisplayName": "@penguinlover1986",
                        "authorProfileImageUrl": "https://yt3.ggpht.com/ytc/AIdro_mz6iW4i56E89dWdlweGnM9Y7WR5XJUAZwFgh_Ljed8oNU=s48-c-k-c0x00ffffff-no-rj"
                    }
                },
                "totalReplyCount": 0
            }
        },
        {
            "id": "Ugxp2BNMtPV5GWv954l4AaABAg",
            "etag": "Kafx-nmo_TduuC0ruSQYGTv_5P4",
            "kind": "youtube#commentThread",
            "snippet": {
                "videoId": "OYp5j2RihPE",
                "canReply": true,
                "isPublic": true,
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "topLevelComment": {
                    "id": "Ugxp2BNMtPV5GWv954l4AaABAg",
                    "etag": "8Eul0e3ikj549duAGJtIHptt9E0",
                    "kind": "youtube#comment",
                    "snippet": {
                        "canRate": true,
                        "videoId": "OYp5j2RihPE",
                        "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                        "likeCount": 0,
                        "updatedAt": "2026-10-14T13:29:25Z",
                        "publishedAt": "2026-10-14T13:29:25Z",
                        "textDisplay": "<a href=\"https://www.youtube.com/watch?v=OYp5j2RihPE&amp;t=57\">0:57</a>",
                        "textOriginal": "0:57",
                        "viewerRating": "none",
                        "authorChannelId": {
                            "value": "UCC3yq58uUpLmZRL-aTxC_zw"
                        },
                        "authorChannelUrl": "http://www.youtube.com/@duniapenuhceritanusantara79",
                        "authorDisplayName": "@duniapenuhceritanusantara79",
                        "authorProfileImageUrl": "https://yt3.ggpht.com/YaoCdEAiUm6EC_I6Xl6nE7CEK3sPu0EvVmxMFm9NnJRGbl-NF1jbf5VCwEEC4YtEy8XZKfw4gw=s48-c-k-c0x00ffffff-no-rj"
                    }
                },
                "totalReplyCount": 0
            }
        },
        {
            "id": "UgxBFzg2WQlwImy1m794AaABAg",
            "etag": "G_EgBPbrDbAI1_loK6UHGAHjXLk",
            "kind": "youtube#commentThread",
            "snippet": {
                "videoId": "OYp5j2RihPE",
                "canReply": true,
                "isPublic": true,
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "topLevelComment": {
                    "id": "UgxBFzg2WQlwImy1m794AaABAg",
                    "etag": "yH3glnn8XWBrRFtT39CHOdWvMFI",
                    "kind": "youtube#comment",
                    "snippet": {
                        "canRate": true,
                        "videoId": "OYp5j2RihPE",
                        "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                        "likeCount": 0,
                        "updatedAt": "2026-10-14T13:28:46Z",
                        "publishedAt": "2026-10-14T13:28:46Z",
                        "textDisplay": "Wooow 🎉❤",
                        "textOriginal": "Wooow 🎉❤",
                        "viewerRating": "none",
                        "authorChannelId": {
                            "value": "UCC3yq58uUpLmZRL-aTxC_zw"
                        },
                        "authorChannelUrl": "http://www.youtube.com/@duniapenuhceritanusantara79",
                        "authorDisplayName": "@duniapenuhceritanusantara79",
                        "authorProfileImageUrl": "https://yt3.ggpht.com/YaoCdEAiUm6EC_I6Xl6nE7CEK3sPu0EvVmxMFm9NnJRGbl-NF1jbf5VCwEEC4YtEy8XZKfw4gw=s48-c-k-c0x00ffffff-no-rj"
                    }
                },
                "totalReplyCount": 0
            }
        },
        {
            "id": "UgzgVaoSWUCP06toBkh4AaABAg",
            "etag": "7YF1PfKSzFdKfRrLvLZNUFmPE_Y",
            "kind": "youtube#commentThread",
            "snippet": {
                "videoId": "OYp5j2RihPE",
                "canReply": true,
                "isPublic": true,
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "topLevelComment": {
                    "id": "UgzgVaoSWUCP06toBkh4AaABAg",
                    "etag": "YVSLUqBh8hORu70UNt5Db7SGbm0",
                    "kind": "youtube#comment",
                    "snippet": {
                        "canRate": true,
                        "videoId": "OYp5j2RihPE",
                        "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                        "likeCount": 0,
                        "updatedAt": "2026-10-14T09:05:13Z",
                        "publishedAt": "2026-10-14T09:05:13Z",
                        "textDisplay": "45 agentic loops hide the real issue: this workflow is expensive, slow, and painful to art-direct reliably",
                        "textOriginal": "45 agentic loops hide the real issue: this workflow is expensive, slow, and painful to art-direct reliably",
                        "viewerRating": "none",
                        "authorChannelId": {
                            "value": "UChiu_7NF9Dmi9In5NbgOimw"
                        },
                        "authorChannelUrl": "http://www.youtube.com/@sebuzdugan",
                        "authorDisplayName": "@sebuzdugan",
                        "authorProfileImageUrl": "https://yt3.ggpht.com/hyQVx6V-wOFrY2ChzH75tDp7XRuOrOn8G0Xf8s1GewYibzq4VzoYCaMkx5u9g7RaHEyX3S7lmA=s48-c-k-c0x00ffffff-no-rj"
                    }
                },
                "totalReplyCount": 0
            }
        }
    ],
    "pageInfo": {
        "totalResults": 5,
        "resultsPerPage": 5
    },
    "nextPageToken": "Z2V0X25ld2VzdF9maXJzdC0tQ2dnSWdBUVZGN2ZST0JJRkNJZ2dHQUFTQlFpZElCZ0JFZ1VJaHlBWUFCSUZDSWtnR0FBU0JRaW9JQmdBRWdVSW5pQVlBQklGQ01nZ0dBQWlEZ29NQ01tTHZkWUdFUEM0NnA0QlVBQllBUQ=="
}

Errors

Status	Meaning	Charged?
401	Missing, invalid or revoked API key	No
402	Not enough credits (`insufficient_credits`)	No
404	The account or post doesn't exist	No
422	Missing or invalid parameters	No
502 / 503	The data source is temporarily unavailable	No

All error codes →

Try it live: Comment threads list GET

part

videoId

maxResults

🔒 Preset demo input. Live demos use the Google for Developers channel, youtube.com/@GoogleDevelopers. Sign up free to use your own.

More YouTube endpoints

GET Activities list Read-only YouTube Data API v3 activities list endpoint. /api/v1/youtube/activities 1 credit / call GET Channel sections list Read-only YouTube Data API v3 channelSections list endpoint. /api/v1/youtube/channelSections 1 credit / call GET Channels list Read-only YouTube Data API v3 channels list endpoint. /api/v1/youtube/channels 1 credit / call GET Comments list Read-only YouTube Data API v3 comments list endpoint. /api/v1/youtube/comments 1 credit / call GET Internationalization languages list Read-only YouTube Data API v3 i18nLanguages list endpoint. /api/v1/youtube/i18nLanguages 1 credit / call GET Internationalization regions list Read-only YouTube Data API v3 i18nRegions list endpoint. /api/v1/youtube/i18nRegions 1 credit / call