YouTube comments
Comments on a YouTube video, paged with a cursor.
Top-level comments on a video or Short, with author, text, timestamp and like count.
Where a video has comments turned off, that is reported as such rather than returned as an empty list.
Shorts and long-form video are returned from the same channel endpoint and are labelled by content type rather than by duration.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 2.9s.
Authorization
ApiKeyAuth Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/youtube-comments-v3" \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "comments": [ { "author_id": "UCBR8-60-B28hp2BmDPdntcQ", "author_name": "@YouTube", "author_profile_image": "https://yt3.ggpht.com/3s6evpqAiDU9tQR4sC2siJippbH2RWVPnwHgyl4V0th2iuQz0VDQZbUhQBGmsxLYo-mjG6TqZQ=s88-c-k-c0x00ffffff-no-rj", "author_username": "@YouTube", "author_verification_status": true, "comment_id": "Ugzge340dBgB75hWBm54AaABAg", "comment_text": "can confirm: he never gave us up", "is_artist": false, "is_creator": false, "like_count": 305000, "mentions": [], "pinned_status": null, "published_date": 1755950559, "published_time_text": "1 year ago", "replies": [], "reply_count": 963 }, { "author_id": "UCe8dr6l5fgxVh6peaTtx8XA", "author_name": "@MariahRhona", "author_profile_image": "https://yt3.ggpht.com/sEIirS_KS8tpBOKKPUIrE887msAjyf3N4gggHploxxmmwt3B2MkNRBB_t90olc0hXeghSsLj3A=s88-c-k-c0x00ffffff-no-rj", "author_username": "@MariahRhona", "author_verification_status": false, "comment_id": "UgxTsG2dsspEiq6MAZJ4AaABAg", "comment_text": "who came here saying this video was taken down", "is_artist": false, "is_creator": false, "like_count": 44000, "mentions": [], "pinned_status": null, "published_date": 1785672159, "published_time_text": "3 weeks ago", "replies": [], "reply_count": 983 }, "… 18 more items in the full response" ], "pagination": { "cursor": "Eg0SC2RRdzR3OVdnWGNRGAYygQMK1wJnZXRfcmFua2VkX3N0cmVhbXMtLUNxWUJDSUFFRlJlMzBUZ2Ftd0VLbGdFSTJGOFFnQVFZQnlLTEFmdHREY0FraWVnOTQtUHlPY1VCNFR5WkxpZEFqVUdFSmhJWmxISzRCckZjWWFha1NpYU5NMFNaSEtJdjJjREhZLU5JV0hZVGozUTMya3V2NElVSHZ1Tk9SRC15S2ZHcEl3cDR5aEplanJQUzF0WndTWmJpc3ZSWnR3bnJNSmYtS2Nwa2p6QVFzMVVOSVlmQk1xcVdOOUh5NFl1anJ5SE1N… (+220 chars)", "has_more": true }, "total": 2455020 }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "youtube-comments-v3", "billable": true, "duration_ms": 2396 }}