# YouTube Channel Details Scraper (`fetch_cat/youtube-channel-details-scraper`) Actor Scrape public YouTube channel profiles from handles, IDs, or URLs. Export subscribers, videos, views, descriptions, links, country, joined date, avatars, tags, and verification signals. - **URL**: https://apify.com/fetch\_cat/youtube-channel-details-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.05 / 1,000 result extracteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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 ```json { "channelUrlsOrHandles": [ "@Apify", "https://www.youtube.com/@YouTube", "UCTgwcoeGGKmZ3zzCXN2qo_A" ], "maxChannels": 3, "includeRecentSections": true, "maxConcurrency": 3, "proxyConfiguration": { "useApifyProxy": false } } ```` ### Output example ```json { "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 ```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 ```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 ```bash 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: ```text 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: ```text https://mcp.apify.com/?tools=fetch_cat/youtube-channel-details-scraper ``` Claude Code CLI setup: ```bash claude mcp add apify-youtube-channel-details "https://mcp.apify.com/?tools=fetch_cat/youtube-channel-details-scraper" ``` Claude Desktop JSON setup: ```json { "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](https://apify.com/fetch_cat/youtube-channel-videos-scraper) for public video lists. - [YouTube Video Details Scraper](https://apify.com/fetch_cat/youtube-video-details-scraper) for video-level metadata. - [YouTube Comments Scraper](https://apify.com/fetch_cat/youtube-comments-scraper) for public comment threads. - [YouTube Search Results Scraper](https://apify.com/fetch_cat/youtube-search-results-scraper) for discovery workflows. - [Website Contact Finder](https://apify.com/fetch_cat/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. # Actor input Schema ## `channelUrlsOrHandles` (type: `array`): YouTube @handles, /channel/ IDs, /c/ names, or full channel URLs. One output item is saved per input. ## `maxChannels` (type: `integer`): Maximum number of channel inputs to process from the list. ## `includeRecentSections` (type: `boolean`): Include public section titles visible on the channel page, such as featured playlists or recent video shelves. ## `maxConcurrency` (type: `integer`): How many channel pages to fetch in parallel. Keep the default unless you have a large list. ## `proxyConfiguration` (type: `object`): Optional proxy settings. The default uses direct HTTP requests; enable Apify Proxy if YouTube blocks your environment. ## Actor input object example ```json { "channelUrlsOrHandles": [ "@Apify", "https://www.youtube.com/@YouTube" ], "maxChannels": 2, "includeRecentSections": true, "maxConcurrency": 3, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "channelUrlsOrHandles": [ "@Apify", "https://www.youtube.com/@YouTube" ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/youtube-channel-details-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "channelUrlsOrHandles": [ "@Apify", "https://www.youtube.com/@YouTube", ], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/youtube-channel-details-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "channelUrlsOrHandles": [ "@Apify", "https://www.youtube.com/@YouTube" ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call fetch_cat/youtube-channel-details-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/youtube-channel-details-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "YouTube Channel Details Scraper", "description": "Scrape public YouTube channel profiles from handles, IDs, or URLs. Export subscribers, videos, views, descriptions, links, country, joined date, avatars, tags, and verification signals.", "version": "0.1", "x-build-id": "Z1UftPfa6RKQ9YGnZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~youtube-channel-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-youtube-channel-details-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/fetch_cat~youtube-channel-details-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-youtube-channel-details-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/fetch_cat~youtube-channel-details-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-youtube-channel-details-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "channelUrlsOrHandles" ], "properties": { "channelUrlsOrHandles": { "title": "Channel URLs or handles", "type": "array", "description": "YouTube @handles, /channel/ IDs, /c/ names, or full channel URLs. One output item is saved per input.", "items": { "type": "string" } }, "maxChannels": { "title": "Maximum channels", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of channel inputs to process from the list.", "default": 2 }, "includeRecentSections": { "title": "Include recent section titles", "type": "boolean", "description": "Include public section titles visible on the channel page, such as featured playlists or recent video shelves.", "default": true }, "maxConcurrency": { "title": "Maximum concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many channel pages to fetch in parallel. Keep the default unless you have a large list.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. The default uses direct HTTP requests; enable Apify Proxy if YouTube blocks your environment." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```