tiktok/creator/account-health-status

Get Creator Account Health Status

Purpose:

• Retrieve the health status of a TikTok Shop creator account, including the health score over the past 90 days and the current number of accumulated violation points.
• About violation points:
  • Violation points are key metrics used by TikTok to measure the health of a creator account.
  • Higher violation points indicate worse account health, and may lead to restrictions such as reduced exposure, suspension, or account bans.
  • Violation points directly impact the account’s visibility and recommendation on the platform.

Punishment Levels for Accumulated Violation Points:

Score Range	Punishment Measures	Duration
9-11	Warning	None
12-14	E-commerce permissions suspended (video, live, product showcase)	24 hours
15-17	E-commerce permissions suspended	48 hours
18-20	E-commerce permissions suspended	72 hours
21-23	E-commerce permissions suspended	1 week
24+	Permanent removal of e-commerce permissions and banning of TikTok Shop creator account	Permanently disabled

Notes:

• This API is only applicable to TikTok Shop creator accounts.

Parameters:

• cookie: User Cookie string for authentication
• proxy: Optional HTTP proxy address, can be omitted if not needed
  • Example format: http://username:password@host:port

Response:

• risk_info: Account health status:
  • risk_level_text: Current health level description (e.g., Healthy)
  • light_color: Light color code for health level display (RGBA format)
  • dark_color: Dark color code for health level display (RGBA format)
• vio_score_rule_learn_url: URL to learn more about violation point rules
• is_show_score: Whether to display violation points (boolean)
• violation_score: Current violation score
• creator_status: Creator account status code (0 = normal)

[Example]

payload = {
    "cookie": "your_cookie"
}

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.