シャドウバンと返信の可視性を確認

People のアカウント検索、from:ユーザー名 のデフォルト Top 投稿検索、返信の可視性を確認します。API キーのみ必要です。標準レスポンスは screen_name と5つの boolean/null フラグです。true は制限の疑い、false は実施した確認で異常の証拠なし、null は判定不能または未実施を示します。details: true を指定すると、同じ簡潔なフィールドに加えて data.details に詳細な証拠が含まれます。

返信確認は標準で有効で、過去7日間の他アカウントへの返信を最大2件抽出します。Show probable spam などの折りたたみ領域を読み込み、対象の返信が実際に見つかった場合に Reply Deboosting を疑います。Ghost Ban は親投稿を閲覧でき、会話の取得が完了し、返信が直接取得可能なことを確認した場合に限ります。取得未完了、親投稿が閲覧不可、サンプルなし、配置情報の異常は判定不能です。People 検索は検索候補のテストではありません。単一の閲覧アカウントによる観測であり、X 内部の制裁やアカウント全体の状態を確定するものではありません。

{
  "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
  }
}

APIリファレンスに戻る

/Search Endpoints

TwexAPI REST

POST/twitter/shadowban/check

API 認証

AuthorizationBearer token · header必須

TwexAPIのグローバル認証トークン (Bearer Token)。ヘッダーに含める必要があります：Authorization: Bearer <YOUR_TWEXAPI_KEY>。

リクエストボディ

必須application/json

screen_namestring必須

@ と前後の空白を省略・追加できます。英数字とアンダースコアの1〜15文字。プロフィール URL は不可。

matches ^\s*@?[A-Za-z0-9_]{1,15}\s*$

max_pagesinteger

各検索、返信抽出、親投稿の会話ごとの最大ページ数。1〜3の JSON 整数を指定します。null や数値文字列は不可。

min 1 · max 3 · default: 2

check_repliesboolean

Ghost Ban と Reply Deboosting の確認を有効化。false の場合、総合結果は検索のみを対象とし、返信フラグは null。

default: true

許可値:truefalse

detailsboolean

元の詳細結果を data.details に含めます。6つの簡潔なフィールドと型は変わりません。出力のみを変更します。

default: false

許可値:truefalse

reply_sample_sizeinteger

自動抽出する最近の返信の最大件数、1〜3。明示した reply_ids の件数は制限しません。

min 1 · max 3 · default: 2

reply_idsstring[]

自動抽出の代わりに確認する1〜3件の数値形式の投稿 ID 文字列。対象アカウントから他者への返信に限ります。重複は一度だけ確認。URL や JSON 数値は不可。

min items 1 · max items 3

レスポンス

200true：制限の疑い、false：実施した確認で証拠なし、null：判定不能または未実施。

codeinteger必須

msgstring必須

dataShadowbanCheckData必須

プロパティを表示

screen_namestring必須

@ と前後の空白を省略・追加できます。英数字とアンダースコアの1〜15文字。プロフィール URL は不可。

shadow_banboolean | null必須

有効な確認項目の総合結果。制限の証拠があれば true、証拠がなく未確定項目があれば null。 true：制限の疑い、false：実施した確認で証拠なし、null：判定不能または未実施。

account_search_banboolean | null必須

People アカウント検索で表示されない疑い。 true：制限の疑い、false：実施した確認で証拠なし、null：判定不能または未実施。

search_banboolean | null必須

from:ユーザー名のデフォルト Top 投稿検索で表示されない疑い。 true：制限の疑い、false：実施した確認で証拠なし、null：判定不能または未実施。

ghost_banboolean | null必須

直接取得できる返信が、取得完了した親投稿の会話に表示されない疑い。 true：制限の疑い、false：実施した確認で証拠なし、null：判定不能または未実施。

reply_deboostingboolean | null必須

明示的な折りたたみ領域を読み込んだ後にのみ対象返信が見つかった状態。 true：制限の疑い、false：実施した確認で証拠なし、null：判定不能または未実施。

detailsShadowbanCheckEvidence

元の詳細結果を data.details に含めます。6つの簡潔なフィールドと型は変わりません。出力のみを変更します。

