---
search:
  tags:
    - Search Endpoints
    - POST
seo:
  description: >-
    检测 People 账号搜索、使用 from:用户名 的默认 Top… Reference for the POST
    /twitter/shadowban/check endpoint in the TwexAPI REST API 规范参考 API.
sidebar:
  badge: POST
  label: 检测 Shadowban 与回复可见性
title: 检测 Shadowban 与回复可见性
type: openapi-operation
---
检测 People 账号搜索、使用 `from:用户名` 的默认 Top 帖子搜索，以及回复可见性。仅需 API Key。默认返回 `screen_name` 和五个 boolean/null 标记：`true` 表示发现疑似限制，`false` 表示本次检查未发现异常，`null` 表示无法判断或该项未检测。传 `details: true` 后，完整证据放在 `data.details`，简化字段保持不变。

默认启用回复检查，最多取样两条最近七天内对其他账号的原创回复。只有实际加载折叠入口并找到目标回复，才判断为疑似 Reply Deboosting，例如位于 Show probable spam 区域。Ghost Ban 要求原帖可访问、回复列表查完，且直接查询确认回复仍存在。分页未查完、原帖不可访问、没有合适样本或位置结构异常时返回无法判断。账号搜索检查的是 People 结果，不是下拉搜索建议。结果来自一个查询账号的观察，不代表确认 X 内部处罚或整个账号的全部可见性。

```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "screen_name": "example_user",
    "shadow_ban": false,
    "account_search_ban": false,
    "search_ban": false,
    "ghost_ban": false,
    "reply_deboosting": false
  }
}
```

<Operation source="zh-api-reference" id="shadowban-check" />