YouTube Search & Channel Data Scraper

A lightweight, high-performance, and cost-effective Apify Actor to scrape YouTube video search results (with full nextPage pagination support) and extract rich channel details, banners, and playlists.

Accepts channel IDs, custom URLs, and handles (like @MrBeast). It flattens all returned data so it displays perfectly in the Apify Overview grid table out of the box.

---

Features

• 🔍 YouTube Video Search: Fetch up to 20 detailed video results per request with uploader details, verification badges, durations, view counts, relative upload times, and short descriptions.
• 🏢 Channel Profile & Metadata: Get subscriber counts, verification badge status, avatar/banner links, related channels list, and tabs continuation tokens.
• 🔄 nextPage Token Support: Fully paginates search results and channel lists, returning a continuation token in the dataset so you can fetch the next page in subsequent runs.
• 🗂️ Database-Friendly Flat Mapping: Automatically transforms nested lists (like channel uploads) into flat rows, making them immediately viewable, downloadable as CSV, or syncable with database tables.

---

Input Parameters

The actor accepts the following parameters:

Field	Type	Description
mode	string	Scraping mode: Either search (Search Videos by Keyword) or channel (Get Channel Info).
query	string	The search keyword (Required if mode is search).
channelIdOrUrl	string	The YouTube Channel ID, handle (e.g. @MrBeast), or full URL (Required if mode is channel).
nextPageToken	string	The continuation token returned in the previous run's nextpage column (optional).

---

Output Examples

1. Search Results Dataset (CSV/JSON Flat Structure)

{
  "type": "search",
  "id": "/watch?v=dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "duration": 213,
  "views": 1787657742,
  "uploaderName": "Rick Astley",
  "uploaderVerified": true,
  "thumbnail": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/maxresdefault.webp",
  "uploaded": "16 years ago",
  "description": "The official video for Never Gonna Give You Up...",
  "nextpage": "eyJjb250ZXh0Ijp7ImNsaWVudCI6ey..."
}

2. Raw JSON Payload

The complete raw JSON response returned by the backend is stored in the default Key-Value Store under the key OUTPUT.