API referenceYouTube
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.
Authorization
ApiKeyAuth X-API-Key<token>
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 }}