Search TikTok videos
TL;DR
About
Scroll TikTok search for a keyword and fifty videos later you still cannot say how many went up this month or which ones passed a million plays. Give it a keyword such as "cottage cheese ice cream" and a count, 30 by default and 300 at most, and you get back each video's caption, creator handle, post time, and its play, like, comment, share and save counts. A food brand checking whether a trend still has legs can pull 200 results, sort them by post time and see whether last week's videos still clear 100k plays before briefing creators. Results follow TikTok's own ranking, there is no date or region filter, and no video URL is returned, though the creator handle and video id are enough to rebuild one. It runs against a signed-in TikTok session, and a burst of runs can hit an empty response when TikTok rate limits the account.
Input
query requiredSearch keyword(s).
count optionalTarget number of videos to collect. The script pages the search feed until this many are gathered or results run out.
Default: 30Output
query requiredvideos requiredhasMore requiredExample output
Shape only: placeholder values generated from the output schema, not a real run.
{
"query": "…",
"videos": [
{
"id": "abc123",
"desc": "…",
"cover": "…",
"music": "…",
"stats": {
"diggCount": 3.5,
"playCount": 3.5,
"shareCount": 3.5,
"repostCount": 3.5,
"collectCount": 3.5,
"commentCount": 3.5
},
"author": {
"id": "abc123",
"secUid": "…",
"nickname": "…",
"uniqueId": "abc123",
"verified": true
},
"duration": 3.5,
"createTime": 3
}
],
"hasMore": true
}FAQ
Get TikTok following
List who a TikTok user follows, by @username. Accounts that keep their following list hidden, and private accounts, are reported with a clear reason instead of an empty or partial list; a handle nobody owns is reported as such. For third-party accounts, TikTok caps the list and pads short ones with suggested accounts, so check `total` and `truncated`; results are only fully reliable for accounts you can see in full, such as your own.
Search TikTok users
Search TikTok accounts by keyword. Returns the top ~10 matches (TikTok web caps user search; not deeply paginable).
Get TikTok user videos
List a TikTok user's videos (newest first) by @username, up to `count`.