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

# Get Artists Collectors

> Returns artists who are both creators and collectors on the In•Process protocol. Supports filtering by artist and time period.



## OpenAPI

````yaml GET /artists/collectors
openapi: 3.1.0
info:
  title: In•Process API
  description: >-
    The In•Process API enables browsing and managing moments from timelines.
    Retrieve moments from a specific artist's timeline, browse the in•process
    collective timeline, or filter by collection. The API supports creating
    moments, managing collections, handling payments, and interacting with the
    In•Process protocol ecosystem.
  version: 1.0.0
servers:
  - url: https://api.inprocess.world/api
    description: Production server
security: []
paths:
  /artists/collectors:
    get:
      summary: Get Artists Collectors
      description: >-
        Returns artists who are both creators and collectors on the In•Process
        protocol. Supports filtering by artist and time period.
      operationId: getArtistsCollectorsStats
      parameters:
        - name: period
          in: query
          required: false
          description: >-
            Restrict which moments are counted: approximately the last day,
            week, or month. `all` means no time limit.
          schema:
            type: string
            enum:
              - day
              - week
              - month
              - all
            default: all
        - name: limit
          in: query
          required: false
          description: Page size (1 to 100). Default 20.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
        - name: page
          in: query
          required: false
          description: 1-based page number. Default 1.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: artist
          in: query
          required: false
          description: Filter by wallet address or username substring.
          schema:
            type: string
            minLength: 1
        - name: sort_by
          in: query
          required: false
          description: Metric to sort by.
          schema:
            type: string
            enum:
              - total_created_count
              - total_collected_count
            default: total_created_count
        - name: sort_order
          in: query
          required: false
          description: Sort direction.
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtistsCollectorsStatsResponse'
              example:
                artists:
                  - artist_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    username: matt
                    wallets:
                      - address: '0x51027631B9DEF86e088C33368eC4E3A4BE0aD264'
                        type: farcaster
                    total_created_count: 42
                    total_collected_count: 130
                total_count: 1
                page: 1
                total_pages: 1
        '400':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - errors
                properties:
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - field
                        - message
                      properties:
                        field:
                          type: string
                        message:
                          type: string
              example:
                message: Invalid input
                errors:
                  - field: limit
                    message: Number must be less than or equal to 100
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
      security: []
components:
  schemas:
    ArtistsCollectorsStatsResponse:
      type: object
      required:
        - artists
        - total_count
        - page
        - total_pages
      properties:
        artists:
          type: array
          items:
            $ref: '#/components/schemas/ArtistsCollectorsStatsItem'
          description: List of artist collector stats
        total_count:
          type: integer
          description: Total number of artists matching the query
        page:
          type: integer
          description: Current page number
        total_pages:
          type: integer
          description: Total number of pages
    ArtistsCollectorsStatsItem:
      type: object
      required:
        - artist_id
        - username
        - wallets
        - total_created_count
        - total_collected_count
      properties:
        artist_id:
          type: string
          format: uuid
          description: Artist identifier.
        username:
          type: string
          description: Artist username.
        wallets:
          type: array
          description: Wallet addresses associated with this artist.
          items:
            type: object
            required:
              - address
              - type
            properties:
              address:
                type: string
              type:
                type: string
        total_created_count:
          type: integer
          description: Total number of moments created by this artist
        total_collected_count:
          type: integer
          description: Total number of times this artist's moments have been collected

````