TikTok profile
/v1/tiktok/profileGet one TikTok creator's profile by handle — bio, follower, following, like and video counts, verified status and account creation time, exactly as TikTok publishes it.
data.userInfo carries user and stats; data.shareMeta carries the share card.
Pass the handle without the @; a leading one is stripped before the request is made,
so @tiktok and tiktok are one cached entry rather than two paid-for copies.
A handle that does not exist answers 502 extraction_empty and is not charged. TikTok
reports it as a success carrying statusCode: 10221 and no userInfo at all, so read
the status code rather than assuming a 200 means the account was found.
curl "https://api.socialpipe.dev/v1/tiktok/profile?username=tiktok" \ -H "Authorization: Bearer $SOCIALPIPE_KEY"Query Parameters
A TikTok handle, written without the @ — what TikTok calls a uniqueId, not the numeric id the payload also carries.
Max acceptable age of a cached result, in seconds. A lower value demands fresher data; it does not shorten what is stored.
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/tiktok/profile?username=string"{ "cache_age": 0, "cached": false, "credits_remaining": 0, "credits_used": 0, "data": {}, "schema_version": "2", "success": true, "took_ms": 0}