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

# Comprobar shadowban

> Comprueba si una cuenta de Twitter/X tiene restricciones de visibilidad. Realiza dos comprobaciones independientes: `search_suggestion_ban`, que indica si aparece en las sugerencias al escribir su nombre de usuario exacto, y `search_ban`, que indica si sus publicaciones aparecen en los resultados de búsqueda. Cada comprobación devuelve `clean`, `banned` o `unknown`. `unknown` incluye un `reason` y significa que no se pudo realizar la comprobación, nunca que la cuenta esté restringida. `is_shadowbanned` solo es true cuando al menos una comprobación detecta una restricción real. Las propiedades del perfil (`protected`, `possibly_sensitive`) se informan por separado y nunca se consideran un shadowban. Los resultados se almacenan en caché durante una hora; consulta `checked_at` para conocer su antigüedad.



## OpenAPI

````yaml /openapi-es.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:
        - Verificación
      summary: Comprobar shadowban
      description: >-
        Comprueba si una cuenta de Twitter/X tiene restricciones de visibilidad.
        Realiza dos comprobaciones independientes: `search_suggestion_ban`, que
        indica si aparece en las sugerencias al escribir su nombre de usuario
        exacto, y `search_ban`, que indica si sus publicaciones aparecen en los
        resultados de búsqueda. Cada comprobación devuelve `clean`, `banned` o
        `unknown`. `unknown` incluye un `reason` y significa que no se pudo
        realizar la comprobación, nunca que la cuenta esté restringida.
        `is_shadowbanned` solo es true cuando al menos una comprobación detecta
        una restricción real. Las propiedades del perfil (`protected`,
        `possibly_sensitive`) se informan por separado y nunca se consideran un
        shadowban. Los resultados se almacenan en caché durante una hora;
        consulta `checked_at` para conocer su antigüedad.
      parameters:
        - description: Nombre de usuario en Twitter/X (sin @).
          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: Solicitud incorrecta
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: No autorizado
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Acceso prohibido
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: No encontrado
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Demasiadas solicitudes
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Error interno del servidor
      security:
        - ApiKeyAuth: []
components:
  schemas:
    verification.CheckShadowbanResp:
      properties:
        account:
          $ref: '#/components/schemas/verification.ShadowbanAccountState'
        checked_at:
          description: >-
            Momento en que se realizó la comprobación. Los resultados se
            almacenan en caché, por lo que puede ser anterior a la solicitud.
          example: '2026-08-01T10:00:00Z'
          type: string
        checks:
          $ref: '#/components/schemas/verification.ShadowbanChecks'
        is_shadowbanned:
          description: >-
            `true` cuando al menos una comprobación detectó una restricción. Las
            comprobaciones con resultado `unknown` no se cuentan.
          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 si la cuenta está marcada como posible fuente de contenido
            sensible.
          example: false
          type: boolean
        protected:
          description: Indica si la cuenta es privada.
          example: false
          type: boolean
        statuses_count:
          description: >-
            Total de publicaciones del perfil a lo largo de toda la existencia
            de la cuenta.
          example: 41230
          type: integer
      type: object
    verification.ShadowbanChecks:
      properties:
        search_ban:
          allOf:
            - $ref: '#/components/schemas/verification.ShadowbanCheckResult'
          description: >-
            Indica si las publicaciones de la cuenta aparecen en los resultados
            de búsqueda.
        search_suggestion_ban:
          allOf:
            - $ref: '#/components/schemas/verification.ShadowbanCheckResult'
          description: >-
            Indica si la cuenta aparece en las sugerencias de búsqueda al
            escribir su nombre de usuario exacto.
      type: object
    verification.ShadowbanCheckResult:
      properties:
        reason:
          description: >-
            Motivo por el que la comprobación devolvió `unknown`. No aparece en
            otros casos.
          example: no_tweets
          type: string
        status:
          description: >-
            `clean`, `banned` o `unknown`. `unknown` significa que no se pudo
            realizar la comprobación y no implica ninguna acusación.
          example: clean
          type: string
        tweets_found:
          description: >-
            Evidencia del resultado de bloqueo en búsquedas: cuántas
            publicaciones devolvió la búsqueda.
          example: 18
          type: integer
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: ApiKey
      type: apiKey

````