TikTok profile API
A TikTok account's profile by username: name, bio, picture, followers, following, total likes, video count, the verified badge and the ids. A number is null when it is not exact.
GEThttps://storiesfly.com/api/v1/tiktok/user/profile- Price 1 request
- Answers up to 1 hour old
Parameters
All parameters go in the query string.
| Name | Type | Sent | Description |
|---|---|---|---|
username | string | required | TikTok username, or a profile link. A leading @ is ignored. |
Example request
Put your own key in the header, or in the apiKey option of the npm client.
curl "https://storiesfly.com/api/v1/tiktok/user/profile?username=khaby.lame" \
-H "X-Api-Key: sf_live_your_key"const res = await fetch(
"https://storiesfly.com/api/v1/tiktok/user/profile?username=khaby.lame",
{ headers: { "X-Api-Key": process.env.STORIESFLY_KEY } }
);
const data = await res.json();import os
import requests
r = requests.get(
"https://storiesfly.com/api/v1/tiktok/user/profile",
params={"username": "khaby.lame"},
headers={"X-Api-Key": os.environ["STORIESFLY_KEY"]},
)
data = r.json()Example response
{
"id": null,
"sec_uid": null,
"username": "khaby.lame",
"full_name": "Khabane lame",
"bio": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎",
"profile_pic_url": "https://p16-common.tiktokcdn.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.webp",
"followers": 162979750,
"following": null,
"likes": null,
"videos": null,
"verified": true,
"is_private": null
}A real answer, shortened: lists are cut to two items and long texts to 160 characters.
Price and freshness
A call takes 1 request. Free requests are spent first, then your balance. The pricing page has the rates.
Answers are kept for up to 1 hour. Asking again inside that time returns the same answer and takes 1 request again.
Errors
A failed call answers with an HTTP status and a body {error, code}. These are the codes this endpoint gives. Errors and what is charged covers all of them.
| Status | Code | When |
|---|---|---|
400 | bad_request | A parameter is missing or wrong. fields lists the names. Free. |
401 | unauthorized | The X-Api-Key header is missing or the key is wrong. Free. |
402 | credits_exhausted | The free requests and the balance are used up. Top up in the dashboard. Free. |
403 | telegram_required | The account behind the key is not linked to Telegram. The answer has a link_url to do it. Free. |
404 | not_found | The account does not exist. Charged like an answer. |
429 | rate_limited | More requests in a second than your level allows, more than this group can take at once, or more than 1,000 TikTok and download calls today. Wait for the Retry-After header. Free. |
500 | internal_error | A fault on our side. Retry shortly. Refunded. |
503 | upstream_unavailable | Our side failed or timed out. Retry shortly. Refunded. |
Questions about this endpoint
How do I name the account?
Send its username, with or without the @, or a profile link (tiktok.com/@name).
Why is a count null?
A count is given only when it is exact. Otherwise it is null, never a rounded figure such as 1.5M.
Are id and sec_uid always there?
No. They are null when the answer did not carry them. The username is always there.
Your first 100 requests are on us
Sign in with Telegram, create a key, call any endpoint. Top up only when you need more.