TikTok Search Scraper — Videos by Keyword

Search TikTok videos by keyword instantly. Returns full video metadata with watermark-free download URLs.

Fast. Reliable. Bulk-ready.

---

Simple Input-Output Example

Input:

{
  "keywords": ["cooking"],
  "maxResultsPerKeyword": 20,
  "region": "US"
}

Output (one dataset item per video):

{
  "searchKeyword": "cooking",
  "videoId": "7639813342944660758",
  "url": "https://www.tiktok.com/@kyfitjourney/video/v24044gl0000d83131nog65lo0ief5f0",
  "title": "BBQ Chicken Burgers Will Always Be A 10/10 Dinner Request",
  "author": { "uniqueId": "kyfitjourney", "nickname": "KYRA | EASY RECIPES" },
  "playCount": 733026,
  "diggCount": 63687,
  "videoUrl": "https://v19.tiktokcdn-eu.com/.../play.mp4",
  "createdAt": "2026-05-15T08:17:44.000Z"
}

Important Notes:

• Pagination is automatic — set maxResultsPerKeyword to 1–200 (default 20)
• Multiple keywords supported — each is searched independently, results are aggregated
• Returns watermark-free video URLs (videoUrl) and watermarked URLs (videoUrlWithWatermark)
• Includes full music metadata (title, artist, duration, cover) when present
• Returns success even if a keyword has no results (an error row is only pushed on actual API failures)
• If the upstream API rate-limits us, you will not be charged for the affected keyword
• Contact for any issue / enquiry: contact@endspec.net

---

Full Actor Documentation

TikTok Search Scraper — Videos by Keyword

Search TikTok videos by any keyword and get back full metadata. Ideal for trend research, content discovery, influencer outreach prep, and competitive content analysis.

---

Overview

The TikTok Search Scraper is an Apify Actor that searches TikTok by keyword and returns full video metadata for each match. Whether you're tracking a trend, researching content for a marketing campaign, monitoring a competitor's content output, or building a dataset of creator content, this actor gives you clean, structured data fast.

What You Can Do

• Search by Keyword — one or many keywords per run; results are aggregated per keyword
• Get Watermark-Free Videos — direct CDN URLs for both watermarked and clean video downloads
• Full Metadata — title, description, author, play count, likes, comments, shares, music, cover images
• Regional Localization — set a country code (US, GB, DE, etc.) to localize results
• Bulk-Ready — paginates automatically up to 200 results per keyword

Data Availability

All data returned by this actor is publicly available information from TikTok's search interface. No private videos, no logged-in-only fields. The actor returns what any public TikTok user could see by searching the same keywords on the site.

---

Actor Input Parameters

The actor accepts the following input parameters:

keywords (required) • Type: array of strings • Description: One or more keywords to search TikTok for. Each keyword is searched independently and results are aggregated into the dataset. • Example: ["cooking", "baking"]

maxResultsPerKeyword (optional) • Type: integer • Default: 20 • Range: 1–200 • Description: Maximum number of videos to return for each keyword. The actor paginates the underlying API automatically.

region (optional) • Type: string • Default: "US" • Description: Two-letter country code (e.g. US, GB, DE) used to localize search results.

---

Input Examples

Example 1: Single Keyword

{
  "keywords": ["cooking"],
  "maxResultsPerKeyword": 20
}

Example 2: Multiple Keywords, Larger Batch

{
  "keywords": ["recipes", "baking", "meal prep"],
  "maxResultsPerKeyword": 50,
  "region": "US"
}

Example 3: Trend Research in a Specific Country

{
  "keywords": ["fashion 2026", "outfit ideas"],
  "maxResultsPerKeyword": 100,
  "region": "GB"
}

---

Output Schema

Each video is pushed as one dataset item. Field summary:

Field	Type	Description
searchKeyword	string	The keyword that surfaced this video
videoId	string	TikTok internal video id
awemeId	string	TikTok aweme id (used in some URLs)
url	string	Canonical TikTok video URL
title	string	Video caption/title
description	string	Full content description (multi-line if applicable)
region	string	Country/region of the video
durationSeconds	integer	Video duration in seconds
createdAt	ISO 8601 string	When the video was published
author.id	string	TikTok user id
author.uniqueId	string	TikTok username (e.g., kyfitjourney)
author.nickname	string	Display name
author.avatar	string	Profile picture URL
playCount	integer	View count
diggCount	integer	Like count
commentCount	integer	Comment count
shareCount	integer	Share count
downloadCount	integer	Download count
cover	string	Static cover image URL
coverDynamic	string	Animated cover URL
videoUrl	string	Watermark-free video download URL
videoUrlWithWatermark	string	TikTok-watermarked video URL
sizeBytes	integer	Video file size in bytes
music.title	string	Music track title
music.author	string	Music artist
music.url	string	Music audio URL
isAd	boolean	Whether this video is a paid ad
scrapedAt	ISO 8601 string	When this row was extracted

---

Output Examples

{
  "searchKeyword": "cooking",
  "videoId": "7639813342944660758",
  "url": "https://www.tiktok.com/@kyfitjourney/video/v24044gl0000d83131nog65lo0ief5f0",
  "title": "BBQ Chicken Burgers...",
  "description": "BBQ Chicken Burgers Will Always Be A 10/10 Dinner Request...",
  "author": {
    "id": "7326165710991377440",
    "uniqueId": "kyfitjourney",
    "nickname": "KYRA | EASY RECIPES",
    "avatar": "https://..."
  },
  "durationSeconds": 60,
  "createdAt": "2026-05-15T08:17:44.000Z",
  "playCount": 733026,
  "diggCount": 63687,
  "commentCount": 160,
  "shareCount": 2399,
  "videoUrl": "https://v19.tiktokcdn-eu.com/.../play.mp4",
  "music": { "title": "Never Lose Me", "author": "Flo Milli" },
  "isAd": false
}

---

Use Cases

Trend Research

• Track keyword performance over time
• Discover top creators in any niche
• Monitor emerging hashtags and topics

Influencer Outreach

• Build creator lists by topic/keyword
• Surface high-engagement videos for collaboration ideas
• Get author details for direct messaging research

Competitive Content Analysis

• Track competitor's content cadence and engagement
• Benchmark video metrics against your own content
• Find underused keywords with high engagement

Content Repurposing

• Source watermark-free TikTok content for analysis
• Build training data for video understanding models
• Aggregate creator content for compilations

---

Pricing

This actor uses pay-per-result pricing. You pay only for videos actually returned to your dataset — failed keywords (rate limits, API errors) are not charged.

---

Support

For support and questions:

• Email: contact@endspec.net
• Apify: Report issues through the Apify platform

If you need related TikTok data (user info, hashtag analytics, comment scraping, music search), reach out — we can build it.

---

Changelog

Version 1.0.0

• Initial release
• Multi-keyword batch search
• Automatic pagination up to 200 results per keyword
• Full video + author + music metadata
• Watermark-free video URLs
• Regional localization