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

# X User by Identifier

> Retrieve a specific X user

<Note>
  **x402 Support:** Supported.
  See the [x402 guide](/api-reference/x402-payments#supported-endpoints).
</Note>


## OpenAPI

````yaml GET /signal/v1/x-users/{xUserID}
openapi: 3.0.0
info:
  description: OpenAPI specification for the entire Messari API
  title: Messari API - Signal V1
  version: 1.0.0
servers:
  - description: Messari API
    url: https://api.messari.io
security: []
paths:
  /signal/v1/x-users/{xUserID}:
    get:
      tags:
        - X Users
      summary: Get X User
      description: Retrieve a specific X user
      operationId: getXUserV1
      parameters:
        - description: >-
            X User ID, must be either a numeric X User ID or a username like
            '@handle'.
          in: path
          name: xUserID
          required: true
          schema:
            type: string
            example: '@vitalikbuterin'
            default: '@vitalikbuterin'
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/XUser'
                  error:
                    type: string
                required:
                  - data
                type: object
              example:
                error: null
                data:
                  id: '295218901'
                  name: vitalik.eth
                  username: VitalikButerin
                  profileImageUrl: >-
                    https://pbs.twimg.com/profile_images/1895872023944937472/Uoyc5-p8_normal.jpg
                  isProjectAccount: false
                  mindshare:
                    1d:
                      percentage: 0.03138387935943685
                      percentageChange: 0.03138387935943685
                    7d:
                      percentage: 0.031175293266454924
                      percentageChange: 0.031175293266454924
                    30d:
                      percentage: 0.03284712889366022
                      percentageChange: 0.03284712889366022
                    60d:
                      percentage: 0.03418320227347127
                      percentageChange: 0.03418320227347127
                    90d:
                      percentage: 0.03229046443224906
                      percentageChange: 0.032290464432249054
                    180d:
                      percentage: 0.030860918564761204
                      percentageChange: 0.030860918564761204
                    1y:
                      percentage: 0.029665583505766518
                      percentageChange: 0.029665583505766518
                    ytd:
                      percentage: 0.028911748897618772
                      percentageChange: 0.028911748897618772
                  followerMetrics:
                    followersCount: 5835201
                    followingCount: 515
                  postMetrics:
                    postCount: 21215
                  engagement:
                    1d:
                      score: 488.43829592562
                    7d:
                      score: 429.744204739551
                    30d:
                      score: 672.635772959163
                    60d:
                      score: 574.787500622552
                    90d:
                      score: 604.083523315675
                    180d:
                      score: 621.08590532656
                    1y:
                      score: 1074.913645217297
                    ytd:
                      score: 771.701882779501
          description: Default response
        '400':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Bad Request
        '403':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Forbidden
        '500':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Internal Server Error
      security:
        - apiKey: []
components:
  schemas:
    XUser:
      properties:
        engagement:
          $ref: '#/components/schemas/XUserEngagementIntervals'
        followerMetrics:
          $ref: '#/components/schemas/XUserFollowerMetrics'
        id:
          type: string
        isProjectAccount:
          type: boolean
        mindshare:
          $ref: '#/components/schemas/XUserMindshareIntervals'
        name:
          type: string
        postMetrics:
          $ref: '#/components/schemas/XUserPostMetrics'
        profileImageUrl:
          type: string
        username:
          type: string
      required:
        - engagement
        - followerMetrics
        - id
        - isProjectAccount
        - mindshare
        - name
        - postMetrics
        - profileImageUrl
        - username
      type: object
    XUserEngagementIntervals:
      type: object
      description: Schema for XUserEngagementIntervals
      properties: {}
      additionalProperties: true
    XUserFollowerMetrics:
      type: object
      description: Schema for XUserFollowerMetrics
      properties: {}
      additionalProperties: true
    XUserMindshareIntervals:
      type: object
      description: Schema for XUserMindshareIntervals
      properties: {}
      additionalProperties: true
    XUserPostMetrics:
      type: object
      description: Schema for XUserPostMetrics
      properties: {}
      additionalProperties: true
  securitySchemes:
    apiKey:
      in: header
      name: X-Messari-API-Key
      type: apiKey

````

Built with [Mintlify](https://mintlify.com).