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.4 / 1k videos Extract YouTube channel data from URLs, with video lists, subscriber counts, and channel metadata

​
Endpoint

POST /api/v1/agents/youtube/channels/run

​
Parameters

​
urls
array
required
List · YouTube channel URLs. One per line.
​
maxVideos
integer
default:50
Number · Videos per channel. Use 0 for all.
​
sortVideosBy
string
default:"NEWEST"
Dropdown · Sort order for videos.Options: NEWEST, POPULAR, OLDESTLegend: NEWEST = Newest First, POPULAR = Most Popular, OLDEST = Oldest First
​
maxShorts
integer
Number · Shorts per channel. Use 0 for all, leave blank to skip.
​
maxStreams
integer
Number · Live streams per channel. Use 0 for all, leave blank to skip.

​
Response columns

FieldDisplay nameType
channelUrlChannel URLurl
videoUrlVideo URLurl
videoTitleVideo Titletext
postedPostedtext
durationDurationtext
viewsViewsnumber
channelChanneltext
channelHandleChannel Handletext
channelDescriptionChannel Descriptiontext
channelLinkTextChannel Link Texttext
channelLinkUrlChannel Link URLurl
channelLocationChannel Locationtext
channelJoinedChannel Joinedtext
channelTotalVideosChannel Total Videosnumber
channelTotalViewsChannel Total Viewsnumber
subscribersSubscribersnumber
ageRestrictedAge Restrictedboolean
channelVerifiedChannel Verifiedboolean
typeTypetext
channelListPageChannel List Pagetext
orderOrdernumber
channelAvatarChannel Avatarurl
channelBannerChannel Bannerurl
thumbnailThumbnailurl

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/youtube/channels/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": [
      {
        "url": "https://www.youtube.com/@MrBeast"
      }
    ],
    "maxVideos": 10,
    "maxShorts": 0,
    "maxStreams": 0
  }
}'

​
Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "channelUrl": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
      "videoUrl": "https://www.youtube.com/watch?v=zRtGL0-5rg4",
      "videoTitle": "Last To Leave Grocery Store, Wins $250,000",
      "posted": "13 days ago",
      "duration": "42:57",
      "views": 115000000,
      "channel": "MrBeast",
      "channelHandle": "MrBeast",
      "channelDescription": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000,000 Trees\n- Removed 30,000,000 pounds of trash from the ocean\n- Helped 2,000 people walk again\n- Helped 1,000 blind people see\n- Helped 1,000 deaf people hear\n- Built wells in Africa\n- Built and gave away 100 houses\n- Adopted every dog in a shelter (twice)\n- Given millions to charity\n- Started my own snack company Feastables\n- Started my own software company Viewstats\n- Started Lunchly, a tasty, better-for-you lunch option\n- Gave away a private island (twice)\n- Gave away 1 million meals\n- I counted to 100k\n- Ran a marathon in the world's largest shoes\n- Survived 50 hours in Antarctica\n- Recreated Squid Game in real life\n- Created the largest competition show with 1000 people (Beast Games)\n- Gave $5,000,000 to one person\n- Passed T-Series to become most subscribed YouTube channel \ud83e\udd79\nyou get it, I appreciate all of you so much :)",
      "channelLinkText": null,
      "channelLinkUrl": null,
      "channelLocation": "United States",
      "channelJoined": "Feb 19, 2012",
      "channelTotalVideos": 972,
      "channelTotalViews": 119792170605,
      "subscribers": 480000000,
      "ageRestricted": false,
      "channelVerified": true,
      "type": "video",
      "channelListPage": "videos",
      "order": 0,
      "channelAvatar": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s68-c-k-c0x00ffffff-no-rj",
      "channelBanner": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
      "thumbnail": "https://i.ytimg.com/vi/zRtGL0-5rg4/hqdefault.jpg?sqp=-oaymwEmCKgBEF5IWvKriqkDGQgBFQAAiEIYAdgBAeIBCggYEAIYBjgBQAE=&rs=AOn4CLC27MWa9QRwlLhSSh4KlNGUMPuwrQ"
    }
  ]
}