Skip to main content

​
YouTube Channel Scraper

Scrape full YouTube channel data including video lists, subscriber counts, and metadata. 1 credit/row

​
Parameters

ParameterTypeRequiredDescription
startUrlsarrayYesArray of URL objects pointing to YouTube channels. E.g., [{"url": "https://www.youtube.com/@mkbhd"}]
maxResultsintegerYesMaximum number of videos to return. Default: 0 (all)
sortVideosBystringNoSort order for videos: NEWEST, POPULAR, or OLDEST
maxResultsShortsintegerYesMaximum number of Shorts to return. Default: 0
maxResultStreamsintegerYesMaximum number of live streams to return. Default: 0

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/youtube/channel-scraper/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "startUrls": [{"url": "https://www.youtube.com/@mkbhd"}],
      "maxResults": 50,
      "sortVideosBy": "NEWEST",
      "maxResultsShorts": 0,
      "maxResultStreams": 0
    }
  }'

​
YouTube Comment Scraper

Extract comments from YouTube videos including replies, likes, and commenter info. 1 credit/row

​
Parameters

ParameterTypeRequiredDescription
startUrlsarrayYesArray of URL objects pointing to YouTube videos. E.g., [{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}]
maxCommentsintegerYesMaximum number of comments to return
commentsSortBystringNoSort order: 0 for Top comments, 1 for Newest

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/youtube/comment-scraper/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "startUrls": [{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}],
      "maxComments": 100,
      "commentsSortBy": "0"
    }
  }'

​
YouTube Video Scraper

Search and scrape YouTube videos by keywords or URLs with full metadata, stats, and captions. 1 credit/row

​
Parameters

ParameterTypeRequiredDescription
searchQueriesarrayNoArray of search keywords. E.g., ["machine learning tutorial"]
startUrlsarrayNoArray of YouTube URLs (video, playlist, or channel)
maxResultsintegerYesMaximum number of videos to return. Default: 50
maxResultsShortsintegerYesMaximum number of Shorts to return. Default: 0
maxResultStreamsintegerYesMaximum number of live streams to return. Default: 0

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/youtube/video-scraper/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "searchQueries": ["machine learning tutorial"],
      "maxResults": 50,
      "maxResultsShorts": 0,
      "maxResultStreams": 0
    }
  }'

​
YouTube Shorts Scraper

Scrape YouTube Shorts from specific channels with sorting options. 1 credit/row

​
Parameters

ParameterTypeRequiredDescription
channelsarrayYesArray of YouTube channel URLs or handles. E.g., ["https://www.youtube.com/@mkbhd"]
maxResultsShortsintegerYesMaximum number of Shorts to return. Default: 50
sortChannelShortsBystringNoSort order: POPULAR, NEWEST, or OLDEST

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/youtube/shorts-scraper/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "channels": ["https://www.youtube.com/@mkbhd"],
      "maxResultsShorts": 50,
      "sortChannelShortsBy": "POPULAR"
    }
  }'