Youtube Explorer

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.

Chapter 1: Quick Guide

QUERIES

Example :

{ "query": QUERYINPUT }

🟨 QUERYINPUT possible values :

Format	Description	Usage
KEYWORDS	Search terms	Searching for keywords
#HASHTAG	Hashtag name	Searching for hashtag
#HASHTAG/shorts	Hashtag name	Searching for hashtag (shorts)
VIDEO_ID	Video ID	Scraping Video info/content/comments
`VIDEO_ID/comments/[top	newest]`	Video ID
`VIDEO_ID/chat/[top	live]`
PLxxxxxxxx	Playlist ID	Scraping Playlist content
UCxxxxxxxx	Channel ID	Scraping Channel main content
@CHANNEL	Channel Canonical name	Scraping a Channel main contents
@CHANNEL/SECTION	Channel Section	Scraping Channel Section contents
URL	Youtube URL	Autodetection Youtube URL for possible contents

🟨 SECTION possible channel section values :

Value	Description
FEATURED	Home
VIDEOS	Videos
SHORTS	Shorts/ Reels
STREAMS	Live
PLAYLISTS	Playlists
COMMUNITY
CHANNELS
ABOUT
STORIES
STORE	Products list
TRENDING
RELEASE

Chapter 2: Tutorial

Example #1: Basic Usage

Search video based on keywords.

1{
2	"query": "how to scrap a website",
3	"limit": 100
4}

parameter	type	values	description
query	string	any text	Keywords to search
limit	integer	numeric	limit MAXIMUM number of results

Example #2: Exploring a Channel, Playlist, Hashtag, etc.

Exploring a channel contents (use: channel_id prefix UCxxxx or @xxxx)

1{
2	"query": "UCxxxxxxxxxxxxxxxxxxxxxxx"
3}

Exploring a playlist contents (use: playlist_id prefix PLxxxx)

1{
2	"query": "PLxxxxxxxxxxxxxxxxxxxxxxx"
3}

Exploring a #hastag contents (use: #hashtag prefix #xxxx)

1{
2	"query": "#webscraping"
3}

Example #3: Scraping Video Comments

1{
2	"query": "<--VIDEOID-->"
3}

Example #4: Sorting & Limiting

Sorting the results by specific key

1{
2	"query": "apify",
3	"sort": "date",
4	"limit": 20
5}

parameter	type	values	description
limit	integer	any number	Limit number of results
sort	string	date views rating	Sort the results by key

Example #5: Search filters

Limiting results by media type.

1{
2	"query": "Dangdut",
3	"limit": 20,
4	"search_type": "channel"
5}

Limiting results by media features.

1{
2	"features:360": true,
3	"features:3d": true,
4	"features:4k": true,
5	"features:creative": true,
6	"features:hd": true,
7	"features:hdr": true,
8	"features:live": true,
9	"features:location": true,
10	"features:purchased": true,
11	"features:subtitle": true,
12	"features:vr180": true
13}

parameter	type	values	description
search_type	string	video channel playlist movie song music	Type of media to search
features:<name>	boolean	true or false	filter video results by features

Example #6: Additional Data (comming soon)

Includes additional video data

1{
2	"include_video_metadata" : true,
3	"include_video_captions" : true 
4}

parameter	type	description
include_streams	boolean	get video metadata (including streams url)
include_captions	boolean	get video caption/subtitle if available

Chapter 3: Results Grouping

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

Example :

Group header

{ "group_id": 1, "type": "group", "title": "Shorts" },

Group items

1...
2{ "group_id": 1, "type": "video", "title": "Is web scraping legal?", ... },
3{ "group_id": 1, "type": "video", "title": "Scrape data from any website!", ... },
4{ "group_id": 1, "type": "video", "title": "Python WEB SCRAPING in 30 Seconds!", ... },
5...

Chapter 4: 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,
10    "streams": {
11        "formats": [ ... ],	// list of video & audio streams
12        "audios": [ ... ], 	// list of audio-only streams
13        "videos": [ ... ]	// list of video-only streams
14    }
15}