Apify·YouTube

Pull YouTube Videos

/streamers/youtube-scraperasync$0.0045 / result

YouTube crawler and video scraper. Alternative YouTube API with no limits or quotas. Extract and download channel name, likes, number of views, and number of subscribers. Runs as an Apify actor (20–120 s); results are dataset rows.

Charged per returned row plus the flat fee.

Input

Field	Type	Required	Description
searchQueries	array	—	Enter search terms just like you would enter it in YouTube's search bar.
maxResults	integer	—	Limit the number of videos you want to crawl. If you scrape a channel, acts as a limit for regular videos. (default 0)
maxResultsShorts	integer	—	Limit the number of Shorts videos you want to crawl. (default 0)
maxResultStreams	integer	—	Limit the number of Stream videos you want to crawl. (default 0)
startUrls	array	—	Enter a link to a YouTube video, channel, playlist, hashtag or search results page. You can also import a CSV file or Google Sheet with a list of URLs.Note: Input from Search term will be ignored when using this option. If you only want to scrape shorts/streams, set Maximum search results to 0, othe (default [])
downloadSubtitles	boolean	—	If set to true, the scraper will download subtitles for the video and convert them to .srt format.
subtitlesLanguage	string (any, en, de, es, fr, it, ja, ko, …)	—	Language to download subtitles in.Note: Download subtitles must be turned on for this option to work. (default "en")
subtitlesFormat	string (srt, vtt, xml, plaintext)	—	Select in what format you want to download subtitles (default "srt")
sortingOrder	string (relevance, rating, date, views)	—	Select Youtube sorting parameter for search
dateFilter	string (hour, today, week, month, year)	—	Select Youtube upload date filter for search
videoType	string (video, movie)	—	Select Youtube video type filter for search
lengthFilter	string (under4, between420, plus20)	—	Select Youtube video length filter for search
isHD	boolean	—	Will apply the HD filter for search
hasSubtitles	boolean	—	Will apply the Subtitles/CC filter for search
hasCC	boolean	—	Will apply the Creative Commons filter for search
is3D	boolean	—	Will apply the 3D filter for search
isLive	boolean	—	Will apply the Live filter for search
isBought	boolean	—	Will apply the Purchased filter for search
is4K	boolean	—	Will apply the 4K filter for search
is360	boolean	—	Will apply the 360 degrees filter for search
hasLocation	boolean	—	Will apply the Location filter for search
isHDR	boolean	—	Will apply the HDR filter for search
isVR180	boolean	—	Will apply the VR180 filter for search
oldestPostDate	string	—	Only posts uploaded after or on this date will be scraped. Alternatively, specify how old the scraped videos should be in days. Putting 1 day will get you only today's posts, 2 days - yesterday's and today's, and so on. Note, that if you select this, sorting parameter will be auto-reset to NEWEST
sortVideosBy	string (NEWEST, POPULAR, OLDEST)	—	Maps to the sorting buttons on the top of the channel's 'Videos', 'Shorts' and 'Live' pages.
aiVideoDescription	boolean	—	If enabled, uses AI to generate a time-segmented description of the video, covering both visual and audio content for each segment. (default false)
aiVideoSummary	boolean	—	If enabled, uses AI to generate a concise conceptual summary of the video covering both visual and audio content. (default false)
saveSubsToKVS	boolean	—	If set to true, the scraper will save the downloaded subtitles to the key-value store. Note: Download subtitles must be turned on for this option to work.
preferAutoGeneratedSubtitles	boolean	—	If set to true, automatically generated subtitles are preferred to user subtitles. Note: A subtitle language must be selected and download subtitles must be turned on for this option to work.

Run it

curl -s https://sooma.dev/v1/run \ -H "Authorization: Bearer $SOOMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"provider":"apify","endpoint":"/streamers/youtube-scraper","input":{}}'

Or ask your agent: it will call inspect for this schema and run it over MCP.