YouTube Search Scraper

An Apify actor that lets you scrape YouTube search results for videos, channels, playlists, and more, providing structured data for your analysis.

How to Use

1. Configure Your Search: Go to the Input tab and fill in what you want to search for. You only need to provide a Search Query to get started.

2. Run the Actor: Click the Start button and wait for the run to finish.

3. Get Your Data: Once the actor has finished, go to the Dataset tab to see the scraped results. You can download the data in formats like JSON, CSV, or Excel.

Input Configuration

Field	Type	Description
query	string	Required. The keywords you want to search for on YouTube.
maxResults	integer	The maximum number of results you want to get. The default is 100. This is ignored if you enable "Scrape all available results".
scrapeAllResults	boolean	If you check this box, the actor will scrape all search results it can find. This might take a long time and result in a very large dataset.
type	string	Filter your results by a specific type. You can choose: video, channel, playlist, movie, show, or shorts.
sortBy	string	How to sort the results. The options are: relevance (default), rating, date, or views.
duration	string	Filter videos by their length. Choose from: short (under 4 minutes), medium (4-20 minutes), or long (over 20 minutes).
uploadDate	string	See results from a specific time frame. Options: hour, today, week, month, or year.
geo	string	A 2-letter country code (e.g., US, GB, IN) to get results relevant to a specific country.
lang	string	A language code (e.g., en, es, fr) to get results in a specific language.
features	object	A set of filters to find videos with specific features. You can toggle flags like HD, Subtitles/CC, Creative Commons, 3D, Live, Purchased, 4K, 360, Location, HDR, and VR180.
local	boolean	If checked, the actor will request localized data from YouTube.

Output Data

The results will be stored in the dataset. Each item is a JSON object that represents a search result. Here is an example of what a video result looks like:

{
  "id": "3URtTIdnXIk",
  "title": "These CATS are too FUNNY! 🤣 | New Cat Videos 2025",
  "description": "You like cats? We got em! No dogs! Just cats! Seriously, all cats! #Funny #fails #Cats ✨    Subscribe to The Scoop for our most ...",
  "type": "video",
  "viewCount": 6721332,
  "duration": "1:00:17",
  "url": "https://www.youtube.com/watch?v=3URtTIdnXIk",
  "thumbnail": "https://i.ytimg.com/vi/3URtTIdnXIk/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDe0Kx_eCmmXTL4BWDF2CwYV1DC9g",
  "date": "2025-04-26T00:00:00Z",
  "channelName": "The Pet Collective",
  "channelUrl": "https://www.youtube.com/channel/UCPIvT-zcQl2H0vabdXJGcpg",
  "channelHandle": " @petcollective",
  "channelThumbnail": "https://yt3.ggpht.com/hTKCWonj9q8454mfEORlOoHHPwkFlfZu0sHp6-h5CXrnJNc3VugFMFo85pAV_gcJF8NZMlBy7g=s68-c-k-c0x00ffffff-no-rj",
  "searchQuery": "cats",
  "scrapedAt": "2025-12-26T17:28:05.692Z",
  "raw": {
    "type": "video",
    "videoId": "3URtTIdnXIk",
    "title": "These CATS are too FUNNY! 🤣 | New Cat Videos 2025",
    "channelTitle": "The Pet Collective",
    "channelId": "UCPIvT-zcQl2H0vabdXJGcpg",
    "channelHandle": " @petcollective",
    "channelThumbnail": [
      {
        "url": "https://yt3.ggpht.com/hTKCWonj9q8454mfEORlOoHHPwkFlfZu0sHp6-h5CXrnJNc3VugFMFo85pAV_gcJF8NZMlBy7g=s68-c-k-c0x00ffffff-no-rj",
        "width": 68,
        "height": 68
      }
    ],
    "channelAvatar": [
      {
        "url": "https://yt3.ggpht.com/hTKCWonj9q8454mfEORlOoHHPwkFlfZu0sHp6-h5CXrnJNc3VugFMFo85pAV_gcJF8NZMlBy7g=s68-c-k-c0x00ffffff-no-rj",
        "width": 68,
        "height": 68
      }
    ],
    "description": "You like cats? We got em! No dogs! Just cats! Seriously, all cats! #Funny #fails #Cats ✨    Subscribe to The Scoop for our most ...",
    "viewCountText": "6,721,332 views",
    "viewCount": "6721332",
    "publishedTimeText": "8 months ago",
    "publishDate": "2025-04-26",
    "publishedAt": "2025-04-26T00:00:00Z",
    "lengthText": "1:00:17",
    "thumbnail": [
      {
        "url": "https://i.ytimg.com/vi/3URtTIdnXIk/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLArOc6VT9yda48XEkTfWzc_OKFa-A",
        "width": 360,
        "height": 202
      },
      {
        "url": "https://i.ytimg.com/vi/3URtTIdnXIk/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDe0Kx_eCmmXTL4BWDF2CwYV1DC9g",
        "width": 720,
        "height": 404
      }
    ],
    "richThumbnail": [
      {
        "url": "https://i.ytimg.com/an_webp/3URtTIdnXIk/mqdefault_6s.webp?du=3000&sqp=CK3HusoG&rs=AOn4CLA3vACdWYGJg2cTahL_PGI4cjlxmw",
        "width": 320,
        "height": 180
      }
    ]
  }
}

Cost of Use

You'll be charged based on your Apify subscription for the computing resources used to run this actor. The cost will depend on how many results you scrape and how long the actor runs.