TikTok Search Scraper - Videos and Users

Overview

The TikTok Search Scraper is a powerful data extraction tool that enables you to search TikTok for videos, users, and hashtags using keyword queries. It automates the process of searching TikTok's platform and collecting structured data from the results, saving you from manual browsing and data collection. Whether you are performing market research, tracking content trends, or analyzing competitor strategies on TikTok, this actor provides a reliable and automated solution.

Key Features

This actor provides comprehensive TikTok search capabilities including searching for videos by keywords, finding user profiles matching your query, and discovering relevant hashtags and challenges. It supports multiple search types: general search that returns all result types, or focused searches for videos only, users only, or hashtags only. The scraper implements pagination to retrieve large result sets beyond the initial page of results.

How It Works

The scraper uses a multi-strategy approach to extract search results from TikTok. It first attempts to use TikTok's internal search API endpoint to retrieve structured JSON data directly. If the API approach encounters limitations, it falls back to fetching the search results page and parsing embedded data from the page's JavaScript state. As a third fallback, it parses the rendered HTML using cheerio selectors to extract result cards. This layered approach maximizes reliability across different access conditions.

Input Configuration

The actor accepts the following input parameters to customize your search:

• searchQueries: An array of keyword strings to search for on TikTok. You can provide multiple queries to search for in a single run, such as ["cooking recipes", "travel vlog", "tech review"].
• searchType: Choose between "general" (all result types), "video" (videos only), "user" (user profiles only), or "hashtag" (hashtags only). Defaults to general.
• maxResults: The maximum number of results to collect per search query. Ranges from 1 to 500, with a default of 50.
• proxyConfiguration: Optional proxy settings to help avoid rate limiting. Residential proxies are recommended for best results with TikTok.

Output Data

Each result in the output dataset includes the following fields depending on the result type: type (video, user, or hashtag), id, description, author username, author nickname, play count, likes count, comments count, shares count, follower count for users, hashtag name and view count for hashtags, video URL, cover image URL, music title, the original search query, and a timestamp of when the data was scraped.

Usage Tips

For best results with TikTok scraping, consider using residential proxies as TikTok actively blocks datacenter IP addresses. Start with smaller result counts to test your configuration before scaling up. The actor handles deduplication automatically, ensuring you receive unique results even when the same content appears across multiple API responses or page loads. TikTok's anti-bot measures may limit result availability in some regions, so proxy rotation is strongly recommended for production use cases.

Integrations

The scraped data can be exported in JSON, CSV, XML, or Excel formats. You can integrate this actor with other Apify actors, webhooks, or external tools via the Apify API. Schedule regular runs to track search trends over time or trigger runs programmatically based on your application needs.