/v1/tiktok/profile

GET

Profile

Scrapes a public TikTok profile

Credit cost	Default: 1 credit when no rule matches. 1 credit when the response outcome is absent. How charges are determined Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.
Cache support	Use a cached response this old or newer for 0 credits. If none is available, fetch live at the endpoint’s normal price.
Pagination	No explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

Name	Location / required	Schema
`handle` TikTok handle. You can pass handle or user_id.	query / optional	`string`
`user_id` TikTok user id.	query / optional	`string`
`cache_max_age` Use a cached response this old or newer for 0 credits. If none is available, fetch live at the endpoint’s normal price.	query / optional	`string` Allowed values `["1d","3d","7d","14d","30d"]`

Request examples

Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.

cURL

curl --request GET 'https://api.fetchproof.com/v1/tiktok/profile' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/tiktok/profile", {
  method: 'GET',
  headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());

Python

import os
import requests

response = requests.get("https://api.fetchproof.com/v1/tiktok/profile",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)

Responses

200Success. Envelope: success / credits_remaining / credits_charged.

application/json

object

successrequired

boolean

credits_remainingrequired

integer

credits_chargedrequired

integer

userrequired

object

idrequired

string

shortIdrequired

string

uniqueIdrequired

string

nicknamerequired

string

avatarLargerrequired

string

avatarMediumrequired

string

avatarThumbrequired

string

signaturerequired

string

createTimerequired

integer

verifiedrequired

boolean

secUidrequired

string

ftcrequired

boolean

relationrequired

integer

openFavoriterequired

boolean

bioLinkrequired

object

linkrequired

string

riskrequired

integer

commentSettingrequired

integer

commerceUserInforequired

object

commerceUserrequired

boolean

duetSettingrequired

integer

stitchSettingrequired

integer

privateAccountrequired

boolean

secretrequired

boolean

isADVirtualrequired

boolean

roomIdrequired

string

uniqueIdModifyTimerequired

integer

ttSellerrequired

boolean

downloadSettingrequired

integer

profileTabrequired

object

showMusicTabrequired

boolean

showQuestionTabrequired

boolean

showPlayListTabrequired

boolean

followingVisibilityrequired

integer

recommendReasonrequired

string

nowInvitationCardUrlrequired

string

nickNameModifyTimerequired

integer

isEmbedBannedrequired

boolean

canExpPlaylistrequired

boolean

profileEmbedPermissionrequired

integer

languagerequired

string

eventListrequired

array

suggestAccountBindrequired

boolean

isOrganizationrequired

integer

UserStoryStatusoptional

integer

shortDramaCreatoroptional

object

statsrequired

object

followerCountrequired

integer

followingCountrequired

integer

heartrequired

integer

heartCountrequired

integer

videoCountrequired

integer

diggCountrequired

integer

friendCountrequired

integer

itemListrequired

array

cachedoptional

boolean

cached_atoptional

string

{
  "format": "date-time"
}

statsV2optional

object

followerCountrequired

string

followingCountrequired

string

heartrequired

string

heartCountrequired

string

videoCountrequired

string

diggCountrequired

string

friendCountrequired

string

401Invalid or missing x-api-key

402No credits remaining

403Upstream denied (age gate, audience controls)

404Resource or endpoint not found

429Rate limited