YouTube Channel Video Feed Quick Scraper

Quickly list any YouTube channel's videos, sorted newest, most popular or oldest, with channel subscriber count, verification and optional Shorts, playlists and live-stream tabs.

Open on Apify GitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

Field	Type	Required	Description
`channelUrls`	array	required	YouTube channel URLs, handles (@username), or channel IDs (UCxxx). Accepts any format.
`maxVideos`	integer	optional	Maximum number of videos to scrape per channel. Set to 0 to get only channel info without videos.
`sortVideosBy`	string	optional	How to sort the channel's video listings.

Show all input fields

Field	Type	Required	Description
`channelUrls`	array	required	YouTube channel URLs, handles (@username), or channel IDs (UCxxx). Accepts any format.
`maxVideos`	integer	optional	Maximum number of videos to scrape per channel. Set to 0 to get only channel info without videos.
`sortVideosBy`	string	optional	How to sort the channel's video listings.
`includeAbout`	boolean	optional	Extract total views, join date, location, and external links from the channel About page.
`includePlaylists`	boolean	optional	Scrape the channel Playlists tab and include playlist metadata in the output.
`maxPlaylists`	integer	optional	Maximum number of playlists to scrape (when includePlaylists is enabled).
`includeShorts`	boolean	optional	Scrape the channel Shorts tab and include Shorts in the output.
`maxShorts`	integer	optional	Maximum number of Shorts to return (when includeShorts is enabled).
`includeLiveVideos`	boolean	optional	Scrape the channel Live/Streams tab and include live/archived streams.
`maxLiveVideos`	integer	optional	Maximum live/stream videos to return.
`market`	string	optional	Country code for localized content (affects gl/hl URL parameters).

Download the published input schema

View complete JSON

{
  "properties": {
    "channelUrls": {
      "description": "YouTube channel URLs, handles (@username), or channel IDs (UCxxx). Accepts any format.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "prefill": [
        "https://www.youtube.com/@Apify"
      ],
      "title": "Channel URLs",
      "type": "array"
    },
    "includeAbout": {
      "default": true,
      "description": "Extract total views, join date, location, and external links from the channel About page.",
      "prefill": true,
      "title": "Include About Page Data",
      "type": "boolean"
    },
    "includeLiveVideos": {
      "default": false,
      "description": "Scrape the channel Live/Streams tab and include live/archived streams.",
      "prefill": false,
      "title": "Include Live/Stream Videos",
      "type": "boolean"
    },
    "includePlaylists": {
      "default": false,
      "description": "Scrape the channel Playlists tab and include playlist metadata in the output.",
      "prefill": false,
      "title": "Include Channel Playlists",
      "type": "boolean"
    },
    "includeShorts": {
      "default": false,
      "description": "Scrape the channel Shorts tab and include Shorts in the output.",
      "prefill": false,
      "title": "Include Channel Shorts",
      "type": "boolean"
    },
    "market": {
      "default": "US",
      "description": "Country code for localized content (affects gl/hl URL parameters).",
      "editor": "select",
      "enum": [
        "US",
        "GB",
        "CA",
        "AU",
        "DE",
        "FR",
        "JP",
        "KR",
        "BR",
        "IN",
        "MX",
        "IT",
        "ES",
        "NL",
        "PL",
        "RU",
        "SE",
        "NO",
        "DK",
        "FI",
        "ZA",
        "SG",
        "HK",
        "TW",
        "ID",
        "MY",
        "TH",
        "PH",
        "AR",
        "CO",
        "CL"
      ],
      "enumTitles": [
        "United States",
        "United Kingdom",
        "Canada",
        "Australia",
        "Germany",
        "France",
        "Japan",
        "South Korea",
        "Brazil",
        "India",
        "Mexico",
        "Italy",
        "Spain",
        "Netherlands",
        "Poland",
        "Russia",
        "Sweden",
        "Norway",
        "Denmark",
        "Finland",
        "South Africa",
        "Singapore",
        "Hong Kong",
        "Taiwan",
        "Indonesia",
        "Malaysia",
        "Thailand",
        "Philippines",
        "Argentina",
        "Colombia",
        "Chile"
      ],
      "title": "Market / Region",
      "type": "string"
    },
    "maxLiveVideos": {
      "default": 20,
      "description": "Maximum live/stream videos to return.",
      "maximum": 500,
      "minimum": 1,
      "title": "Max Live Videos",
      "type": "integer"
    },
    "maxPlaylists": {
      "default": 20,
      "description": "Maximum number of playlists to scrape (when includePlaylists is enabled).",
      "maximum": 500,
      "minimum": 1,
      "title": "Max Playlists",
      "type": "integer"
    },
    "maxShorts": {
      "default": 20,
      "description": "Maximum number of Shorts to return (when includeShorts is enabled).",
      "maximum": 2000,
      "minimum": 1,
      "title": "Max Shorts",
      "type": "integer"
    },
    "maxVideos": {
      "default": 50,
      "description": "Maximum number of videos to scrape per channel. Set to 0 to get only channel info without videos.",
      "editor": "number",
      "maximum": 10000,
      "minimum": 0,
      "prefill": 3,
      "title": "Max Videos Per Channel",
      "type": "integer"
    },
    "sortVideosBy": {
      "default": "newest",
      "description": "How to sort the channel's video listings.",
      "editor": "select",
      "enum": [
        "newest",
        "popular",
        "oldest"
      ],
      "enumTitles": [
        "Newest first",
        "Most popular",
        "Oldest first"
      ],
      "title": "Sort Videos By",
      "type": "string"
    }
  },
  "required": [
    "channelUrls"
  ],
  "schemaVersion": 1,
  "title": "YouTube Channel Scraper Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

