--- title: "获取创作者账号健康状态/Get Creator Account Health Status" method: POST path: "/api/v1/tiktok/creator/get_account_health_status" tags: ["TikTok-Creator-API"] --- # 获取创作者账号健康状态/Get Creator Account Health Status `POST /api/v1/tiktok/creator/get_account_health_status` ## Request - Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.tikhub.io/api/v1/tiktok/creator/get_account_health_status` - Auth: HTTP bearer # [中文] ### 用途: - 获取 TikTok Shop 创作者账号的健康状况信息，包括过去 90 天内的健康评分（风险等级）以及当前累计的违规积分数量。 - 关于违规积分： - 违规积分是 TikTok 用于衡量账号健康状况的重要指标。 - 违规积分越高，账号健康状况越差，可能面临限流、禁播、封禁等处罚。 - 违规积分将直接影响账号的曝光量和推荐量。 ### 累计违规积分对应的惩罚等级： | 分数范围 | 惩罚措施 | 惩罚时长 | | --------- | --------------------------------------------------------- | -------- | | 9-11 | 警告（Warning） | 无 | | 12-14 | 暂停电商权限（视频、直播、商品展示功能） | 24 小时 | | 15-17 | 暂停电商权限 | 48 小时 | | 18-20 | 暂停电商权限 | 72 小时 | | 21-23 | 暂停电商权限 | 1 周 | | 24 及以上 | 永久移除电商权限，封禁 TikTok Shop 创作者账号 | 永久禁用 | ### 备注: - 此接口仅适用于已开通 TikTok Shop 的创作者账号。 ### 参数: - cookie: 用户 Cookie 字符串（用于身份认证） - proxy: 可选 HTTP 代理地址，如不使用可省略 - 示例格式: `http://username:password@host:port` ### 返回: - `risk_info`（健康状态信息）: - `risk_level_text`: 当前风险等级描述（如 Healthy） - `light_color`: 健康状态浅色展示色值（rgba 格式） - `dark_color`: 健康状态深色展示色值（rgba 格式） - `vio_score_rule_learn_url`: 查看违规积分规则说明的链接 - `is_show_score`: 是否展示违规积分（布尔值） - `violation_score`: 当前违规积分数量 - `creator_status`: 创作者账号状态码（0=正常） # [English] ### 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] ```json payload = { "cookie": "your_cookie" } ## Request body - GetAccountHealthRequest - `cookie` string: 用户 Cookie 字符串/User Cookie String - `proxy` string, nullable: 可选 HTTP 代理地址/Optional HTTP Proxy Address ## Response `200` Successful Response - ResponseModel - `code` integer: HTTP status code | HTTP状态码 - `request_id` string, nullable: Unique request identifier | 唯一请求标识符 - `message` string: Response message (EN-US) | 响应消息 (English) - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文) - `support` string: Support message | 支持消息 - `time` string: The time the response was generated | 生成响应的时间 - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳 - `time_zone` string: The timezone of the response time | 响应时间的时区 - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接 - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English) - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文) - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL - `router` string: The endpoint that generated this response | 生成此响应的端点 - `params` unknown - `data` unknown ## Other responses - `422`: Validation Error ## Changes - **2026-10-08** `96a122a5f220`: 2 info - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - **2026-09-01** `50f9ec6e1cd3`: 2 info - the `cache_message` response's property default value changed from `This request will be cached. You can access the cached result directly using the URL below, valid for 24 hours. Accessing the cache will not incur additional charges.` to `This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.` for the status `200` - the `cache_message_zh` response's property default value changed from `本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。` to `本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。` for the status `200` - **2026-04-14** `ee5b7c9c88f5`: 11 info - added the optional property `cache_message` to the response with the `200` status - added the optional property `cache_message_zh` to the response with the `200` status - added the optional property `cache_url` to the response with the `200` status - added the optional property `docs` to the response with the `200` status - …7 more - **2025-05-16** `14d38e4b883a`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/tiktok/creator/get_account_health_status/post.md) --- [API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)