Comments list

Read-only YouTube Data API v3 comments list endpoint.

1 credit per successful call Errors are never charged

Request

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

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 or snippet. For example: snippet
`parentId` optional	string	Return replies to this top-level comment (provide parentId or id). For example: Ugz1FgGzzSJdPWcyxlN4AaABAg
`id` optional	string	Comma-separated comment IDs (provide parentId or id).
`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": "HaJ0yTc_OZVQqvqP3mHYcFcbhr4",
    "kind": "youtube#commentListResponse",
    "items": [
        {
            "id": "Ugz1FgGzzSJdPWcyxlN4AaABAg.Abv3rAUwedvAbv6mmhAUQv",
            "etag": "HX_ljYb2sJeDemtOb2BridUR4Cc",
            "kind": "youtube#comment",
            "snippet": {
                "canRate": true,
                "parentId": "Ugz1FgGzzSJdPWcyxlN4AaABAg",
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "likeCount": 1,
                "updatedAt": "2026-10-13T19:55:20Z",
                "publishedAt": "2026-10-13T19:55:20Z",
                "textDisplay": "What&#39;s wrong with the arches?",
                "textOriginal": "What's wrong with the arches?",
                "viewerRating": "none",
                "authorChannelId": {
                    "value": "UCo1Hcdpf-8Xz4yOsu9I4-Qw"
                },
                "authorChannelUrl": "http://www.youtube.com/@T1kr3b3u",
                "authorDisplayName": "@T1kr3b3u",
                "authorProfileImageUrl": "https://yt3.ggpht.com/ytc/AIdro_k-toqSUZ4mwK0XRh995cX_1gd2OVRv0efCoNAvJVGOYzMO=s48-c-k-c0x00ffffff-no-rj"
            }
        },
        {
            "id": "Ugz1FgGzzSJdPWcyxlN4AaABAg.Abv3rAUwedvAbvA4mAqf94",
            "etag": "6GGPW2FA11mqmEmsNEGrrYlAOhY",
            "kind": "youtube#comment",
            "snippet": {
                "canRate": true,
                "parentId": "Ugz1FgGzzSJdPWcyxlN4AaABAg",
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "likeCount": 13,
                "updatedAt": "2026-10-13T20:24:09Z",
                "publishedAt": "2026-10-13T20:24:09Z",
                "textDisplay": "@T1kr3b3uthey curve in on the sides and then go flat while they&#39;re completely curved in the reference image.",
                "textOriginal": "@T1kr3b3uthey curve in on the sides and then go flat while they're completely curved in the reference image.",
                "viewerRating": "none",
                "authorChannelId": {
                    "value": "UCbvx9WmajFhvx7yt0eF3sJw"
                },
                "authorChannelUrl": "http://www.youtube.com/@mrcraggle",
                "authorDisplayName": "@mrcraggle",
                "authorProfileImageUrl": "https://yt3.ggpht.com/ytc/AIdro_ljQp8LEfLsY28Tr585sJl1mRM6P_wC7hi6vdUnNs_8Ag=s48-c-k-c0x00ffffff-no-rj"
            }
        },
        {
            "id": "Ugz1FgGzzSJdPWcyxlN4AaABAg.Abv3rAUwedvAbvWszGgKRQ",
            "etag": "y-weyAs_mjUrqqvfobJXXhEaRS8",
            "kind": "youtube#comment",
            "snippet": {
                "canRate": true,
                "parentId": "Ugz1FgGzzSJdPWcyxlN4AaABAg",
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "likeCount": 7,
                "updatedAt": "2026-10-13T23:43:22Z",
                "publishedAt": "2026-10-13T23:43:22Z",
                "textDisplay": "Fixable, the time saved is beyond still mind breaking",
                "textOriginal": "Fixable, the time saved is beyond still mind breaking",
                "viewerRating": "none",
                "authorChannelId": {
                    "value": "UCdS8XCfXqwTc6ypCyzgF7kw"
                },
                "authorChannelUrl": "http://www.youtube.com/@v1nigra3",
                "authorDisplayName": "@v1nigra3",
                "authorProfileImageUrl": "https://yt3.ggpht.com/bPraHhHpEhOt-I_K2lU78LhGjULXFiWJiN_PghaP9bp0Z7Y3N2q00EglmLmJTI34CJixHPaKT5s=s48-c-k-c0x00ffffff-no-rj"
            }
        },
        {
            "id": "Ugz1FgGzzSJdPWcyxlN4AaABAg.Abv3rAUwedvAbvuEHrp_kI",
            "etag": "mlwp58gef0FM0Pv1_6DEbR9EtAg",
            "kind": "youtube#comment",
            "snippet": {
                "canRate": true,
                "parentId": "Ugz1FgGzzSJdPWcyxlN4AaABAg",
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "likeCount": 0,
                "updatedAt": "2026-10-14T03:16:08Z",
                "publishedAt": "2026-10-14T03:16:08Z",
                "textDisplay": "Maybe the guy eanted thr arches like that and specifically asked for it. Artistic freedom exists y&#39;know..",
                "textOriginal": "Maybe the guy eanted thr arches like that and specifically asked for it. Artistic freedom exists y'know..",
                "viewerRating": "none",
                "authorChannelId": {
                    "value": "UCgqVYLxq9B6l4Eu744fitiw"
                },
                "authorChannelUrl": "http://www.youtube.com/@TheoVuts",
                "authorDisplayName": "@TheoVuts",
                "authorProfileImageUrl": "https://yt3.ggpht.com/ztEOimpdq9wyHxkMJFdDliSMrDLy96Fv3eNHSFTXe8dYWxAxJE7E_GI0i0DDu0NKVVeptP0LAQ=s48-c-k-c0x00ffffff-no-rj"
            }
        },
        {
            "id": "Ugz1FgGzzSJdPWcyxlN4AaABAg.Abv3rAUwedvAbx5UO3qp61",
            "etag": "HR1SIglBOWCaFWnTJQUH9e6sKfI",
            "kind": "youtube#comment",
            "snippet": {
                "canRate": true,
                "parentId": "Ugz1FgGzzSJdPWcyxlN4AaABAg",
                "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
                "likeCount": 0,
                "updatedAt": "2026-10-14T14:22:26Z",
                "publishedAt": "2026-10-14T14:22:26Z",
                "textDisplay": "missing the forest for the trees.",
                "textOriginal": "missing the forest for the trees.",
                "viewerRating": "none",
                "authorChannelId": {
                    "value": "UCmD6NM9F9VJg5WCuYcZatow"
                },
                "authorChannelUrl": "http://www.youtube.com/@Ezpz-g9r",
                "authorDisplayName": "@Ezpz-g9r",
                "authorProfileImageUrl": "https://yt3.ggpht.com/ytc/AIdro_m8YjQde9irdShQ9kSQM_V3xWWL9Wzg3hF_XzsQm9zoQywcF89zsd54JM7SsFln2dONDVc=s48-c-k-c0x00ffffff-no-rj"
            }
        }
    ],
    "pageInfo": {
        "resultsPerPage": 5
    },
    "nextPageToken": "Z2V0X2NvbW1lbnRfd2l0aF9yZXBsaWVzX3N0cmVhbS0tQ2dnSWdBUVZGN2ZST0JJRkNLQWdHQUVpRGdvTUNLR2d2dFlHRU1DcTRQVUNVQUJZQVE="
}

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: Comments list GET

part

parentId

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 Comment threads list Read-only YouTube Data API v3 commentThreads list endpoint. /api/v1/youtube/commentThreads 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