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

# Follower Category Stats

> Returns a breakdown of the account's followers by Sorsa category: influencers, projects, and VC (venture capital) employees. Also indicates whether the account is protected. If the account is already indexed in the Sorsa database, the response is fast. For new accounts, the initial data collection may take longer, especially for large follower bases. Identify the user by providing exactly one of: `user_link`, `username`, or `user_id`.



## OpenAPI

````yaml https://api.sorsa.io/v3/swagger.json get /followers-stats
openapi: 3.0.3
info:
  contact: {}
  title: API Sorsa.io
  version: '3.0'
servers:
  - url: https://api.sorsa.io/v3
security: []
paths:
  /followers-stats:
    get:
      tags:
        - Sorsa Info Crypto Related
      summary: Follower Category Stats
      description: >-
        Returns a breakdown of the account's followers by Sorsa category:
        influencers, projects, and VC (venture capital) employees. Also
        indicates whether the account is protected. If the account is already
        indexed in the Sorsa database, the response is fast. For new accounts,
        the initial data collection may take longer, especially for large
        follower bases. Identify the user by providing exactly one of:
        `user_link`, `username`, or `user_id`.
      parameters:
        - description: Full URL of the user's Twitter/X profile.
          in: query
          name: user_link
          schema:
            type: string
        - description: Twitter/X handle (without @).
          in: query
          name: username
          schema:
            type: string
        - description: Numeric Twitter/X user ID.
          in: query
          name: user_id
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sorsa.FollowersStatsResp'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Not Found
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Too Many Requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Internal Server Error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    sorsa.FollowersStatsResp:
      properties:
        followers_count:
          description: Total number of categorized followers.
          example: 16
          type: integer
        influencers_count:
          description: Number of followers classified as influencers.
          example: 12
          type: integer
        projects_count:
          description: Number of followers classified as projects.
          example: 3
          type: integer
        user_protected:
          description: '`true` if the target account is protected.'
          example: false
          type: boolean
        venture_capitals_count:
          description: Number of followers classified as VC employees.
          example: 1
          type: integer
      type: object
    handler.ErrorResponse:
      properties:
        message:
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: ApiKey
      type: apiKey

````