Welcome To YouTube Explorer

▶️ About YouTube.com

YouTube is an American online video sharing and social media platform headquartered in San Bruno, California. It was launched on February 14, 2005, by Steve Chen, Chad Hurley, and Jawed Karim. It is currently owned by Google, and is the second most visited website, after Google Search. YouTube has more than 2.5 billion monthly users[7] who collectively watch more than one billion hours of videos each day.[8] As of May 2019, videos were being uploaded at a rate of more than 500 hours of content per minute.[9][10]

▶️ About This Actor

Scrape publicly data about video, movie, song, music from Youtube.com. Search videos, comments, sort & filter by type, upload date, video quality & features.

▶️ Tutorial

🍿 Basic Parameters

Parameter	Type	Description
query	string array	Query, Search Terms or URL
limit	integer	Number of results (per-query)

🍿 Search Filters

Parameter	Type	Values	Description
filters.sort	string	date views rating	Video sorting
filters.kind	string	(See below)	Media types
filters.features	array	360 3d 4k creative hd hdr live location purchased subtitle vr180	Video features

🍿 Media Types

Type	Description
video	Videos
channel	YouTube Channels
playlist	Video Playlists
movie	Movie Videos (Trailers)
song	Songs
music	Music Videos
musiclist	Music Playlist
album	Music Albums
artist	Artist channels
podcast	Podcasts
episode	Podcast episodes
user	YouTube users

🍿 Basic Usage

Search videos

{ "query": ["sponge bobs"], "filters.kind": "video", "limit": 10 }

Autodetect youtube URL for possible contents

{ "query": ["https://www.youtube.com/results?search_query=python"], "limit": 10 }

🍿 Advanced Usage

YouTube Query Language (YQL) :

[ <COMMAND:> | # | @ ] [ <NAME> | <ID> | <KEYWORD> | <URL> ] [ /<SECTION> ]

Possible QUERY values :

Format	Example	Description
<KEYWORDS>	square pants	Search Anything
#<HASHTAG>	#webscraping	Search Hashtag
/shorts	#webscraping/shorts	Shorts videos
<VIDEO_ID>	WQNgQVRG9_U	Scrape Video
/comments	WQNgQVRG9_U/comments	New comments
/top_comments	WQNgQVRG9_U/top_comments	Top comments
<PLAYLIST_ID>	PLxxxxxxxxxxxxxxxxxxxxxxx	Scrape Playlist
/videos	PLxxxxxxxxxxxxxxxxxxxxxxx/videos	Playlist videos
/info	PLxxxxxxxxxxxxxxxxxxxxxxx/info	Playlist info
<CHANNEL_ID>	UCxxxxxxxxxxxxxxxxxxxxxxx	Scrape Channel
@<CHANNEL_NAME>	@apify
/info	@apify/info
/featured	@apify/featured
/videos	@apify/videos	Channel videos
/shorts	@apify/shorts	Channel shorts (reels)
/streams	@apify/streams	Channel live streams
/playlist	@apify/playlist	Channel playlists
/community	@apify/community	Channel community
/channels	@apify/channels	Related channels
/store	@apify/store	Products page
/releases	@apify/releases	Channel releases
https:<URL>	https://www.youtube.com	Start URL
/search	https://www.youtube.com/results
/channel/<channel>	https://www.youtube.com/channel/UCxxxxxx
/@<channel>	https://www.youtube.com/@apify

▶️ Examples

🍿 Example #1: Searching

Search video based on keywords.

{ "query": ["square pants"], "limit": 100 }

Sorting the results by specific key.

{ "query": ["square pants"], "filters.sort": "date", "limit": 20 }

Filters results by type.

{ "query": ["python"], "limit": 20, "filters.kind": "channel" }

Filter videos by features.

1{ 
2	"query": ["indonesia"], 
3	"limit": 20, 
4	"filters.kind": "video",
5	"filters.features": ["3d", "hd"]
6}

🍿 Example #2: Channel, Playlist and Hashtag

Scraping channel contents (use: channel_id prefix UCxxxx or @NAME)

{ "query": "UCxxxxxxxxxxxxxxxxxxxxxxx/videos" }

{ "query": "@apify/playlist" }

Scraping playlist contents (playlist_id prefix PLxxxx)

{ "query": "PLxxxxxxxxxxxxxxxxxxxxxxx" }

Scraping hashtag contents (prefix #HashTag)

{ "query": "#webscraping" }

{ "query": "#travel/shorts" }

🍿 Example #3: Video Data

Scrape video comments

{ "query": "__VIDEO_ID__/comments" }

{ "query": "__VIDEO_ID__/top_comments" }

▶️ Results Grouping

Some results can belong to a group. A group identified by group field, consist of a group header followed by several object (group member).

Example :

1[
2	...
3	# group header
4	{ "group": 1, "type": "group", "title": "Shorts" },
5	# group items
6	{ "group": 1, "type": "video", "title": "Is web scraping legal?", ... },
7	{ "group": 1, "type": "video", "title": "Scrape data from any website!", ... },
8	{ "group": 1, "type": "video", "title": "Python WEB SCRAPING in 30 Seconds!", ... }
9	...
10]

▶️ Output Samples

Video without metadata

1{
2    "id"		: "eQoO3Wh9JWM",
3    "published"	: "1 year ago",
4    "duration"	: "3:25",
5    "title"		: "How to extract data from Google Search with Google SERPs Scraper",
6    "type"		: "video",
7    "url"		: "https://www.youtube.com/watch?v=eQoO3Wh9JWM",
8    "views"		: "8,287 views"
9}

Video with metadata (using include_video_metadata=true option)

1{
2    "id"		: "eQoO3Wh9JWM",
3    "published"	: "2022-02-06",
4    "duration"	: 204, # duration in seconds
5    "title"		: "How to extract data from Google Search with Google SERPs Scraper",
6    "type"		: "video",
7    "uploaded"	: "2022-02-06",
8    "url"		: "https://www.youtube.com/watch?v=eQoO3Wh9JWM",
9    "views"		: 8287, # views count
10    "streams": {
11        "formats": [ ... ],	# list of video formats (video + audio stream)
12        "audios": [ ... ], 	# list of audio-only streams
13        "videos": [ ... ]	# list of video-only streams
14    }
15}

▶️ Support

⚡️ Feel free to reach out to the developer for any issues or suggestions for improvement.