Tiktok Keyword URLs Scraper

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

Related

TikTok Hashtag Videos URLs Scraper

Input

Provide a list of keywords in the following formats:

{
  "keywords": ["online course", "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-2-days
• last-3-days
• last-4-days
• last-5-days
• last-6-days
• last-1-week
• last-2-weeks
• last-3-weeks
• last-1-month
• last-2-months
• last-3-months
• last-4-months
• last-5-months
• last-6-months
• last-7-months
• last-8-months
• last-9-months
• last-10-months
• last-11-months
• last-1-year
• last-2-years
• last-3-years
• last-7-years

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.

---

limit

Result limit

{
  "limit": "100"
}

---

Output

The Actor returns a dataset with the following fields:

Field	Description
user_name	The username of the video author
user_link	Direct link to the user’s Tiktok profile
keyword	The queried keyword
video_url	URL of the video on Tiktok

---

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.