Skip to main content
Use POST /web/scrape with formats.parse: true and parseParams: {"type": "prebuilt", "parser": "tiktok-followers"} for a profile’s followers, or "parser": "tiktok-following" for the accounts it follows. Read the result in parsed.data, with parsed.type set to the parser name. See the Quickstart for authentication and SDK setup. Don’t send custom rules with these parsers. For CSS selectors and rules, use the Custom parser.

​
Request

Use a profile URL, tiktok.com/@{username}. Query parameters are ignored.

​
Output

When parsed.success is true, the parsed output has this shape:
Each account has the same fields as the TikTok profile parser. Up to 30 accounts are returned, from the first page of the list.

​
Empty results and errors

A profile with no followers or followed accounts returns users: []. A nonexistent profile produces NOT_FOUND. Read parsed.success before using the data. A failed parse has data: null and can coexist with successful outputs. parsed.type remains the requested parser name even when parsing fails. See timeouts and errors for handling failures.

​
Request options

These parsers read public TikTok data separately from the rendered page, without logging in. Content filters and browser actions do not change their results. Browser profiles are unsupported with these parsers. Other Scrape controls, including caching, timeouts, and zero data retention, still apply.