Profile
A profile's card: name, bio, followers, likes and video count. A private account's card too, with private true; its videos aren't public.
GET/v1/tiktok/profile1 creditHeaders
Get your API keyx-api-key*stringrequiredheaderYour API key, made in the dashboard.
Parameters
2handlestringoptionalqueryA TikTok handle, with or without the @. Give handle or url.
example: mrbeast
urlstringoptionalqueryA profile's link: tiktok.com/@handle, with anything after it. Give handle or url.
max 300 chars
Response fields
25dataobjectThe result: one object, or a list for the endpoints that return several.
data.idstringThe user's id: digits.
data.sec_uidstringnullableTikTok's other id for the user, a long text.
data.handlestringTheir handle, without the @.
data.urlstringTheir profile's link.
data.namestringnullableTheir name.
data.biostringnullableTheir bio.
data.avatarstringnullableTheir profile picture's link.
data.verifiedbooleannullableWhether they are verified.
data.privatebooleannullableWhether the account is private: its videos are for its followers only.
data.followersintegernullableFollowers.
data.followingintegernullableAccounts they follow.
data.likesintegernullableLikes their videos have had: rounded (1.5B is 1500000000) for most accounts. Null without public videos.
data.videosintegernullableVideos and photo posts they have posted. Null without public videos.
pageobjectnullablePaging, for the endpoints that page; null for the others.
page.next_cursorstringnullableSend it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.
page.has_morebooleanoptionalWhether another page follows.
default: false
metaobjectAbout this call.
meta.platformstringThe platform: reddit, threads, tiktok or youtube.
meta.endpointstringThe endpoint's name, such as channel_videos.
meta.paramsobjectThe call's parameters, defaults included. Parameters without a value, and the cursor, are left out.
meta.request_idstringThis call's id. Quote it when you report a problem.
meta.api_versionstringThe API version that answered.
meta.fetched_atstringWhen the data was fetched from the platform (UTC).
format: date-time
meta.cachedbooleanoptionalWhether it came from our cache; fetched_at says how old it is.
default: false
Code example
curl -X GET 'https://api.socialparse.dev/v1/tiktok/profile?handle=mrbeast' \ -H 'x-api-key: YOUR_API_KEY'Responses
Successful Response
{ "data": { "id": "string", "sec_uid": "string", "handle": "string", "url": "string", "name": "string", "bio": "string", "avatar": "string", "verified": true, "private": true, "followers": 0, "following": 0, "likes": 0, "videos": 0 }, "page": { "next_cursor": "string", "has_more": false }, "meta": { "platform": "string", "endpoint": "string", "params": { "property1": "string", "property2": "string" }, "request_id": "string", "api_version": "string", "fetched_at": "2019-08-24T14:15:22Z", "cached": false }}