> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sorsa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# シャドウバンの確認

> Twitter/Xアカウントの表示制限を確認します。正確なユーザー名を入力したときの検索候補への表示（`search_suggestion_ban`）と、投稿が検索されるか（`search_ban`）を独立して測定します。結果は`clean`、`banned`、`unknown`です。`unknown`は`reason`を伴い、測定できなかったことを示すもので、制限の判定ではありません。少なくとも1つで実際の制限が見つかった場合だけ`is_shadowbanned`がtrueになります。`protected`と`possibly_sensitive`は別に報告され、シャドウバンには数えません。結果は1時間キャッシュされます。データの時刻は`checked_at`を確認してください。



## OpenAPI

````yaml /openapi-ja.json get /check-shadowban
openapi: 3.0.3
info:
  contact: {}
  title: Sorsa.io API
  version: '3.0'
servers:
  - url: https://api.sorsa.io/v3
security: []
paths:
  /check-shadowban:
    get:
      tags:
        - アクションの確認
      summary: シャドウバンの確認
      description: >-
        Twitter/Xアカウントの表示制限を確認します。正確なユーザー名を入力したときの検索候補への表示（`search_suggestion_ban`）と、投稿が検索されるか（`search_ban`）を独立して測定します。結果は`clean`、`banned`、`unknown`です。`unknown`は`reason`を伴い、測定できなかったことを示すもので、制限の判定ではありません。少なくとも1つで実際の制限が見つかった場合だけ`is_shadowbanned`がtrueになります。`protected`と`possibly_sensitive`は別に報告され、シャドウバンには数えません。結果は1時間キャッシュされます。データの時刻は`checked_at`を確認してください。
      parameters:
        - description: Twitter/Xユーザー名（@なし）。
          in: query
          name: username
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/verification.CheckShadowbanResp'
          description: 成功
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: 不正なリクエスト
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: 認証失敗
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: アクセス拒否
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: 見つかりません
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: リクエスト過多
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: 内部サーバーエラー
      security:
        - ApiKeyAuth: []
components:
  schemas:
    verification.CheckShadowbanResp:
      properties:
        account:
          $ref: '#/components/schemas/verification.ShadowbanAccountState'
        checked_at:
          description: 実際に測定した時刻。キャッシュのため、リクエスト時刻より古い場合があります。
          example: '2026-08-01T10:00:00Z'
          type: string
        checks:
          $ref: '#/components/schemas/verification.ShadowbanChecks'
        is_shadowbanned:
          description: 少なくとも1つの確認で実際の制限が見つかった場合に`true`。`unknown`の確認は数えません。
          example: false
          type: boolean
        user_id:
          example: '44196397'
          type: string
        username:
          example: elonmusk
          type: string
      type: object
    handler.ErrorResponse:
      properties:
        message:
          type: string
      type: object
    verification.ShadowbanAccountState:
      properties:
        possibly_sensitive:
          description: センシティブな内容を含む可能性があると指定されているか。
          example: false
          type: boolean
        protected:
          description: アカウントが非公開か。
          example: false
          type: boolean
        statuses_count:
          description: アカウント作成以来のプロフィール上の総投稿数。
          example: 41230
          type: integer
      type: object
    verification.ShadowbanChecks:
      properties:
        search_ban:
          allOf:
            - $ref: '#/components/schemas/verification.ShadowbanCheckResult'
          description: アカウントの投稿が検索で返されるか。
        search_suggestion_ban:
          allOf:
            - $ref: '#/components/schemas/verification.ShadowbanCheckResult'
          description: 正確なユーザー名を入力したときに検索候補へ表示されるか。
      type: object
    verification.ShadowbanCheckResult:
      properties:
        reason:
          description: 確認結果が`unknown`になった理由。それ以外では省略。
          example: no_tweets
          type: string
        status:
          description: >-
            `clean`、`banned`、`unknown`のいずれか。`unknown`は測定できなかったことを意味し、制限があるという判定ではありません。
          example: clean
          type: string
        tweets_found:
          description: 検索制限の判定根拠：検索が返した投稿数。
          example: 18
          type: integer
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: ApiKey
      type: apiKey

````