YouTube Search Video

This Apify Actor is designed to search for YouTube videos or shorts based on specific keywords and filters. It retrieves detailed information about the videos, including metadata such as title, URL, duration, and more.

How to Use

1. Input Configuration

The Actor requires an input JSON object to define the search parameters. The structure of the input is as follows:

{
  "keywords": "nike",
  "size": 10,
  "Upload_date": "This month",
  "Duration": "Over 20 minutes",
  "Sort_by": "Relevance"
}

• keywords: (Required) The search keywords, e.g., nike, candle.
• size: (Required) The number of videos/shorts to retrieve. Default is 10. Minimum is 1.
• Upload_date: (Optional) Filter by upload date. Options include:
  • Last hour
  • Today
  • This week
  • This month
  • This year
• Duration: (Optional) Filter by video duration. Options include:
  • Under 4 minutes
  • 4 - 20 minutes
  • Over 20 minutes
• Sort_by: (Optional) Sort videos by. Options include:
  • Relevance
  • Upload date
  • View count
  • Rating

2. Output Data

The Actor returns an array of objects containing information about the videos. The structure of each object is as follows:

{
  "id": "abc123",
  "url": "https://www.youtube.com/watch?v=abc123",
  "title": "Example Video Title",
  "duration": "10:05",
  "lengthSeconds": 605,
  "thumbnails": [...],
  "channelName": "Example Channel",
  "channelUrl": "https://www.youtube.com/channel/xyz456",
  "channelId": "xyz456",
  "channelThumbnails": [...],
  "viewCount": 100000,
  "likeCount": 5000,
  "commentCount": 200,
  "description": "This is an example video description.",
  "publishDate": "2023-01-01"
}

• id: The unique ID of the video.
• url: The URL of the video.
• title: The title of the video.
• duration: The duration of the video in H:MM:SS format.
• lengthSeconds: The duration of the video in seconds.
• thumbnails: A list of thumbnail URLs for the video.
• channelName: The name of the channel that uploaded the video.
• channelUrl: The URL of the channel.
• channelId: The unique ID of the channel.
• channelThumbnails: A list of thumbnail URLs for the channel.
• viewCount: The number of views the video has received.
• likeCount: The number of likes the video has received.
• commentCount: The number of comments on the video.
• description: The description of the video.
• publishDate: The date the video was published.

3. Running the Actor

1. Deploy the Actor on the Apify platform.
2. Provide the input JSON in the Actor's input configuration.
3. Run the Actor to search for videos or shorts.
4. Retrieve the output dataset containing the video details.

Notes

• This Actor uses YouTube's public interface and may be subject to rate limits or restrictions.
• Ensure that the input keywords and filters are valid and relevant.
• The Actor is optimized for performance but may require adjustments based on YouTube's response behavior.