Skip to main content
Use POST /web/scrape with formats.parse: true and parseParams: {"type": "prebuilt", "parser": "tiktok-user-search"}. Read the result in parsed.data, with parsed.type set to "tiktok-user-search". See the Quickstart for authentication and SDK setup. Don’t send custom rules with this parser. For CSS selectors and rules, use the Custom parser.

Request

Use a user search URL, tiktok.com/search/user?q={query}, with a non-empty q. For videos that match a query, use TikTok feed with a tiktok.com/search?q={query} URL.

Output

When parsed.success is true, the parsed output has this shape:

User fields

Up to 10 accounts are returned, in TikTok’s ranking. like_count is the total likes across the account’s videos, and sec_uid is TikTok’s stable profile identifier. For full profile fields, pass tiktok.com/@{username} to TikTok profile.

Empty results and errors

A query with no matching accounts returns users: []. Read parsed.success before using the data. A failed parse has data: null and can coexist with successful outputs. parsed.type remains "tiktok-user-search" even when parsing fails. See timeouts and errors for handling failures.

Request options

This parser reads public TikTok data separately from the rendered page, without logging in. Content filters and browser actions do not change its results. Browser profiles are unsupported with this parser. Other Scrape controls, including caching, timeouts, and zero data retention, still apply.