get_v3_user_by_username
Retrieve a TikTok profile by username when the v1 endpoint returns 404 ProfileUnavailable, including profiles not served on the web; returns the same response shape.
Instructions
Get a TikTok profile by username, including profiles TikTok does not serve on the web (the ones get_v1_user_by_username answers with 404 ProfileUnavailable). Use it as the fallback when the v1 tool fails; the response has the same shape. Live request to TikTok, billed as 1 request per call and 2-3 for a restored profile. (GET /v3/user/by/username)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"username": "<username>"
},
"name": "get_v3_user_by_username"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes |