YouTube Channel Videos

1 credit

List videos from a YouTube channel.

POST/api/v1/tools/youtube/channel-videos

Parameters

channelIdstringrequired

YouTube channel ID.

sortstring

Sort order. One of "recent" or "popular". Defaults to "recent".

maxResultsnumber

Maximum number of videos to return. Defaults to 30.

fieldsstring[]

Fields to include per video. Omit for defaults: videoId, title, viewCount, duration, publishedTime. Use ["*"] for all fields. Available fields: videoId, title, viewCount, duration, publishedTime, thumbnailUrl. The channel wrapper is always returned.

Response Schema

dataobject

YouTube channel videos result

channelobject

Channel identity

videosobject[]

Array of video objects from the channel.

countnumber

Number of videos returned

truncatedboolean

True if results were cut short. Only present when truncation occurred.

metaobject

Request metadata

toolstring

Tool name (youtube-channel-videos)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/youtube/channel-videos \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "sort": "popular",
    "maxResults": 10
  }'

Response Example

{
  "data": {
    "channel": {
      "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
      "name": "Rick Astley"
    },
    "videos": [
      {
        "videoId": "dQw4w9WgXcQ",
        "title": "Rick Astley - Never Gonna Give You Up",
        "viewCount": "1.5B views",
        "duration": "3:33",
        "publishedTime": "15 years ago"
      }
    ],
    "count": 1
  },
  "meta": {
    "tool": "youtube-channel-videos",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}