JustSERPDocs
TikTok

TikTok Profile

A public TikTok account, read as a visitor with no account and answered as the document: `profile`.

GET
/v1/tiktok/profile

A public TikTok account, read as a visitor with no account and answered as the document: profile. The counts (followers, following, hearts, posts) are the exact ones TikTok shows. is_business is TikTok's commerce-account flag and category its business category; created_at is the account's creation time, which TikTok leaves out for some accounts. The account's videos are tiktok_profile_videos. A username TikTok does not know is 404 profile_not_found. zero_retention is not handled.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
username*string

The account's username, with or without the @ (or the address of its profile).

Match^@?[a-zA-Z0-9_.]{1,24}$

Response Body

The profile, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The first keys of a document-form answer. Unlike DocumentHead there is no search_information unless the engine has one (there is none for the AI engines, Events, Events Details, Facebook, Tripadvisor Place, Trending Now and the Apple engines' places).

search_metadata*
search_parameters*

The parameters the search ran with, defaults filled in; engine is the engine's name.

search_information?
profile?
Example Request
curl -X GET 'https://api.justserp.com/v1/tiktok/profile?username=tiktok'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "profile": {    "id": "string",    "username": "string",    "link": "string",    "name": "string",    "bio": "string",    "avatar": "string",    "avatar_hd": "string",    "is_verified": true,    "is_private": true,    "is_business": true,    "posts": 0,    "followers": 0,    "following": 0,    "category": "string",    "bio_link": "string",    "hearts": 0,    "language": "string",    "created_at": "string"  }}