Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$0.7 / 1k comments Extract YouTube comments — text, likes, timestamps, and reply threads — from video URLs, specifying max comments

​
Endpoint

POST /api/v1/agents/youtube/comments/run

​
Parameters

​
urls
array
required
List · YouTube video URLs to scrape comments from. One per line.
​
maxComments
integer
default:50
Number · Max comments per video. Use 0 for all.
​
sortBy
string
default:"0"
Dropdown · Sort order for comments.Options: 0, 1Legend: 0 = Top comments, 1 = Newest first

​
Response columns

FieldDisplay nameType
videoUrlVideo URLurl
videoTitleVideo Titletext
commentTextComment Texttext
authorAuthortext
likesLikesnumber
replyCountReply Countnumber
totalCommentsTotal Commentsnumber
channelOwnerChannel Ownerboolean
heartedByCreatorHearted by Creatorboolean
typeTypetext

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/youtube/comments/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": [
      {
        "url": "https://www.youtube.com/watch?v=erLbbextvlY"
      }
    ],
    "maxComments": 10
  }
}'

​
Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "videoUrl": "https://www.youtube.com/watch?v=erLbbextvlY",
      "videoTitle": "7 Days Stranded On An Island",
      "commentText": "I tried to really slow this video down, let me know if you liked it :)",
      "author": "@MrBeast",
      "likes": 266000,
      "replyCount": 725,
      "totalComments": 151541,
      "channelOwner": true,
      "heartedByCreator": false,
      "type": "comment"
    }
  ]
}