Tracking emerging trends, competitor mentions, and user-generated content across social media is a constant challenge for marketers, brand managers, and research teams. TikTok drives viral culture and consumer behavior, but manually scrolling through search results to gather video links, creator details, and performance metrics is slow and impossible to scale.
When conducting brand audits or monitoring campaign hashtags, teams need structured data to evaluate what resonates with audiences. The tiktok-search-scraper actor on Apify provides an automated way to query TikTok's general search API and collect comprehensive video metadata without needing account credentials, session cookies, or proxy setups.
What is the TikTok Search Scraper?
The tiktok-search-scraper is a dedicated tool for extracting search result data from TikTok based on custom keywords or phrases. It automates pagination across search result pages, retrieving up to 500 results per query.
Instead of relying solely on basic metrics, the scraper extracts detailed engagement statistics, author profile snapshots, audio information, caption elements, technical video attributes, and location tags whenever available.
Key Data Fields Collected per Video
When the scraper runs, it returns rich datasets where empty fields are omitted. Key outputs include:
-
Core Post Data:
postId, directpostUrl, fullcaption,createTime(Unix timestamp),query, and the zero-basedrankposition in search results. -
Engagement Metrics:
playCount,likeCount,commentCount, andshareCount. These are sourced directly from TikTok'sstatsV2field to ensure accurate numbers even for high-performing posts exceeding standard integer limits. -
Author Information:
author.id,author.secUid,author.username,author.displayName,author.verified, andauthor.avatarUrl. -
Audio & Content Tags:
music.id,music.title,music.authorName,music.original, as well as parsedhashtagsandmentionsarrays from the caption. -
Location & Technical Specs: Point of Interest data (
poi.name,poi.address,poi.city,poi.country,poi.category), video dimensions (video.width,video.height),video.duration, expiring media links (video.playUrl,video.cover), and ascrapedAtISO timestamp.
Real-World Use Cases for Keyword-Based TikTok Scraping
Competitor and Brand Monitoring
Brand teams can pass multiple brand or product names as input to monitor sentiment, discover customer reviews, and identify unboxing videos. Sourcing both likeCount and commentCount lets analysts quickly spot which discussions are driving the most interactions.
Influencer Discovery in Niche Markets
Agencies can track specific lifestyle phrases or aesthetic queries (such as specific niche subcultures or product categories). The tool extracts creator handles via author.username and checks author.verified status, simplifying the process of building targeted creator outreach lists.
Local Trend and Event Tracking
When creators tag specific venues or event spaces, the scraper captures the poi object. PR and event teams can analyze localized engagement around specific venues, cities, or categories like restaurants and retail spaces.
How to Set Up and Run the Scraper
Getting structured TikTok data takes just a few steps using the actor's input schema:
-
Define Your Search Terms: Set the
queriesparameter with an array of search strings. You can use standard keywords likenike runningor query creator mentions using@usernamesyntax. -
Set Result Limits: Configure
maxResultsPerQueryto define how many results to return per query (accepts values between 1 and 500, with a default of 30). - Run the Actor: Execute the run in the Apify Console or trigger it via the Apify API. The scraper accesses TikTok's public search API anonymously, so no login or cookies are needed.
- Export Your Data: Download the extracted records in formats like JSON, CSV, or Excel for analysis in your data pipeline.
Input Configuration Examples
For tracking brand competitors across multiple terms:
{ "queries": ["nike running", "adidas shoes", "puma sports"], "maxResultsPerQuery": 100 }
For discovering content around a specific creator mention:
{ "queries": ["@natgeo"], "maxResultsPerQuery": 30 }
Frequently Asked Questions
Do I need a proxy or authenticated TikTok account?
No. The actor accesses TikTok's public search API available to anonymous users. No TikTok account, login cookies, or custom proxies are required to run it.
How many results can I expect per query?
You can request up to 500 results per query using maxResultsPerQuery. However, TikTok search maintains a finite result pool per keyword (typically between 50 and 200 unique videos). If TikTok indicates there are no more results (has_more: false), the scraper stops pagination automatically.
Are video download URLs permanent?
No. TikTok CDN URLs—including video.playUrl and video.cover—are signed links that expire, typically within 24 hours. If your workflow requires permanent references, rely on postUrl or download and store the media files promptly after scraping.
Ready to try it yourself? Run *TikTok Search Scraper** on the Apify Store -- no setup required.*
Top comments (0)