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

# Get X (Twitter) account profile for a handle

> [OpenAPI JSON Spec](/docs/output/v1_social-feeds_x_entities_handle_twitter-handle_get.json)
Retrieve the twitter_accounts profile for a Twitter handle.
Unlike by-handle, this endpoint does NOT auto-create a person on miss.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/social-feeds/x/entities/handle/{twitter_handle}
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Welcome to Arrays!


    Arrays is a unified financial data layer for both financial institutions and
    retail users, delivering comprehensive market data across crypto and equity
    markets. Our datasets cover fundamentals, ETFs, options, crypto, and more.


    Visit [arrays.org](https://arrays.org) to request an API key and start your
    free trial. You can explore our full API offerings in the documentation
    below.


    For any questions regarding APIs or pricing, please contact
    support@arrays.org.
  title: Arrays API
  version: '1.0'
servers:
  - url: https://data-tools.prd.arrays.org/api
security: []
paths:
  /v1/social-feeds/x/entities/handle/{twitter_handle}:
    get:
      tags:
        - x-feed
      summary: Get X (Twitter) account profile for a handle
      description: >-
        [OpenAPI JSON
        Spec](/docs/output/v1_social-feeds_x_entities_handle_twitter-handle_get.json)

        Retrieve the twitter_accounts profile for a Twitter handle.

        Unlike by-handle, this endpoint does NOT auto-create a person on miss.
      parameters:
        - description: Twitter handle (no @, case-insensitive)
          in: path
          name: twitter_handle
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Account profile
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        items:
                          $ref: '#/components/schemas/model.XFeedHandle'
                        type: array
                    type: object
        '400':
          description: Validation failure or handle not found
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
      security:
        - ApiKeyAuth: []
components:
  schemas:
    model.APIResponse:
      properties:
        data: {}
        error:
          $ref: '#/components/schemas/model.APIError'
        metadata: {}
        pagination: {}
        request_id:
          type: string
        success:
          type: boolean
      type: object
    model.XFeedHandle:
      properties:
        account_created_at:
          example: '2010-01-01T00:00:00Z'
          type: string
        description:
          example: Founder & CEO of ARK Invest
          type: string
        earliest_backfilled_at:
          description: >-
            EarliestBackfilledAt: earliest published_at among
            fetch_kind='backfill'

            observations for this handle. Empty string when backfill has not yet

            progressed past the initial page. Hourly refresh by aggregator.
          example: '2010-08-15T10:00:00Z'
          type: string
        followers_count:
          example: 1500000
          type: integer
        following_count:
          example: 300
          type: integer
        last_synced_at:
          description: >-
            LastSyncedAt: when this handle's own timeline was last refreshed

            (twitter_subscriptions.last_synced_at). Attempt-time — advances on
            each

            successful refresh tick even if the handle posted nothing in the
            window.

            NOT derived from observation timestamps, so it is immune to
            inflation from

            wrapper hydration (this handle's old tweets being pulled in when
            others

            retweet/quote them). Empty string when the handle has no
            subscription or

            has never been refreshed.
          example: '2026-06-22T09:20:00Z'
          type: string
        profile_banner_url:
          example: https://pbs.twimg.com/profile_banners/...
          type: string
        profile_image_url:
          example: https://pbs.twimg.com/profile_images/...
          type: string
        tags:
          allOf:
            - $ref: '#/components/schemas/model.XFeedHandleTags'
          description: >-
            Tags: offline-curated tag bundle. Absent when no tag data exists for
            this handle.
        twitter_display_name:
          example: Cathie Wood
          type: string
        twitter_handle:
          example: CathieDWood
          type: string
        twitter_id:
          example: '1234567890'
          type: string
        verified:
          example: true
          type: boolean
        verified_type:
          example: blue
          type: string
      type: object
    model.APIError:
      properties:
        code:
          example: RESOURCE_NOT_FOUND
          type: string
        details:
          items:
            $ref: '#/components/schemas/model.APIErrorDetail'
          type: array
        docs_url:
          type: string
        examples:
          items:
            type: string
          type: array
        hint:
          type: string
        message:
          example: The requested resource was not found.
          type: string
        suggestions:
          items:
            type: string
          type: array
      type: object
    model.XFeedHandleTags:
      properties:
        account_kind:
          example: personal
          type: string
        behavior:
          items:
            type: string
          type: array
        institution_type:
          example: government
          type: string
        language:
          items:
            type: string
          type: array
        occupation:
          items:
            type: string
          type: array
        topics:
          items:
            type: string
          type: array
      type: object
    model.APIErrorDetail:
      properties:
        field:
          type: string
        got:
          type: string
        reason:
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: 'API Key authentication. Example: "your-api-key-here"'
      in: header
      name: X-API-Key
      type: apiKey

````