TikTok Profile API: public user, region and audience data as JSON

Send a TikTok handle and get the public profile back as JSON: follower and like counts, bio, region and showcase items, plus an audience report for creator vetting. You do not need TikTok Research API access or your own scraper with rotating proxies.

Buy credits

Use cases

Endpoints and cost

EndpointWhat it returnsCredits/callUSD/call (Freelance plan)
/v1/tiktok/userProfile1$0.0017
/v1/tiktok/user_regionProfile Region1$0.0017
/v1/tiktok/user_audienceUser's Audience Demographics26$0.0433
/v1/tiktok/user_showcaseUser Showcase1$0.0017

Endpoint details

/v1/tiktok/user

Profile 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.

ParameterTypeRequiredDescription
handlestringnoTikTok handle. You can pass handle or user_id.
user_idstringnoTikTok user id.
cache_max_agestringnoIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp).

Sample response (trimmed):

{
 "user": {
  "id": "6659752019493208069",
  "short_user_id": "",
  "username": "stoolpresidente",
  "display_name": "Dave Portnoy",
  "avatar_large": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=58494&refresh_token=466ff0b92ed2f51170dbbdc2a...",
  "avatar_medium": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~c5_720x720.jpeg?lk3s=a5d48078&nonce=18587&refresh_token=4c5e30ff3fe99ca813d9f79d74c...",
  "avatar_small": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~c5_100x100.jpeg?lk3s=a5d48078&nonce=56685&refresh_token=52483b418cbeceeaf2863a9fe0f...",
  "bio": "El Presidente/Barstool Sports Founder.",
  "created_at": 1550594547,
  "verified": true,
  "secure_user_id": "MS4wLjABAAAAINC_ElRR-l1RCcnEjOZhNO-9wOzAMf-YHXqRY8vvG9bEhMRa6iu23TaE3JPZYXBD",
  "ftc": false,
  "relation": 0,
  "open_favorite": false,
  "bio_link": {
   "link": "https://www.barstoolsports.com/bios/Surviving-Barstool",
   "risk": 0
  },
  "comment_setting": 0,
  "commerce_user_info": {
   "commerce_user": false
  },
  "duet_setting": 0,
  "stitch_setting": 0,
  "private_account": false,
  "secret": false,
  "is_ad_virtual": false,
  "room_id": "",
  "unique_id_modify_time": 0,
  "tt_seller": false,
  "...": "13 more fields"
 },
 "stats": {
  "followers": 4100000,
  "following": 74,
  "hea

/v1/tiktok/user_region

Profile Region 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.

ParameterTypeRequiredDescription
handlestringyesTikTok handle

/v1/tiktok/user_audience

User's Audience Demographics 1,000 calls = 26,000 credits = $43.33 on the Freelance plan.

ParameterTypeRequiredDescription
handlestringyesTikTok handle

/v1/tiktok/user_showcase

User Showcase 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.

ParameterTypeRequiredDescription
handlestringyesThe handle of the user
regionstringnoRegion to put the proxy in. Non-US TikTok Shop regions are not reliable right now and may return limited or inconsistent showcase data. Sorry for the inconvenie
next_cursorstringnoThe cursor to the next page of products

Example: curl

curl -H "X-Scapi-Key: $SCAPI_KEY" "https://api.scrapall.bipsport.com/scapi/v1/tiktok/user"

Example: Python

import os, requests
r = requests.get("https://api.scrapall.bipsport.com/scapi/v1/tiktok/user",
    headers={"X-Scapi-Key": os.environ["SCAPI_KEY"]})
print(r.json())

FAQ

Do I need TikTok Research API access?

No. These endpoints return public profile data with one Scrapall API key header. There is no academic application, approval wait or TikTok login.

Is this a replacement for an Apify TikTok profile scraper?

It covers the same job with a simple REST call: you send a handle and get JSON back, and you pay per successful call instead of per actor run or compute unit.

What is in the audience report?

The audience endpoint returns aggregate audience data for a public creator. Check the sample response on this page for the exact fields before you build on them.

How do I pay and get my API key?

Open the Buy page, pick the Freelance plan and pay in USDT on TRC20 or ERC20. The key is shown once, right after the payment is confirmed on-chain.

How many credits does one call use?

The cost table on this page lists credits per call for each endpoint. The Freelance plan is $45 for 27,000 credits per 30 days.

Get an API key and credits

Full reference: all tiktok endpoints.