POST/v1/data/youtube/comments

YouTube Comments

Get comments for a YouTube video including author info, verification status, likes, reply count, pinned status, and creator heart status.

Target Latency

1.2s - 4.5s

Credits

2 cr/req

Parameters

NameTypeRequirementDescription
video_idstringREQUIREDYouTube video ID. 1-20 characters.
limitnumberoptionalMaximum comments to return (1-100).

cURL Example

curl -X POST "https://api.datablue.dev/v1/data/youtube/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "video_id": "dQw4w9WgXcQ",
  "limit": 5
}'

System Responses

200 OK

Request processed successfully.

401 UNAUTHORIZED

Missing or invalid API key.

429 RATE LIMIT

System capacity exceeded.

500 SYSTEM FAILURE

Internal core exception.

EXAMPLE RESPONSE
{
  "success": true,
  "time_taken": 2.56,
  "video_id": "dQw4w9WgXcQ",
  "count": 5,
  "comments": [
    {
      "author": "Rick Astley",
      "author_channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
      "author_avatar": "https://yt3.ggpht.com/ytc/AIdro_n...",
      "is_verified": true,
      "is_creator": true,
      "text": "Thank you for 1.5 billion views! Never gonna let you down.",
      "likes": 892000,
      "reply_count": 47200,
      "published": "3 months ago",
      "pinned": true,
      "hearted": false
    },
    {
      "author": "Internet Historian",
      "author_channel_id": "UCR1D15p_vY6mVRqY5eXSA",
      "author_avatar": "https://yt3.ggpht.com/ytc/another...",
      "is_verified": true,
      "is_creator": false,
      "text": "We've been rickrolling for almost 20 years and it still never gets old.",
      "likes": 234000,
      "reply_count": 1200,
      "published": "6 months ago",
      "pinned": false,
      "hearted": true
    }
  ]
}