YouTube Channel Details Scraper

Scrape public YouTube channel profiles from handles, channel IDs, and channel URLs. Get channel identity, descriptions, subscribers, videos, views, country, joined date, avatars, links, tags, and recent public channel section titles in a clean dataset.

Scrape YouTube channel profiles from handles, IDs, or URLs

Submit public @handles, channel IDs, or YouTube channel URLs to collect channel-level profile data and public metrics.

What does YouTube Channel Details Scraper do?

YouTube Channel Details Scraper turns a list of public YouTube channels into structured profile records.

Use it when you need repeatable channel research without manually opening every profile.

It accepts common YouTube channel formats:

• @Apify
• Apify
• https://www.youtube.com/@Apify
• https://www.youtube.com/channel/UCTgwcoeGGKmZ3zzCXN2qo_A
• UCTgwcoeGGKmZ3zzCXN2qo_A

For each channel, the actor saves a dataset item with public profile details and channel-level metrics.

Who is it for?

Influencer marketers

Build prospect lists, qualify creators, and compare public channel metrics before outreach.

Creator economy teams

Monitor channel profiles, descriptions, links, and public audience signals across creator lists.

Sales and lead generation teams

Find official websites and social links from channel About pages for targeted outreach.

Content intelligence platforms

Enrich channel databases with public metadata for dashboards, rankings, and categorization.

Researchers and journalists

Collect public profile snapshots for media research, platform studies, and trend analysis.

Why use this actor?

• 🎯 Accepts handles, channel IDs, and full URLs.
• 📊 Returns both display count text and parsed numeric counts where possible.
• 🔗 Extracts public external links from channel profiles.
• 🧭 Includes country and joined date when YouTube exposes them publicly.
• 🧾 Saves one clean dataset item per channel.
• ⚠️ Saves graceful error rows for invalid or unavailable channels.
• 💸 Pay-per-result pricing keeps small tests affordable.

YouTube channel fields returned

Field	Description
input	Original channel input you submitted
channelUrl	Normalized YouTube channel URL used for the lookup
channelId	YouTube channel ID when available
handle	Public @handle when available
title	Channel title
description	Public channel description/about text
subscriberCountText	Subscriber count as shown by YouTube
subscriberCount	Parsed subscriber count number when possible
videoCountText	Video count as shown by YouTube
videoCount	Parsed video count number when possible
viewCountText	Total channel views as shown by YouTube
viewCount	Parsed channel view count number when possible
country	Public country field when available
joinedDateText	Public joined date text
canonicalUrl	Canonical public channel URL
avatarUrl	Channel avatar image URL
bannerUrl	Channel banner image URL when available
externalLinks	Public custom links listed by the channel
tags	Public keywords/tags when available
topics	Reserved for public topic metadata when available
recentSectionTitles	Public channel section titles
isVerified	Verification signal when visible
fetchedAt	ISO timestamp for the scrape
error	Per-channel error message if a lookup fails

How much does it cost to scrape YouTube channel details?

This actor uses pay-per-event pricing.

You pay a small start fee for each run and then a per-channel result fee for each channel profile saved to the dataset.

The default target price is about $0.50 per 1,000 channel results before volume discounts.

Exact pricing may be updated after platform cost validation and will be visible on the Apify Store pricing tab.

How to scrape YouTube channel profiles

1. Open the actor on Apify.
2. Paste YouTube handles, channel IDs, or channel URLs into Channel URLs or handles.
3. Set Maximum channels if you want to process only part of the list.
4. Keep Include recent section titles enabled if you want shelf names such as uploads or playlists.
5. Click Start.
6. Download results as JSON, CSV, Excel, XML, or HTML.

Input example

