Skip to main content
  • Version 5.2.0
  • Working

YouTube-Parser

A parser for YouTube data and contacts

A ZennoPoster template that collects YouTube data from lists of queries and links: search results, metadata of channels, videos and playlists, comments, posts, trends, Shorts and search suggestions. It finds emails in channel descriptions and links to social networks. It downloads videos, subtitles and thumbnails. The result of each task is saved to a table.

The search results tab in the YouTube-Parser input settings
The Search results tab of the input settings.
2 API
data sourcesthe official YouTube API v3 and the internal InnerTube API
600
results per querythe YouTube search results limit
10,000
quota units per dayper YouTube API key, shared by all tasks
Excel
result tablesa separate report for each task

Two data sources: YouTube API v3 and InnerTube API

The method is chosen in the input settings. Some tasks work through only one of them.

The method determines which fields appear in the result table.

YouTube API v3

The official YouTube API. It needs API keys: each key has a daily quota shared by all tasks. In search it collects videos, channels or playlists.

InnerTube API

The internal API that the YouTube site itself uses. In search it collects videos only and can search by hashtag. Large runs need proxies or a delay between requests.

Tasks and methods

One run performs one task. You choose it on the first settings tab, and the input comes from a text file with a list of queries or links.

Open the task list in the documentation
TaskYouTube APIInnerTube API
Search and feeds
Search results
Search suggestions
Trends
Shorts
Channels
Channel metadata
Channel subscriptions
Social network links
Videos
Video metadata
Video comments
Playlists and posts
Playlist metadata
Playlist videos
Channel posts
Post comments
Downloads
Video download
Channel download
Subtitle download
Thumbnail download

A separate task checks whether API keys work.

Features

What the template collects and downloads

Filters and limits are set on the task tab in the input settings.

Search and feeds

  • search results: videos, channels or playlists by query
  • search filters: order, dates, category, duration, license, subtitles, live streams
  • video search by hashtag
  • search suggestions for keywords
  • trends by country and category: news, music, gaming, movies
  • the Shorts feed, up to 500 videos

Channels and contacts

  • channel metadata: description, statistics and other public fields
  • emails from the channel description text, in a separate column
  • saving only channels with an email, excluding addresses collected earlier
  • social network links from the channel profile
  • channel subscriptions, if they are public
  • filters: minimum subscribers, minimum views, created before a year, countries

Videos and comments

  • video metadata by links or for the latest videos of a channel
  • video filters: minimum views, published after a date
  • video comments by video links or by channels
  • search for comments containing given text, excluding replies
  • comment filters: text or regex, minimum likes, posted after a date and time

Playlists and posts

  • playlist metadata by links or by channels
  • the list of videos in playlists
  • channel community posts
  • post comments filtered by text, regex and likes

Downloads

  • videos by links, playlists and channels: with audio or audio only
  • quality from 360p to 2160p or the highest available
  • channels: videos, live streams or Shorts with a per-channel limit
  • channel copying: downloaded videos and a table in the YouTube-Uploader scheduler format
  • subtitles: language, author-uploaded or auto-generated, saved as plain text
  • thumbnails by links to videos or to images

Results and run settings

  • a separate result table for each task
  • filtering during collection or later in Excel
  • duplicate removal, can be turned off in the settings
  • country and language of results
  • http and socks5 proxies with rotation, a delay between requests
  • API key check and a random key order in threads
Interface

Template input settings

Settings are split into tabs by task. The heading of each block names the method the task works through. The interface is in Russian.

The search results tab in the YouTube-Parser input settings

Search

Search results through YouTube API: type of collected data, result order, publication dates, category, definition, duration and license of videos.

How a run goes

A topic base is usually collected in two stages: first links from search results, then detailed data for each link.

01

Choose the method and the task

On the first settings tab, set the method, YouTube API or InnerTube API, and one task for the run.

02

Fill in the input file

Search queries or links to channels, videos, playlists, posts and thumbnails go into the text file of the task, one value per line.

03

Set filters and limits

On the task tab, choose the input source, filters and limits. The country and language of results are set on the Additional tab.

04

Prepare keys or proxies

For YouTube API, add API keys. For large InnerTube API runs, turn on proxies or the delay between requests.

05

Run and check the report

Test the run on a few lines first. Tables are saved to the Results folder, downloaded files to the Downloads folder.

What is required to run it

The template runs on an ordinary PC or a server. Tasks through YouTube API need API keys, and large runs through InnerTube API need proxies.

Requirements

Automation
ZennoPoster or ZennoBox 7.8.0.0 and newer: Lite, Standard or Pro
OS
Windows 10
Platform
.NET Framework 4.8 and 3.5
Spreadsheets
Microsoft Excel for result tables
Hardware
Intel i3-class CPU or better, 4 GB RAM or more
Hosting
local PC, VPS, VDS or dedicated server

Support and updates

  • Technical support in Telegram direct messages
  • Access to the customer chat in Telegram
  • Fixes after changes on the Google or YouTube side are released within two days
  • New features are added as the need arises
Price and licenses

Two license types

Rental

$170 first payment

  • From the second month $20 per month
  • You pay for as long as you use the template
  • Updates and support on Telegram
Buy rental

Lifetime

$400 one-time payment

  • Unlimited access to the template
  • No monthly payments
  • Updates and support on Telegram
Buy Lifetime
  • No ZennoPoster? The template runs in ZennoBox; issuing it costs $10, paid once.
  • The license is bound to one Email and ZennoLab ID and cannot be transferred.

Common questions

How many results does one search query give?

YouTube returns at most 600 results per query. This limit cannot be bypassed. To collect more channels, videos or playlists on a topic, use several different queries.

Can I find channels by country or subscriber count?

Not directly: YouTube does not search channels by country, audience or subscriber count. First you collect links by search queries, then channel metadata. Filters apply to that metadata: subscribers, views, creation year, country.

Where do I get API keys and how far do they go?

YouTube Data API v3 keys are created in the Google developer console. The daily quota of one key covers roughly 5 search queries or the metadata of 10,000 videos or channels. The quota resets every day, and several keys raise the daily volume.

When are proxies needed?

For large runs of tasks through InnerTube API. YouTube limits the request rate from one IP and may ask for a captcha. As a guide: about 50 search queries, or 500 to 1,000 videos or channels, per IP. Private IPv4 http or socks5 proxies are suitable. Without proxies, you can turn on a delay between requests.

Which emails does the template collect?

Addresses that the channel owner wrote in the description text. The template finds them while collecting channel metadata and writes them to a separate table column. Channels with no address in the description can be left out of the report.

What if a run is interrupted?

Intermediate results are kept in the service database of the template. Start the template for a single execution: it will try to save the data from the database and create the tables.

I do not have ZennoPoster. What should I do?

The template runs in ZennoBox. Issuing ZennoBox is paid once, together with the first license payment; the amount is in the license block.

Still have questions before buying?

The author has a single up-to-date contact: Telegram. Use only the button below and do not search for the account by nickname or avatar.