섀도밴 및 답글 표시 상태 확인

People 계정 검색, from:사용자명 기본 Top 게시물 검색과 답글 표시 상태를 확인합니다. API 키만 필요합니다. 기본 응답은 screen_name과 다섯 개의 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에 포함합니다. 기본 여섯 필드와 타입은 유지되며 출력만 변경합니다.

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에 포함합니다. 기본 여섯 필드와 타입은 유지되며 출력만 변경합니다.

속성 표시

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

⚡대화형 콘솔 / API 테스트POST/twitter/shadowban/check

Live Console

🌐대상 서버:https://api.twexapi.io

● 프로덕션 준비 완료

🔍

공개 데이터 조회 (TwexAPI 키만 필요, Twitter 쿠키 불필요)

이 엔드포인트는 공개 Twitter 데이터를 조회합니다. Twitter 계정이나 쿠키가 필요하지 않습니다! 아래 "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에 포함합니다. 기본 여섯 필드와 타입은 유지되며 출력만 변경합니다.

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