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 yaml { "query": ["sponge bobs"], "filters.kind": "video", "limit": 10 } Autodetect youtube URL for possible contents yaml { "query": ["https://www.youtube.com/results?search_query=python"], "limit": 10 } ### 🍿 Advanced Usage YouTube Query Language (YQL) : html [ <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. yaml { "query": ["square pants"], "limit": 100 } Sorting the results by specific key. yaml { "query": ["square pants"], "filters.sort": "date", "limit": 20 } Filters results by type. yaml { "query": ["python"], "limit": 20, "filters.kind": "channel" } Filter videos by features. yaml { "query": ["indonesia"], "limit": 20, "filters.kind": "video", "filters.features": ["3d", "hd"] } ### 🍿 Example #2: Channel, Playlist and Hashtag Scraping channel contents (use: channel_id prefix UCxxxx or @NAME) yaml { "query": "UCxxxxxxxxxxxxxxxxxxxxxxx/videos" } yaml { "query": "@apify/playlist" } Scraping playlist contents (playlist_id prefix PLxxxx) yaml { "query": "PLxxxxxxxxxxxxxxxxxxxxxxx" } Scraping hashtag contents (prefix #HashTag) yaml { "query": "#webscraping" } yaml { "query": "#travel/shorts" } ### 🍿 Example #3: Video Data Scrape video comments yaml { "query": "__VIDEO_ID__/comments" } yaml { "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 : yaml [ ... # group header { "group": 1, "type": "group", "title": "Shorts" }, # group items { "group": 1, "type": "video", "title": "Is web scraping legal?", ... }, { "group": 1, "type": "video", "title": "Scrape data from any website!", ... }, { "group": 1, "type": "video", "title": "Python WEB SCRAPING in 30 Seconds!", ... } ... ] ## ▶️ Output Samples Video without metadata yaml { "id" : "eQoO3Wh9JWM", "published" : "1 year ago", "duration" : "3:25", "title" : "How to extract data from Google Search with Google SERPs Scraper", "type" : "video", "url" : "https://www.youtube.com/watch?v=eQoO3Wh9JWM", "views" : "8,287 views" } Video with metadata (using include_video_metadata=true option) yaml { "id" : "eQoO3Wh9JWM", "published" : "2022-02-06", "duration" : 204, # duration in seconds "title" : "How to extract data from Google Search with Google SERPs Scraper", "type" : "video", "uploaded" : "2022-02-06", "url" : "https://www.youtube.com/watch?v=eQoO3Wh9JWM", "views" : 8287, # views count "streams": { "formats": [ ... ], # list of video formats (video + audio stream) "audios": [ ... ], # list of audio-only streams "videos": [ ... ] # list of video-only streams } } ## ▶️ Support ⚡️ Feel free to reach out to the developer for any issues or suggestions for improvement.