Get creator profile & account statistics
GET/v1/user/info10 Credits / request($1.00 / 1K requests)
Fetch a TikTok creator's public profile (data.user: id, uniqueId, nickname, secUid, verified, signature, avatars) and real-time counters (data.stats: followerCount, followingCount, heartCount, videoCount).
Query Parameters
unique_idstringrequiredCreator handle without
@, e.g.tiktokorkhaby.lame.Example:
tiktok
Example Request (cURL / Python / JavaScript)
curl "https://api.tiktokapi.io/v1/user/info?unique_id=tiktok" \
-H "x-api-key: tk_your_api_key"Live Response Preview
{
"code": 0,
"msg": "success",
"processed_time": 0.15,
"data": {}
}Response Fields
Success (code === 0). Charged according to the endpoint credit rate.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Example: 0 |
msg | string | Example: success |
processed_time | number | Example: 0.15 |
data | object |
Status Codes
- 200
- Success (
code === 0). Charged according to the endpoint credit rate. - 400
- Invalid parameters, or API key placed in the URL query string (not charged).
- 401
- Missing or invalid
x-api-keyheader (not charged). - 402
- Insufficient credit balance (not charged).
- 403
- Account disabled (not charged).
- 404
- Unknown endpoint or disabled unstable endpoint (not charged).
- 405
- Method not allowed — all
/v1/*data endpoints useGET(not charged). - 429
- Rate limit exceeded (not charged). Respect the
Retry-Afterheader. - 503
- Temporary upstream or gateway error (not charged). Retry with exponential backoff.