Field	Type	Required	Description
`videos`	string	optional	Dataset containing all scraped channel info, author metadata, and video rows.

Download the published output schema

View complete JSON

{
  "actorOutputSchemaVersion": 1,
  "description": "Channel video rows with author metadata, subscriber count and optional Shorts, playlists and live-stream data.",
  "properties": {
    "videos": {
      "description": "Dataset containing all scraped channel info, author metadata, and video rows.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "YouTube channel videos",
      "type": "string"
    }
  },
  "title": "YouTube Channel Video Feed Quick Scraper Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON

{
  "actorSpecification": 1,
  "views": {
    "detailed": {
      "display": {
        "component": "table",
        "properties": {
          "authorMetadata.aboutDescription": {
            "format": "text",
            "label": "About Description"
          },
          "authorMetadata.avatarUrl": {
            "format": "link",
            "label": "Avatar URL"
          },
          "authorMetadata.bannerUrl": {
            "format": "link",
            "label": "Banner URL"
          },
          "authorMetadata.channelId": {
            "format": "text",
            "label": "Channel ID"
          },
          "authorMetadata.channelLinks": {
            "format": "text",
            "label": "Channel Links"
          },
          "authorMetadata.channelName": {
            "format": "text",
            "label": "Channel"
          },
          "authorMetadata.channelUrl": {
            "format": "link",
            "label": "Channel URL"
          },
          "authorMetadata.country": {
            "format": "text",
            "label": "Country"
          },
          "authorMetadata.description": {
            "format": "text",
            "label": "Description"
          },
          "authorMetadata.externalLinks": {
            "format": "text",
            "label": "External Links"
          },
          "authorMetadata.handle": {
            "format": "text",
            "label": "Handle"
          },
          "authorMetadata.isFamilySafe": {
            "format": "boolean",
            "label": "Family Safe"
          },
          "authorMetadata.isVerified": {
            "format": "boolean",
            "label": "Verified"
          },
          "authorMetadata.joinedDateText": {
            "format": "text",
            "label": "Joined Date"
          },
          "authorMetadata.keywords": {
            "format": "text",
            "label": "Keywords"
          },
          "authorMetadata.location": {
            "format": "text",
            "label": "Location"
          },
          "authorMetadata.rssUrl": {
            "format": "link",
            "label": "RSS URL"
          },
          "authorMetadata.subscriberCount": {
            "format": "number",
            "label": "Subscribers"
          },
          "authorMetadata.subscriberCountText": {
            "format": "text",
            "label": "Subscribers Text"
          },
          "authorMetadata.totalViews": {
            "format": "number",
            "label": "Total Views"
          },
          "authorMetadata.totalViewsText": {
            "format": "text",
            "label": "Total Views Text"
          },
          "authorMetadata.videoCount": {
            "format": "number",
            "label": "Video Count"
          },
          "authorMetadata.videoCountText": {
            "format": "text",
            "label": "Videos Text"
          },
          "badges": {
            "format": "text",
            "label": "Badges"
          },
          "description": {
            "format": "text",
            "label": "Description"
          },
          "duration": {
            "format": "text",
            "label": "Duration"
          },
          "durationSeconds": {
            "format": "number",
            "label": "Duration (s)"
          },
          "isLive": {
            "format": "boolean",
            "label": "Live"
          },
          "isShort": {
            "format": "boolean",
            "label": "Short"
          },
          "liveVideos": {
            "format": "text",
            "label": "Live Videos"
          },
          "playlists": {
            "format": "text",
            "label": "Playlists"
          },
          "publishedTimeText": {
            "format": "text",
            "label": "Published"
          },
          "scrapedAt": {
            "format": "text",
            "label": "Scraped At"
          },
          "shorts": {
            "format": "text",
            "label": "Shorts"
          },
          "thumbnailUrl": {
            "format": "link",
            "label": "Thumbnail"
          },
          "title": {
            "format": "text",
            "label": "Title"
          },
          "url": {
            "format": "link",
            "label": "URL"
          },
          "videoId": {
            "format": "text",
            "label": "Video ID"
          },
          "viewCount": {
            "format": "number",
            "label": "Views"
          },
          "viewCountText": {
            "format": "text",
            "label": "Views Text"
          }
        }
      },
      "title": "Detailed",
      "transformation": {
        "fields": [
          "videoId",
          "title",
          "url",
          "viewCount",
          "viewCountText",
          "publishedTimeText",
          "duration",
          "durationSeconds",
          "thumbnailUrl",
          "description",
          "isLive",
          "isShort",
          "badges",
          "authorMetadata.channelId",
          "authorMetadata.channelName",
          "authorMetadata.handle",
          "authorMetadata.channelUrl",
          "authorMetadata.subscriberCount",
          "authorMetadata.subscriberCountText",
          "authorMetadata.videoCount",
          "authorMetadata.videoCountText",
          "authorMetadata.country",
          "authorMetadata.isVerified",
          "authorMetadata.avatarUrl",
          "authorMetadata.bannerUrl",
          "authorMetadata.rssUrl",
          "authorMetadata.isFamilySafe",
          "authorMetadata.keywords",
          "authorMetadata.description",
          "authorMetadata.aboutDescription",
          "authorMetadata.channelLinks",
          "authorMetadata.joinedDateText",
          "authorMetadata.totalViewsText",
          "authorMetadata.totalViews",
          "authorMetadata.location",
          "authorMetadata.externalLinks",
          "shorts",
          "playlists",
          "liveVideos",
          "scrapedAt"
        ],
        "flatten": [
          "authorMetadata"
        ]
      }
    },
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "authorMetadata.channelName": {
            "format": "text",
            "label": "Channel"
          },
          "authorMetadata.subscriberCount": {
            "format": "number",
            "label": "Subscribers"
          },
          "duration": {
            "format": "text",
            "label": "Duration"
          },
          "publishedTimeText": {
            "format": "text",
            "label": "Published"
          },
          "title": {
            "format": "text",
            "label": "Title"
          },
          "url": {
            "format": "link",
            "label": "URL"
          },
          "videoId": {
            "format": "text",
            "label": "Video ID"
          },
          "viewCount": {
            "format": "number",
            "label": "Views"
          }
        }
      },
      "title": "Overview",
      "transformation": {
        "fields": [
          "title",
          "videoId",
          "viewCount",
          "duration",
          "publishedTimeText",
          "url",
          "authorMetadata.channelName",
          "authorMetadata.subscriberCount"
        ],
        "flatten": [
          "authorMetadata"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

YouTube Channel Video Feed Quick Scraper

Point this actor at one or more YouTube channels and get back their current video list — newest, most popular or oldest first — plus the channel's own profile numbers, without opening a browser tab for each one. It's built for runs where you need a lot of channels processed quickly rather than every last enrichment field.

What this actor does

Accepts any mix of channel handles (@name), full channel URLs, or raw channel IDs across a single run
Lists each channel's videos sorted newest, most popular, or oldest first, up to a per-channel cap
Optionally also pulls the channel's About-page data (total views, join date, location, external links), Shorts tab, Playlists tab, and Live/Streams tab
Returns a channel-info-only row (no video fields) when maxVideos is set to 0, for lightweight profile lookups
Localizes results to a market/country code, affecting what YouTube itself serves for that region
Omits any field YouTube didn't expose for that video or channel — it never fills a gap with an empty string or a made-up value

Output per video row

Every row carries one video's fields plus the full authorMetadata object for its channel.

videoId, title, url
viewCount — only when YouTube's own data exposes an exact integer; a rounded label like "93K views" stays in viewCountText and is never converted into a fake exact number
viewCountText, publishedTimeText
duration — may be the literal string "LIVE" for an ongoing stream; durationSeconds is only present once YouTube reports a finite length
thumbnailUrl, description
isLive, isShort
badges — labels shown on the video tile, e.g. ["LIVE"] or ["NEW"], when any apply
shorts[], playlists[], liveVideos[] — only present when the matching include... input is on
scrapedAt

`authorMetadata` fields

channelId, channelName, handle, channelUrl
description — the channel's short header description
aboutDescription — the longer description shown on the channel's About page, when includeAbout is on
subscriberCount — only when YouTube's source data gives an exact integer; subscriberCountText always carries the displayed label (e.g. "466M subscribers")
videoCount, videoCountText — same exact-vs-rounded distinction as subscribers
country, location — location and totalViews/totalViewsText/joinedDateText come from the About page (includeAbout)
joinedDateText, totalViews, totalViewsText
externalLinks[] — links listed on the About page (includeAbout); channelLinks[] — links shown directly on the channel header
rssUrl, avatarUrl, bannerUrl
isVerified, isFamilySafe
isOfficialArtistChannel — only present when the channel carries YouTube's official-artist badge
keywords[]

Input

Field	Type	Default	Description
`channelUrls`	array	–	Channel URLs, handles or channel IDs, any mix
`maxVideos`	integer	`50`	Max videos per channel (0–10000); `0` returns channel info only
`sortVideosBy`	string	`newest`	`newest`, `popular` or `oldest`
`includeAbout`	boolean	`true`	Pull total views, join date, location and external links from the About page
`includePlaylists`	boolean	`false`	Include the channel's Playlists tab
`maxPlaylists`	integer	`20`	Max playlists to return when `includePlaylists` is on (1–500)
`includeShorts`	boolean	`false`	Include the channel's Shorts tab
`maxShorts`	integer	`20`	Max Shorts to return when `includeShorts` is on (1–2000)
`includeLiveVideos`	boolean	`false`	Include the channel's Live/Streams tab
`maxLiveVideos`	integer	`20`	Max live/stream videos to return (1–500)
`market`	string	`US`	Country code controlling localized content (one of 31 supported)

Example: a few channels' latest uploads

{
  "channelUrls": ["@Apify", "@mkbhd"],
  "maxVideos": 10,
  "sortVideosBy": "newest"
}

Example: most popular videos with full channel profile data

{
  "channelUrls": ["@Fireship"],
  "maxVideos": 20,
  "sortVideosBy": "popular",
  "includeAbout": true
}

Example: channel profile only, no videos

{
  "channelUrls": ["@mrbeast"],
  "maxVideos": 0
}

Example: including Shorts and playlists

{
  "channelUrls": ["@mkbhd"],
  "maxVideos": 25,
  "includeShorts": true,
  "maxShorts": 15,
  "includePlaylists": true,
  "maxPlaylists": 10
}

Use cases

Bulk channel monitoring — track upload activity across a long list of channels on a recurring schedule
Competitor benchmarking — compare view counts and posting cadence across several creators in a niche at once
Influencer shortlisting — pull subscriber counts and verification status for a batch of candidate channels
Content inventory — build a catalog of a channel's videos, Shorts and playlists for cataloging or archival
Growth tracking — re-run on a schedule to watch subscriber and view counts change over time

FAQ

Is a YouTube API key needed? No — this actor reads YouTube's own public channel and video pages and needs no API key or login.

Which channel reference formats work? A @handle, a full /channel/UC... URL, a full @handle URL, or a raw channel ID all resolve to the same channel — use whichever you already have.

Can it reach private or members-only channels? No, only publicly accessible channels are supported; content requiring a logged-in session isn't reachable.

Why is viewCount sometimes missing even though viewCountText shows a number? YouTube's video-card label is often rounded (e.g. "93K views"). This actor only fills viewCount when the underlying data gives an exact figure, rather than reverse-engineering an approximate one.

Why would duration show "LIVE" with no durationSeconds? That's an ongoing live stream — its length isn't final yet, so there's nothing finite to report until the broadcast ends.

How fresh is the data? Every run reads the channel live, so results reflect whatever YouTube is currently showing — there's no caching layer.

Does market change which videos are returned? It sets the country/language context YouTube uses when rendering the page, which can affect things like localized text and regionally restricted content, not which channel you're looking at.

Can I fetch 5,000+ videos from one channel? Yes — maxVideos goes up to 10,000; the actor keeps paging through the channel's video list until it reaches your cap or runs out of videos.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build ApEicopgZDiYq7DoC. Documentation is regenerated from the default published build; private drafts are not included.

YouTube Channel Video Feed Quick Scraper

Input schema

Output schema

Dataset schema

Key-value schema

Published README

YouTube Channel Video Feed Quick Scraper

What this actor does

Output per video row

authorMetadata fields

Input

Example: a few channels' latest uploads

Example: most popular videos with full channel profile data

Example: channel profile only, no videos

Example: including Shorts and playlists

Use cases

FAQ

Python quickstart

`authorMetadata` fields