Retrieve TikTok user basic
Retrieve basic public profile info (avatars, nickname, region) for a TikTok user by their unique ID (handle). Works for 18+ accounts & private accounts.
Path Parameters
The unique ID (handle) of the TikTok user.
Header Parameters
Where a scraped image URL should be served from. Selected per-request via the x-image-source header. Defaults to {@link RouteImageSource.ORIGIN}.
Responses
Retrieve TikTok user info
Retrieve profile info (avatars, follow counts, verification) for a TikTok user by their numeric user ID.
Path Parameters
The numeric TikTok user ID.
Header Parameters
Where a scraped image URL should be served from. Selected per-request via the x-image-source header. Defaults to {@link RouteImageSource.ORIGIN}.
Responses
Cleaned user profile (deprecated/null/empty fields + author_stats removed). The listed fields are the stable, useful ones; the index signature covers the remaining non-empty fields TikTok returns.
Search TikTok users catalog
Search the TikTok users catalog: every user our pipelines have recorded, matched on ONE field chosen by match: the handle (unique_id, the default) or the display name (nickname). A search never matches the other field.
The match is a case-insensitive substring match served by the catalog's trigram index, so the query must be at least 3 characters. Results are ranked exact match first, then prefix match, then substring match; ties go to the higher follower count, then to the more recently updated record. At most 10 users are returned.
This is a special route, it does NOT fetch data live, and therefore does not count to your hourly/daily rate limits.
Query Parameters
The handle or display name text to search for: 3 to 256 characters.
The one field a users-catalog search is matched against: unique_id (the handle, the default) or nickname (the display name). A search never matches the other field.
Responses
Retrieve TikTok users catalog username
Look a handle (unique_id) up in the TikTok users catalog: the user who most recently held it, from any record our pipelines have stored, however old.
The handle is matched exactly after normalization (a leading @ and letter case are ignored). A handle the catalog has never seen answers 404; use the live user routes to resolve it from TikTok.
This is a special route, it does NOT fetch data live, and therefore does not count to your hourly/daily rate limits.
Path Parameters
The unique ID (handle) of the TikTok user.
Responses
Retrieve TikTok users catalog numeric ID
Look a numeric TikTok user ID up in the TikTok users catalog, from any record our pipelines have stored, however old.
An ID the catalog has never seen answers 404; use the live user routes to resolve it from TikTok.
This is a special route, it does NOT fetch data live, and therefore does not count to your hourly/daily rate limits.
Path Parameters
The numeric ID of the TikTok user (e.g. 7602356191083907865).