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

# 20 seguidores com maior pontuação

> Retorna os 20 seguidores da conta especificada com maior Sorsa Score. Cada entrada inclui o perfil do seguidor e a data em que começou a seguir. Permite identificar as contas mais influentes de uma audiência. Identifique o usuário informando exatamente um destes campos: `user_link`, `username` ou `user_id`.



## OpenAPI

````yaml openapi-pt-BR.json GET /top-followers
openapi: 3.0.3
info:
  contact: {}
  title: API Sorsa.io
  version: '3.0'
servers:
  - url: https://api.sorsa.io/v3
security: []
paths:
  /top-followers:
    get:
      tags:
        - Sorsa e cripto
      summary: 20 seguidores com maior pontuação
      description: >-
        Retorna os 20 seguidores da conta especificada com maior Sorsa Score.
        Cada entrada inclui o perfil do seguidor e a data em que começou a
        seguir. Permite identificar as contas mais influentes de uma audiência.
        Identifique o usuário informando exatamente um destes campos:
        `user_link`, `username` ou `user_id`.
      parameters:
        - description: URL completa do perfil do usuário no Twitter/X.
          in: query
          name: user_link
          schema:
            type: string
        - description: Nome de usuário no Twitter/X (sem @).
          in: query
          name: username
          schema:
            type: string
        - description: ID numérico do usuário do Twitter/X.
          in: query
          name: user_id
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.TopFollowersResponse'
          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:
    common.TopFollowersResponse:
      properties:
        users:
          description: >-
            Lista de objetos de perfil de seguidores com as datas em que
            começaram a seguir a conta.
          items:
            $ref: '#/components/schemas/common.TopFollower'
          type: array
      type: object
    handler.ErrorResponse:
      properties:
        message:
          type: string
      type: object
    common.TopFollower:
      properties:
        can_dm:
          example: false
          type: boolean
        created_at:
          description: Data de criação da conta no formato ISO 8601.
          example: '2009-06-02T20:12:29Z'
          type: string
        description:
          description: Texto da biografia do perfil.
          example: Bio text
          type: string
        display_name:
          description: Nome de exibição do usuário.
          example: Elon Musk
          type: string
        follower_date:
          example: '2009-06-02T20:12:29Z'
          type: string
        followers_count:
          description: Número de contas que seguem este usuário.
          example: 100000
          type: integer
        followings_count:
          description: Número de contas que este usuário segue.
          example: 500
          type: integer
        id:
          description: ID único do usuário do Twitter/X.
          example: '44196397'
          type: string
        profile_background_image_url:
          description: URL da imagem de fundo do perfil do usuário.
          example: https://pbs.twimg.com/profile_banners/44196397/123
          type: string
        profile_image_url:
          description: URL da imagem de avatar do usuário.
          example: https://pbs.twimg.com/profile_images/123/photo.jpg
          type: string
        protected:
          description: Indica se as publicações da conta são protegidas (privadas).
          example: false
          type: boolean
        score:
          description: Indica se a conta aceita mensagens diretas.
          example: 100
          type: number
        tweets_count:
          description: Número total de publicações deste usuário.
          example: 5000
          type: integer
        username:
          description: Nome de usuário atual no Twitter/X (sem @).
          example: elonmusk
          type: string
        verified:
          description: Indica se a conta tem um selo de verificação.
          example: true
          type: boolean
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: ApiKey
      type: apiKey

````