Youtube Explorer avatar
Youtube Explorer
Try for free

7 days trial then $30.00/month - No credit card required now

View all Actors
Youtube Explorer

Youtube Explorer

jupri/youtube-explorer
Try for free

7 days trial then $30.00/month - No credit card required now

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

Welcome To YouTube Explorer

dont be sad readme is here

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 :

FormatDescriptionUsage
KEYWORDSSearch termsSearching for keywords
#HASHTAGHashtag nameSearching for hashtag
#HASHTAG/shortsHashtag nameSearching for hashtag (shorts)
VIDEO_IDVideo IDScraping Video info/content/comments
`VIDEO_ID/comments/[topnewest]`Video ID
`VIDEO_ID/chat/[toplive]`
PLxxxxxxxxPlaylist IDScraping Playlist content
UCxxxxxxxxChannel IDScraping Channel main content
@CHANNELChannel Canonical nameScraping a Channel main contents
@CHANNEL/SECTIONChannel SectionScraping Channel Section contents
URLYoutube URLAutodetection Youtube URL for possible contents

🟨 SECTION possible channel section values :

ValueDescription
FEATUREDHome
VIDEOSVideos
SHORTSShorts/ Reels
STREAMSLive
PLAYLISTSPlaylists
COMMUNITY
CHANNELS
ABOUT
STORIES
STOREProducts 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}
parametertypevaluesdescription
querystringany textKeywords to search
limitintegernumericlimit 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}
parametertypevaluesdescription
limitintegerany numberLimit number of results
sortstringdate views ratingSort 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}
parametertypevaluesdescription
search_typestringvideo channel playlist movie song musicType of media to search
features:<name>booleantrue or falsefilter 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}
parametertypedescription
include_streamsbooleanget video metadata (including streams url)
include_captionsbooleanget 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}
Developer
Maintained by Community
Actor metrics
  • 9 monthly users
  • 100.0% runs succeeded
  • 0.0 days response time
  • Created in Sep 2022
  • Modified about 1 month ago