📺 Youtube Profile & Channel List Scraper

Verified 99.4% Success Rate. Extract YouTube channel profiles & video lists. Scrape subscriber counts, metadata & transcripts using Transcript Downloader API. Perfect for competitor analysis, content research & market intelligence.

---

✨ Features

• 🏢 Channel profile extraction: Get channel metadata, subscriber count, total views, and creation date
• 📋 Complete video lists: Extract all videos from a channel with basic metadata
• 📊 Optional detailed metadata: Fetch full transcripts and metadata for individual videos
• 🔁 Batch processing: Handle multiple channels simultaneously
• ⚙️ Concurrency control: Adjust processing speed with configurable limits
• 🔄 Automatic retries: Handles API errors and retryable failures
• 🚦 Rate limiting: Built-in delays to respect API limits
• 💰 Cost tracking: Monitor API usage and costs per channel
• 🧠 Error tracking: All failures logged with detailed error information

---

🔧 Input Parameters

The actor accepts the following input:

Parameter	Type	Required	Default	Description
channelUrls	array	✅ Yes	-	List of YouTube channel URLs (supports @username and /channel/)
apiToken	string	✅ Yes	-	Your Transcript Downloader API bearer token
includeVideoDetails	boolean	No	false	Whether to fetch complete metadata for each video
includeComments	boolean	No	false	Whether to fetch comments (only shown when includeVideoDetails=true)
maxConcurrency	number	No	2	Max concurrent channel requests (range: 1-5)
videoLimit	number	No	50	Max videos to process per channel when includeVideoDetails=true

📥 Sample Input

{
  "channelUrls": [
    "https://www.youtube.com/@google",
    "https://www.youtube.com/channel/UCK8sQmJBp8GCxrOtXWBpyEA"
  ],
  "apiToken": "your-api-token",
  "includeVideoDetails": false,
  "includeComments": false,
  "maxConcurrency": 2,
  "videoLimit": 50
}

---

📤 Output Format

Each channel will produce a dataset item with the following structure:

Basic Channel Profile Output

{
  "channelUrl": "https://www.youtube.com/@google",
  "profile": {
    "youtube_id": "UCK8sQmJBp8GCxrOtXWBpyEA",
    "title": "Google",
    "url": "https://www.youtube.com/@google",
    "thumbnail": "https://yt3.ggpht.com/...",
    "description": "Channel description...",
    "total_media": 1234,
    "subscriber_count": 5000000,
    "total_views": 100000000,
    "country": "US",
    "creation_date": "2005-02-14 23:41:51"
  },
  "videos": [
    {
      "youtube_id": "abc123",
      "title": "Video Title",
      "thumbnail": "https://i.ytimg.com/vi/abc123/default.jpg",
      "published_at": "2024-01-01 12:00:00",
      "duration": 300
    }
  ],
  "summary": {
    "totalVideos": 1234,
    "videosInResponse": 1234,
    "videosWithDetails": 0,
    "totalCost": "0.500",
    "processingTime": "15.2s"
  },
  "downloadInfo": {
    "id": "01K31YQ38SNP30F7218NX4SMN7",
    "type": "list",
    "cost": "0.500",
    "status": "success",
    "created_at": "2025-01-23T20:01:17.000000Z"
  }
}

With Detailed Video Metadata

When includeVideoDetails: true, each video will include additional metadata:

{
  "youtube_id": "abc123",
  "title": "Video Title",
  "thumbnail": "https://i.ytimg.com/vi/abc123/default.jpg",
  "published_at": "2024-01-01 12:00:00",
  "duration": 300,
  "detailedMetadata": {
    "description": "Full video description...",
    "viewCount": 100000,
    "likeCount": 5000,
    "commentCount": 250,
    "channelName": "Channel Name",
    "channelUrl": "https://www.youtube.com/channel/...",
    "fullTranscript": "Complete video transcript...",
    "transcriptsWithTimeStamps": [
      {
        "start": "0.0",
        "dur": "3.5",
        "text": "Welcome to this video..."
      }
    ],
    "comments": {
      "mostRelevant": [
        {
          "author": "User123",
          "text": "This helped me so much!"
        }
      ],
      "mostRecent": [
        {
          "author": "User456", 
          "text": "Just watched it!"
        }
      ]
    }
  }
}