プロパティを表示

screen_namestring必須

user_idstring | null必須

checked_atstring<date-time>必須

statusstring必須

許可値:suspectedno_evidenceinconclusive

suspected_shadowbanboolean | null必須

true：制限の疑い、false：実施した確認で証拠なし、null：判定不能または未実施。

account_searchShadowbanSearchEvidence必須

プロパティを表示

statusstring必須

許可値:visiblenot_foundinconclusive

querystring必須

pages_checkedinteger必須

min 0

matched_idsstring[]必須

reasonstring必須

baseline_post_idsstring[]

post_searchShadowbanSearchEvidence必須

プロパティを表示

statusstring必須

許可値:visiblenot_foundinconclusive

querystring必須

pages_checkedinteger必須

min 0

matched_idsstring[]必須

reasonstring必須

baseline_post_idsstring[]

reply_visibilityShadowbanReplyVisibility必須

プロパティを表示

statusstring必須

許可値:visiblehiddendeboostedinconclusivemixedskipped

sample_countinteger必須

min 0

reasonstring必須

samplesShadowbanReplySample[]必須

プロパティを表示

Array of ShadowbanReplySample

reply_idstring必須

parent_tweet_idstring | null必須

statusstring必須

許可値:visiblehiddendeboostedinconclusive

reasonstring必須

pages_checkedinteger必須

min 0

reply_accessibleboolean | null必須

parent_accessibleboolean必須

matched_entry_idstring

folded_cursor_typestring

folded_action_textstring

ghost_banShadowbanReplySummary必須

プロパティを表示

statusstring必須

許可値:suspectedno_evidenceinconclusive

suspectedboolean | null必須

true：制限の疑い、false：実施した確認で証拠なし、null：判定不能または未実施。

checked_repliesinteger必須

min 0

affected_reply_idsstring[]必須

reasonstring必須

reply_deboostingShadowbanReplySummary必須

プロパティを表示

statusstring必須

許可値:suspectedno_evidenceinconclusive

suspectedboolean | null必須

true：制限の疑い、false：実施した確認で証拠なし、null：判定不能または未実施。

checked_repliesinteger必須

min 0

affected_reply_idsstring[]必須

reasonstring必須

limitationsstring必須

400無効なリクエスト

codeinteger必須

msgstring必須

dataobject | any[]必須

プロパティを表示

Any of:

object

object

any[]

Array of any

any

401認証失敗

codeinteger必須

msgstring必須

dataobject | any[]必須

プロパティを表示

Any of:

object

object

any[]

Array of any

any

403認証・クォータ・検索権限不足

codeinteger必須

msgstring必須

dataobject | any[]必須

プロパティを表示

Any of:

object

object

any[]

Array of any

any

404上流リソースなし

codeinteger必須

msgstring必須

dataobject | any[]必須

プロパティを表示

Any of:

object

object

any[]

Array of any

any

429レート制限

codeinteger必須

msgstring必須

dataobject | any[]必須

プロパティを表示

Any of:

object

object

any[]

Array of any

any

500サーバーエラー

codeinteger必須

msgstring必須

dataobject | any[]必須

プロパティを表示

Any of:

object

object

any[]

Array of any

any

502上流サービスエラー

codeinteger必須

msgstring必須

dataobject | any[]必須

プロパティを表示

Any of:

object

object

any[]

Array of any

any

503サービス一時利用不可

codeinteger必須

msgstring必須

dataobject | any[]必須

プロパティを表示

Any of:

object

object

any[]

Array of any

any

504上流リクエストのタイムアウト

codeinteger必須

msgstring必須

dataobject | any[]必須

プロパティを表示

Any of:

object

object

any[]

Array of any

any

⚡インタラクティブテスト / Try APIPOST/twitter/shadowban/check

Live Console

🌐対象サーバー:https://api.twexapi.io

● 本番環境レディ

🔍

公開データ取得（TwexAPIキーのみ、Twitter Cookie不要）

本エンドポイントは公開Twitterデータの検索・取得用です。TwitterアカウントやCookieは一切不要です！下記の「API認証」に TwexAPIプラットフォームキー (Bearer Token) を入力するだけで即座にテストできます。

