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.
| Endpoint | What it returns | Credits/call | USD/call (Freelance plan) |
|---|---|---|---|
/v1/tiktok/user | Profile | 1 | $0.0017 |
/v1/tiktok/user_region | Profile Region | 1 | $0.0017 |
/v1/tiktok/user_audience | User's Audience Demographics | 26 | $0.0433 |
/v1/tiktok/user_showcase | User Showcase | 1 | $0.0017 |
/v1/tiktok/userProfile 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.
| Parameter | Type | Required | Description |
|---|---|---|---|
handle | string | no | TikTok handle. You can pass handle or user_id. |
user_id | string | no | TikTok user id. |
cache_max_age | string | no | If 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_regionProfile Region 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.
| Parameter | Type | Required | Description |
|---|---|---|---|
handle | string | yes | TikTok handle |
/v1/tiktok/user_audienceUser's Audience Demographics 1,000 calls = 26,000 credits = $43.33 on the Freelance plan.
| Parameter | Type | Required | Description |
|---|---|---|---|
handle | string | yes | TikTok handle |
/v1/tiktok/user_showcaseUser Showcase 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.
| Parameter | Type | Required | Description |
|---|---|---|---|
handle | string | yes | The handle of the user |
region | string | no | Region 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_cursor | string | no | The cursor to the next page of products |
curl -H "X-Scapi-Key: $SCAPI_KEY" "https://api.scrapall.bipsport.com/scapi/v1/tiktok/user"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())No. These endpoints return public profile data with one Scrapall API key header. There is no academic application, approval wait or TikTok login.
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.
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.
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.
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.
Full reference: all tiktok endpoints.