TikTok Search Scraper
Pricing
from $3.00 / 1,000 results
TikTok Search Scraper
Scrape TikTok videos by keyword search. Extract full video metadata, author info, music, stats, and location data from TikTok search results. No cookies required.
Pricing
from $3.00 / 1,000 results
Rating
0.0
(0)
Developer
Crawler Bros
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
an hour ago
Last modified
Categories
Share
Search TikTok by keyword or phrase and collect full video metadata for each result. The actor uses TikTok's general search API and returns up to 500 results per query — including engagement stats, author profiles, music details, hashtags, mentions, and optional location tags (POI). No login, cookies, or proxy required.
What this actor does
- Accepts one or more search keywords or phrases and paginates through all result pages
- Returns full post metadata for each video: caption, creation date, rank in results, and direct post URL
- Captures engagement stats (views, likes, comments, shares) sourced from TikTok's
statsV2field for accuracy on large accounts - Extracts author profile snapshot including username, display name, verification status, and avatar
- Parses hashtags and @mentions directly from the post caption
- Attaches music metadata (title, artist, original flag) and video technical details (resolution, duration)
- Includes Point of Interest (POI) location data when the creator tagged a place
- Empty fields are omitted
Output per video
postId— unique TikTok video IDpostUrl— direct URL to the videocaption— full caption textquery— the search keyword that returned this postrank— zero-based position in the search results for this querysearchType— always"general"author.id— author's TikTok user IDauthor.secUid— author's secondary unique IDauthor.username— author handleauthor.displayName— author display nameauthor.verified— whether the author is verifiedauthor.avatarUrl— author profile image URLlikeCount— total likescommentCount— total commentsshareCount— total sharesplayCount— total plays/viewscreateTime— Unix timestamp of post creationmusic.id— sound/music IDmusic.title— sound titlemusic.authorName— sound creator namemusic.original— whether it is an original soundhashtags— array of hashtag names parsed from captionmentions— array of @mention usernames parsed from captionpoi.name— location name (when present)poi.address— location address (when present)poi.city— city of the location (when present)poi.country— country code of the location (when present)poi.category— place category, e.g. Restaurant (when present)video.width— video width in pixelsvideo.height— video height in pixelsvideo.duration— video duration in secondsvideo.playUrl— streamable video URL (expires)video.cover— cover/thumbnail image URLscrapedAt— ISO 8601 timestamp of when the record was collected
Input
| Field | Type | Default | Description |
|---|---|---|---|
queries | string[] | — | Search keywords or phrases to query TikTok for. Required. |
maxResultsPerQuery | integer | 30 | Maximum number of video results to collect per query (1–500). |
Example: trending keyword search
{"queries": ["viral"],"maxResultsPerQuery": 50}
Example: multi-keyword brand research
{"queries": ["nike running", "adidas shoes", "puma sports"],"maxResultsPerQuery": 100}
Example: creator mention search
{"queries": ["@natgeo"],"maxResultsPerQuery": 30}
Example: niche trend discovery
{"queries": ["cottagecore aesthetic", "dark academia"],"maxResultsPerQuery": 200}
Use cases
- Content researchers finding trending videos on any topic to inform editorial calendars
- Brand teams monitoring mentions of their product or competitor names across TikTok
- Influencer agencies discovering creators in niche categories via keyword search
- PR and comms teams tracking buzz around a product launch, event hashtag, or campaign
- Academic researchers building video datasets for studying TikTok content patterns
- E-commerce analysts identifying UGC and product reviews relevant to a category
FAQ
Q: Do I need a TikTok account, cookies, or a proxy?
A: No. The actor uses TikTok's public search API accessible to anonymous visitors. No authentication or proxy is required.
Q: What is the statsV2 field and why does it matter?
A: TikTok's standard integer stats overflow at approximately 2 billion (signed 32-bit limit). The statsV2 field stores counts as strings, providing accurate numbers for large creators. The actor always reads from statsV2 first.
Q: Are video and cover image URLs permanent?
A: No. TikTok's CDN URLs are signed and expire, typically within 24 hours. Use postUrl as the stable reference to the video. Download or cache media promptly after scraping.
Q: Can I search for a specific creator's content?
A: Use @username as a query (e.g. @khaby.lame). Results include posts that mention that creator, though it is not equivalent to fetching their profile feed directly.
Q: What is the poi field?
A: Point of Interest — the location tag a creator attaches to a post. It only appears when the creator tagged a specific place. It includes name, city, country, and category.
Q: How many results can I get per query?
A: Up to 500. TikTok returns approximately 12 results per search page and the actor paginates automatically until the limit or has_more: false is reached.
Q: Why might I get fewer results than my maxResultsPerQuery setting?
A: TikTok search has a finite result pool per query, typically 50–200 unique videos. Once TikTok signals no more results, the actor stops regardless of the limit.
Q: Can I search in a specific language or country?
A: Queries can be in any language. The results reflect TikTok's global index for that keyword. Region targeting is not currently supported as a direct input parameter.
Related TikTok Scrapers
Build a complete TikTok data pipeline with our full suite: