Youtube Keyword URLs Scraper

This Actor scrapes Youtube videos URLs that are related to specific keywords.

Input

Provide a list of keywords in the following formats:

{
  "keywords": ["music", "love"]
}

{
  "keywords": ["music", "love"],
  "date": "last-3-months"
}

{
  "keywords": ["music", "love"],
  "date": "ignore",
  "from": "2024-01-01",
  "to": "2024-02-01"
}

{
  "keywords": ["music", "love"],
  "from": "2024-01-01",
  "to": "2024-02-01"
}

---

Optional filters

date

A predefined date range filter. If provided and not set to ignore, this option takes precedence over from and to.

{
  "date": "last-6-months"
}

Allowed values:

• ignore
• last-1-day
• last-1-week
• last-1-month
• last-3-months
• last-6-months
• last-1-year

Note: Use ignore if you want to rely exclusively on the from / to date range instead.

---

from

Start date for filtering results.

{
  "from": "2024-01-01"
}

• Must be a valid date string.
• Only effective when date is set to ignore or when the date property is not provided at all.

---

to

End date for filtering results.

{
  "to": "2024-03-01"
}

• Must be a valid date string.
• Only effective when date is set to ignore or when the date property is not provided at all.

---

Output

The Actor returns a dataset with the following fields:

Field	Description
channel_name	The name of the channel
keyword	The queried keyword
video_url	URL of the video on Youtube

---

Notes on Date Filtering Behavior

• If date ≠ ignore, it overrides from and to.
• If date = ignore, the Actor uses the from / to range.
• If no date filters are provided, the Actor defaults to returning results from the last 6 months.