Retrieve TikTok user basic

GEThttps://api.eulerstream.com/tiktok/users/{unique_id}/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

unique_id*string

The unique ID (handle) of the TikTok user.

Header Parameters

x-image-sourceenum

Where a scraped image URL should be served from. Selected per-request via the x-image-source header. Defaults to {@link RouteImageSource.ORIGIN}.

Responses

code*number (double)
messagestring
userobject
Response200

Retrieve TikTok user info

GEThttps://api.eulerstream.com/tiktok/users/{numeric_id}

Retrieve profile info (avatars, follow counts, verification) for a TikTok user by their numeric user ID.

Path Parameters

numeric_id*string

The numeric TikTok user ID.

Header Parameters

x-image-sourceenum

Where a scraped image URL should be served from. Selected per-request via the x-image-source header. Defaults to {@link RouteImageSource.ORIGIN}.

Responses

code*number (double)
messagestring
userobject

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.

Response200

Search TikTok users catalog

POSThttps://api.eulerstream.com/tiktok/users/catalog/search

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

query*string

The handle or display name text to search for: 3 to 256 characters.

matchenum

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

code*number (double)
messagestring
users*object[]
Response200

Retrieve TikTok users catalog username

GEThttps://api.eulerstream.com/tiktok/users/catalog/usernames/{unique_id}

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

unique_id*string

The unique ID (handle) of the TikTok user.

Responses

code*number (double)
messagestring
userobject
Response200

Retrieve TikTok users catalog numeric ID

GEThttps://api.eulerstream.com/tiktok/users/catalog/numeric_ids/{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

numeric_id*string

The numeric ID of the TikTok user (e.g. 7602356191083907865).

Responses

code*number (double)
messagestring
userobject
Response200