TikTok Video Search Scraper

Search TikTok by keyword and export the matching videos -- IDs, captions, timestamps, engagement stats and music. Pagination is automatic.

Input

Field	Use it for
keyword	What to search for. Required.
region	Two-letter region code. Default US. Results differ by region.
maxItems	Caps the run. Default 100. Set 0 for no limit.
addonVideoDetails	Merges the full video-detail response into every row. One extra request per video.

{
  "keyword": "cold brew recipe",
  "region": "GB",
  "maxItems": 300
}

Output

One row per video.

Field	Contents
aweme_id	Video ID
description	Caption
create_time	Unix timestamp of posting
stats	Play, like, comment and share counts
music_info	The sound attached to the video

{
  "aweme_id": "7519023847562910733",
  "description": "the only cold brew ratio you need #coffee",
  "create_time": 1719830400,
  "stats": {
    "play_count": 892000,
    "digg_count": 71300,
    "comment_count": 1840,
    "share_count": 9220
  }
}

Region is not a filter

region changes which results TikTok serves, the way searching from a phone in that country would. It does not filter by where a video was posted, and it does not restrict results to that country's creators. Two runs with US and JP on the same keyword return different videos, and neither is a subset of the other.

If you need results from several markets, run the search once per region and keep the region alongside each row in your own pipeline -- it is not written into the output.

Questions

Why did I get fewer videos than maxItems? TikTok's search paginates with a cursor and stops issuing new ones well before most keywords are exhausted. The run ends when TikTok reports no more pages, returns an empty page, or repeats a cursor. A keyword with tens of thousands of videos will not return tens of thousands of rows.

Is addonVideoDetails worth turning on? It fires one extra request for every result -- 300 results means 300 extra requests. The base row already has the caption, timestamp, stats and music, so switch it on only when you need a field those do not cover.

Can I sort by newest or most viewed? No. The order is TikTok's own search ranking. Sort in your own tooling using create_time or stats after the run.

Does the keyword search hashtags too? It searches TikTok the way the app's search box does, which includes hashtag matches. For a specific hashtag's own metadata and top videos, the Hashtag Scraper is the direct route.

Related Actors

Actor	Purpose
TikTok User Search Scraper	Same idea, but returns accounts
TikTok Hashtag Scraper	One hashtag's stats and current top videos
Bulk TikTok Video Scraper	Full detail on specific videos you already identified