TikTok Search Scraper avatar

TikTok Search Scraper

Pricing

from $3.00 / 1,000 results

Go to Apify Store
TikTok Search Scraper

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

Crawler Bros

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

an hour ago

Last modified

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 statsV2 field 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 ID
  • postUrl — direct URL to the video
  • caption — full caption text
  • query — the search keyword that returned this post
  • rank — zero-based position in the search results for this query
  • searchType — always "general"
  • author.id — author's TikTok user ID
  • author.secUid — author's secondary unique ID
  • author.username — author handle
  • author.displayName — author display name
  • author.verified — whether the author is verified
  • author.avatarUrl — author profile image URL
  • likeCount — total likes
  • commentCount — total comments
  • shareCount — total shares
  • playCount — total plays/views
  • createTime — Unix timestamp of post creation
  • music.id — sound/music ID
  • music.title — sound title
  • music.authorName — sound creator name
  • music.original — whether it is an original sound
  • hashtags — array of hashtag names parsed from caption
  • mentions — array of @mention usernames parsed from caption
  • poi.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 pixels
  • video.height — video height in pixels
  • video.duration — video duration in seconds
  • video.playUrl — streamable video URL (expires)
  • video.cover — cover/thumbnail image URL
  • scrapedAt — ISO 8601 timestamp of when the record was collected

Input

FieldTypeDefaultDescription
queriesstring[]Search keywords or phrases to query TikTok for. Required.
maxResultsPerQueryinteger30Maximum number of video results to collect per query (1–500).
{
"queries": ["viral"],
"maxResultsPerQuery": 50
}

Example: multi-keyword brand research

{
"queries": ["nike running", "adidas shoes", "puma sports"],
"maxResultsPerQuery": 100
}
{
"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.

Build a complete TikTok data pipeline with our full suite:

ScraperURL
TikTok Post Scraperhttps://apify.com/crawlerbros/tiktok-post-scraper
TikTok Profile Scraperhttps://apify.com/crawlerbros/tiktok-profile-scraper
TikTok Comments Scraperhttps://apify.com/crawlerbros/tiktok-comments-scraper
TikTok Hashtag Scraperhttps://apify.com/crawlerbros/tiktok-hashtag-scraper
TikTok Music Scraperhttps://apify.com/crawlerbros/tiktok-music-scraper
TikTok Transcript Scraperhttps://apify.com/crawlerbros/tiktok-transcript-scraper
TikTok Followers Scraperhttps://apify.com/crawlerbros/tiktok-followers-scraper
TikTok Mention Scraperhttps://apify.com/crawlerbros/tiktok-mention-scraper
TikTok Profile Mention Scraperhttps://apify.com/crawlerbros/tiktok-profile-mention-scraper
TikTok Playlist Scraperhttps://apify.com/crawlerbros/tiktok-playlist-scraper
TikTok Explore Scraperhttps://apify.com/crawlerbros/tiktok-explore-scraper
TikTok For You Scraperhttps://apify.com/crawlerbros/tiktok-for-you-scraper
TikTok Downloaderhttps://apify.com/crawlerbros/tiktok-downloader-api
TikTok Ads Library Scraperhttps://apify.com/crawlerbros/tiktok-ads-library-scraper-pro
TikTok Top Ads Scraperhttps://apify.com/crawlerbros/tiktok-top-ads-scraper
TikTok Hashtag Trends Scraperhttps://apify.com/crawlerbros/tiktok-hashtag-trends-scraper
TikTok LIVE Scraperhttps://apify.com/crawlerbros/tiktok-live-scraper