> ## 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.

# Verificar shadowban

> Verifica se uma conta do Twitter/X tem restrições de visibilidade. Realiza duas verificações independentes: `search_suggestion_ban`, que indica se a conta aparece nas sugestões ao digitar seu nome de usuário exato, e `search_ban`, que indica se suas publicações aparecem nos resultados de busca. Cada verificação retorna `clean`, `banned` ou `unknown`. `unknown` inclui um `reason` e significa que não foi possível realizar a verificação, nunca que a conta está restrita. `is_shadowbanned` só é true quando pelo menos uma verificação detecta uma restrição real. As propriedades do perfil (`protected`, `possibly_sensitive`) são informadas separadamente e nunca contam como shadowban. Os resultados ficam em cache por uma hora; consulte `checked_at` para saber a idade dos dados.



## OpenAPI

````yaml openapi-pt-BR.json GET /check-shadowban
openapi: 3.0.3
info:
  contact: {}
  title: API Sorsa.io
  version: '3.0'
servers:
  - url: https://api.sorsa.io/v3
security: []
paths:
  /check-shadowban:
    get:
      tags:
        - Verificação
      summary: Verificar shadowban
      description: >-
        Verifica se uma conta do Twitter/X tem restrições de visibilidade.
        Realiza duas verificações independentes: `search_suggestion_ban`, que
        indica se a conta aparece nas sugestões ao digitar seu nome de usuário
        exato, e `search_ban`, que indica se suas publicações aparecem nos
        resultados de busca. Cada verificação retorna `clean`, `banned` ou
        `unknown`. `unknown` inclui um `reason` e significa que não foi possível
        realizar a verificação, nunca que a conta está restrita.
        `is_shadowbanned` só é true quando pelo menos uma verificação detecta
        uma restrição real. As propriedades do perfil (`protected`,
        `possibly_sensitive`) são informadas separadamente e nunca contam como
        shadowban. Os resultados ficam em cache por uma hora; consulte
        `checked_at` para saber a idade dos dados.
      parameters:
        - description: Nome de usuário no Twitter/X (sem @).
          in: query
          name: username
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/verification.CheckShadowbanResp'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Requisição inválida
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Não autorizado
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Acesso proibido
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Não encontrado
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Excesso de requisições
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Erro interno do servidor
      security:
        - ApiKeyAuth: []
components:
  schemas:
    verification.CheckShadowbanResp:
      properties:
        account:
          $ref: '#/components/schemas/verification.ShadowbanAccountState'
        checked_at:
          description: >-
            Momento em que a verificação foi realizada. Os resultados ficam em
            cache, por isso pode ser anterior à requisição.
          example: '2026-08-01T10:00:00Z'
          type: string
        checks:
          $ref: '#/components/schemas/verification.ShadowbanChecks'
        is_shadowbanned:
          description: >-
            `true` quando pelo menos uma verificação detectou uma restrição.
            Verificações com resultado `unknown` nunca são contabilizadas.
          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: >-
            Indica se a conta está marcada como possivelmente contendo conteúdo
            sensível.
          example: false
          type: boolean
        protected:
          description: Indica se a conta é privada.
          example: false
          type: boolean
        statuses_count:
          description: Total de publicações do perfil durante toda a existência da conta.
          example: 41230
          type: integer
      type: object
    verification.ShadowbanChecks:
      properties:
        search_ban:
          allOf:
            - $ref: '#/components/schemas/verification.ShadowbanCheckResult'
          description: Indica se as publicações da conta aparecem nos resultados de busca.
        search_suggestion_ban:
          allOf:
            - $ref: '#/components/schemas/verification.ShadowbanCheckResult'
          description: >-
            Indica se a conta aparece nas sugestões de busca ao digitar seu nome
            de usuário exato.
      type: object
    verification.ShadowbanCheckResult:
      properties:
        reason:
          description: >-
            Motivo pelo qual a verificação retornou `unknown`. Ausente nos
            demais casos.
          example: no_tweets
          type: string
        status:
          description: >-
            `clean`, `banned` ou `unknown`. `unknown` significa que a
            verificação não foi realizada e não representa uma acusação.
          example: clean
          type: string
        tweets_found:
          description: >-
            Evidência do resultado de bloqueio na busca: quantas publicações a
            busca retornou.
          example: 18
          type: integer
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: ApiKey
      type: apiKey

````