Note: The comments field only appears when both includeVideoDetails: true and includeComments: true.

---

🚀 How to Use

1. Get your API token from Transcript Downloader
2. Add channel URLs in supported formats:
   • https://www.youtube.com/@username
   • https://www.youtube.com/channel/CHANNEL_ID
   • https://www.youtube.com/c/channelname
   • https://www.youtube.com/user/username
3. Configure options based on your needs:
   • Set includeVideoDetails: false for basic channel info (faster, cheaper)
   • Set includeVideoDetails: true for complete video metadata (slower, more expensive)
4. Run the actor and access results in the dataset

---

❌ Error Handling

The actor gracefully handles common API errors:

Status Code	Meaning	Action
400	Invalid channel URL or channel restricted	Check URL format and availability
401	Insufficient credits or invalid token	Check credits and API token
403	Invalid API token	Regenerate API token
429	Rate limit exceeded	Actor handles with delays
503	Service temporarily unavailable	Retry automatically

Failed channels are captured in the dataset with error information:

{
  "channelUrl": "https://www.youtube.com/@invalid",
  "error": "Invalid channel URL or channel restricted",
  "status": "failed"
}

---

---

💳 Pricing & Billing

The Transcript Downloader API used by this actor requires a valid API token. API usage is billed separately and is based on processing time and file size.

📊 We charge on a per transcript/metadata basis. Visit our site to checkout pricing. View full details and subscription plans on our pricing page

---

⚠️ Rate Limiting & Performance

• 🔄 API Rate Limit: 75 requests per minute
• ⏱️ Built-in delays: Automatic delays between requests
• 🚦 Concurrency control: Recommended maxConcurrency: 1-3
• 📊 Processing time:
  • Basic profile: ~5-15 seconds per channel
  • With video details: ~1-2 minutes per video

---

💡 Best Practices

For Basic Channel Analysis

{
  "channelUrls": ["https://www.youtube.com/@channel1", "https://www.youtube.com/@channel2"],
  "apiToken": "your-token",
  "includeVideoDetails": false,
  "maxConcurrency": 3
}

For Detailed Content Analysis

{
  "channelUrls": ["https://www.youtube.com/@channel"],
  "apiToken": "your-token", 
  "includeVideoDetails": true,
  "includeComments": true,
  "maxConcurrency": 1,
  "videoLimit": 10
}

General Tips

• ✅ Start with includeVideoDetails: false to explore channels
• ✅ Use videoLimit to control costs when getting video details
• ✅ Enable includeComments: true only when you need comment analysis (requires video details)
• ✅ Keep maxConcurrency low (1-2) to avoid rate limits
• ✅ Monitor costs using the summary.totalCost field
• ✅ Validate channel URLs before running large batches

---

🔗 Supported URL Formats

The actor supports all major YouTube channel URL formats:

✅ https://www.youtube.com/@username
✅ https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxx
✅ https://www.youtube.com/c/channelname
✅ https://www.youtube.com/user/username
✅ http://www.youtube.com/@username (HTTP also supported)

---

📈 Monitoring & Analytics

Track your usage with the built-in summary data:

{
  "summary": {
    "totalVideos": 1234,
    "videosInResponse": 1234,
    "videosWithDetails": 50,
    "totalCost": "0.500",
    "processingTime": "45.2s"
  }
}

Use this data to:

• Monitor API costs per channel
• Track processing performance
• Plan batch processing strategies
• Optimize concurrency settings

---

🙋 Support

Need help? Visit Transcript Downloader Support. We respond within 24 business hours.

For technical issues with this actor, check the run logs for detailed error messages.

---

📄 License

This actor is provided under the ISC License.