GET/v1/tiktok/user/profile
Get TikTok profile data
Retrieve a TikTok profile: display name, follower/following counts, total likes, and post count.
Parameters
| Name | Type | Description |
|---|---|---|
| usernamerequired | string | TikTok username (without the `@`) e.g. claudeai |
Request
Shell
curl -G "https://socialapi.airaa.xyz/v1/tiktok/user/profile" \ -H "X-API-KEY: YOUR_KEY" \ -d "username=claudeai"
Try it
Live requestRelayed through this site — your key is never stored
X-API-KEY
usernamerequired
Response example
200 OKapplication/json
{
"user": {
"id": "7589841252687447054",
"username": "claudeai",
"display_name": "Claude",
"profile_url": "https://www.tiktok.com/@claudeai",
"profile_picture_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/31ec.jpeg",
"is_private": false,
"is_verified": false,
"follower_count": 20,
"following_count": 0,
"like_count": 0,
"post_count": 0
}
}Response codes
200Profile data
400Missing or invalid query parameter
401Missing or invalid `X-API-KEY` header
429Request quota exceeded — contact light@airaa.xyz to upgrade your plan
500Server misconfiguration — API key environment variable not set
502Upstream provider temporarily unavailable — please try again
504Request timed out — please try again
All error responses follow the shape
{ "error": "message" }