{
  "channelUrlsOrHandles": [
    "@Apify",
    "https://www.youtube.com/@YouTube",
    "UCTgwcoeGGKmZ3zzCXN2qo_A"
  ],
  "maxChannels": 3,
  "includeRecentSections": true,
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Output example

{
  "input": "@Apify",
  "channelUrl": "https://www.youtube.com/@Apify",
  "channelId": "UCTgwcoeGGKmZ3zzCXN2qo_A",
  "handle": "@Apify",
  "title": "Apify",
  "description": "Welcome to Apify’s official YouTube channel!",
  "subscriberCountText": "14.2K subscribers",
  "subscriberCount": 14200,
  "videoCountText": "253 videos",
  "videoCount": 253,
  "viewCountText": "9,753,002 views",
  "viewCount": 9753002,
  "country": "Czechia",
  "joinedDateText": "Joined Jan 4, 2017",
  "canonicalUrl": "https://www.youtube.com/@Apify",
  "avatarUrl": "https://yt3.googleusercontent.com/...",
  "externalLinks": [
    {
      "title": "Try Apify for FREE",
      "url": "https://apify.com/",
      "displayUrl": "apify.com"
    }
  ],
  "tags": ["web scraping", "automation"],
  "topics": [],
  "recentSectionTitles": ["Videos", "Shorts"],
  "isVerified": true,
  "fetchedAt": "2026-06-23T14:00:00.000Z"
}

Tips for best results

• Use canonical channel URLs or @handles when possible.
• Keep the first test run small so you can verify the output shape.
• Use the default concurrency for normal lists.
• Increase concurrency gradually for large batches.
• If a channel has hidden a field, the corresponding output value may be null.
• Use the error field to review invalid or unavailable channels.

Handling invalid channels

The actor does not fail the entire run when one input is invalid.

Instead, it saves an output item with the original input and an error message.

This makes it easier to process large lead lists where a few handles may be outdated.

Integrations

You can connect the dataset to:

• Google Sheets for creator prospecting.
• Airtable for influencer CRM workflows.
• Make or Zapier for outreach automation.
• Data warehouses for reporting.
• BI dashboards for channel monitoring.
• AI agents that need structured creator context.

API usage with Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

const run = await client.actor('fetch_cat/youtube-channel-details-scraper').call({
  channelUrlsOrHandles: ['@Apify'],
  maxChannels: 1,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

API usage with Python

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])

run = client.actor('fetch_cat/youtube-channel-details-scraper').call(run_input={
    'channelUrlsOrHandles': ['@Apify'],
    'maxChannels': 1,
})

items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

API usage with cURL

curl "https://api.apify.com/v2/acts/fetch_cat~youtube-channel-details-scraper/runs?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"channelUrlsOrHandles":["@Apify"],"maxChannels":1}'

MCP usage

Use this actor from AI tools through Apify MCP.

Claude Code example:

Use Apify MCP tool fetch_cat/youtube-channel-details-scraper to get public profile data for @Apify and summarize its channel positioning.

MCP server URL format:

https://mcp.apify.com/?tools=fetch_cat/youtube-channel-details-scraper

Claude Code CLI setup:

$claude mcp add apify-youtube-channel-details "https://mcp.apify.com/?tools=fetch_cat/youtube-channel-details-scraper"

Claude Desktop JSON setup:

{
  "mcpServers": {
    "apify-youtube-channel-details": {
      "url": "https://mcp.apify.com/?tools=fetch_cat/youtube-channel-details-scraper"
    }
  }
}

Example prompts:

• "Compare subscriber counts and website links for these 20 YouTube channels."
• "Find channels without public website links in this dataset."
• "Summarize the countries and joined dates of these creator prospects."

Data freshness

Each run fetches a fresh public channel profile snapshot.

The fetchedAt field records when the item was collected.

Use scheduled Apify tasks if you want recurring channel monitoring.

Limits

YouTube controls which fields are visible on each channel.

Some channels may not expose country, links, total views, or joined date.

Large lists should use moderate concurrency to reduce temporary blocking.

Legality

This actor extracts publicly visible YouTube channel profile information.

Do not use it to collect private account data, bypass access controls, spam creators, or violate YouTube terms.

You are responsible for ensuring that your use case complies with applicable laws and platform rules.

Troubleshooting

Why is a field empty?

The channel may not expose that field publicly, or YouTube may show a localized variant that cannot be parsed into the normalized field.

Why did an item include an error?

The input may be invalid, deleted, unavailable in the current region, or temporarily blocked by YouTube.

Should I enable proxy?

Start without proxy. If your environment receives temporary blocks, enable Apify Proxy and keep the batch small while testing.

FAQ

Can I scrape videos with this actor?

This actor focuses on channel profile details. Use a dedicated YouTube videos scraper for video listings.

Can I input @handles?

Yes. Handles with or without the @ symbol are accepted.

Can I submit channel IDs?

Yes. Channel IDs that start with UC are accepted.

Can I submit handles without the @ symbol?

Yes. A bare value such as Apify is treated as @Apify.

Can I find external links from YouTube channels?

Yes. Public external links exposed on channel profiles are returned when available.

Does this scrape videos or comments?

No. This actor is for channel-level public profile data. Use dedicated YouTube video or comment actors for those workflows.

Can I use this for influencer discovery?

Yes. Use it for public profile enrichment, channel metrics snapshots, and external-link discovery.

Does it return emails?

No. Owner-only contact fields and data hidden behind user actions are out of scope.

Related scrapers

• YouTube Channel Videos Scraper for public video lists.
• YouTube Video Details Scraper for video-level metadata.
• YouTube Comments Scraper for public comment threads.
• YouTube Search Results Scraper for discovery workflows.
• Website Contact Finder for public website/contact enrichment after channel discovery.

Changelog

0.1

Initial version for public YouTube channel profile metadata.

Support

If you need a field that is visible publicly but missing from the dataset, open an Apify issue with a sample channel URL and the expected field.