🔑API 認証

キーを記憶コード例に同期

TwexAPI プラットフォームキー Bearer Token必須

すべてのTwexAPIエンドポイントで使用されるAPIキー。ダッシュボードで取得できます。

📝リクエストボディapplication/json

screen_namestring

必須@ と前後の空白を省略・追加できます。英数字とアンダースコアの1〜15文字。プロフィール URL は不可。

max_pagesinteger

任意各検索、返信抽出、親投稿の会話ごとの最大ページ数。1〜3の JSON 整数を指定します。null や数値文字列は不可。

check_repliesboolean

任意Ghost Ban と Reply Deboosting の確認を有効化。false の場合、総合結果は検索のみを対象とし、返信フラグは null。

detailsboolean

任意元の詳細結果を data.details に含めます。6つの簡潔なフィールドと型は変わりません。出力のみを変更します。

reply_sample_sizeinteger

任意自動抽出する最近の返信の最大件数、1〜3。明示した reply_ids の件数は制限しません。

reply_idsarray

任意自動抽出の代わりに確認する1〜3件の数値形式の投稿 ID 文字列。対象アカウントから他者への返信に限ります。重複は一度だけ確認。URL や JSON 数値は不可。

💡 クイック送信:⌘ / Ctrl+Enter

📡

暂无响应数据

请在「请求配置」中确认参数后，点击底部的「发送请求」按钮。

リクエスト例

curl -X POST "https://api.twexapi.io/twitter/shadowban/check" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "screen_name": "example_user"
}'

const response = await fetch("https://api.twexapi.io/twitter/shadowban/check", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "screen_name": "example_user"
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/twitter/shadowban/check",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "screen_name": "example_user"
},
)

レスポンス例

{
  "code": 200,
  "msg": "string",
  "data": {
    "screen_name": "string",
    "shadow_ban": true,
    "account_search_ban": true,
    "search_ban": true,
    "ghost_ban": true,
    "reply_deboosting": true,
    "details": {
      "screen_name": "string",
      "user_id": "string",
      "checked_at": "2019-08-24T14:15:22Z",
      "status": "suspected",
      "suspected_shadowban": true,
      "account_search": {
        "status": "visible",
        "query": "string",
        "pages_checked": 0,
        "matched_ids": [
          "string"
        ],
        "reason": "string",
        "baseline_post_ids": [
          "string"
        ]
      },
      "post_search": {
        "status": "visible",
        "query": "string",
        "pages_checked": 0,
        "matched_ids": [
          "string"
        ],
        "reason": "string",
        "baseline_post_ids": [
          "string"
        ]
      },
      "reply_visibility": {
        "status": "visible",
        "sample_count": 0,
        "reason": "string",
        "samples": [
          {
            "reply_id": "string",
            "parent_tweet_id": "string",
            "status": "visible",
            "reason": "string",
            "pages_checked": 0,
            "reply_accessible": true,
            "parent_accessible": true,
            "matched_entry_id": "string",
            "folded_cursor_type": "string",
            "folded_action_text": "string"
          }
        ]
      },
      "ghost_ban": {
        "status": "suspected",
        "suspected": true,
        "checked_replies": 0,
        "affected_reply_ids": [
          "string"
        ],
        "reason": "string"
      },
      "reply_deboosting": {
        "status": "suspected",
        "suspected": true,
        "checked_replies": 0,
        "affected_reply_ids": [
          "string"
        ],
        "reason": "string"
      },
      "limitations": "string"
    }
  }
}

{
  "code": 400,
  "msg": "max_pages must be an integer from 1 to 3",
  "data": {}
}

{
  "code": 0,
  "msg": "string",
  "data": {}
}

{
  "code": 0,
  "msg": "string",
  "data": {}
}

{
  "code": 0,
  "msg": "string",
  "data": {}
}

{
  "code": 0,
  "msg": "string",
  "data": {}
}

{
  "code": 0,
  "msg": "string",
  "data": {}
}

{
  "code": 0,
  "msg": "string",
  "data": {}
}

{
  "code": 0,
  "msg": "string",
  "data": {}
}

{
  "code": 0,
  "msg": "string",
  "data": {}
}