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

# Track many prompts at once

> Track up to 100 prompts in one atomic operation. An incoming text matching an existing tracked prompt reuses that prompt rather than duplicating it. The prompt cap is checked once over the whole batch; a batch that would exceed it is rejected and nothing is tracked. Requires a paid plan.



## OpenAPI

````yaml https://api.spreadjam.com/openapi.json post /v1/prompts/bulk
openapi: 3.0.0
info:
  title: SpreadJam API
  version: 1.0.0
servers: []
security: []
tags:
  - name: Meta
    description: Identity and metadata about the authenticated key.
  - name: Keywords
    description: Keyword and topic visibility rankings.
  - name: API keys
    description: Manage the workspace's API keys.
  - name: Analytics
    description: AI-visibility analytics for the workspace.
  - name: Brand
    description: The workspace's brand profile and competitors.
  - name: Prompts
    description: Tracked GEO prompts and their cap state.
paths:
  /v1/prompts/bulk:
    post:
      tags:
        - Prompts
      summary: Track many prompts at once
      description: >-
        Track up to 100 prompts in one atomic operation. An incoming text
        matching an existing tracked prompt reuses that prompt rather than
        duplicating it. The prompt cap is checked once over the whole batch; a
        batch that would exceed it is rejected and nothing is tracked. Requires
        a paid plan.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkInsertPrompts'
      responses:
        '201':
          description: The per-prompt tracking results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkInsertPromptsResult'
      security:
        - bearerAuth: []
components:
  schemas:
    BulkInsertPrompts:
      type: object
      properties:
        prompts:
          type: array
          items:
            type: object
            properties:
              text:
                type: string
                minLength: 3
                maxLength: 500
                description: Prompt wording (3 to 500 characters).
              persona:
                type: string
                enum:
                  - discoverer
                  - buyer
                  - evaluator
                  - competitor
                  - branded
                  - control
                description: Buyer-journey persona; defaults to discoverer.
              topic:
                type: string
                nullable: true
                description: Optional topic/theme label.
              intent:
                type: string
                nullable: true
                description: Optional buyer intent.
            required:
              - text
          minItems: 1
          maxItems: 100
          description: >-
            The prompts to track (1 to 100). A text matching an existing tracked
            prompt reuses it.
      required:
        - prompts
    BulkInsertPromptsResult:
      type: object
      properties:
        results:
          type: array
          items:
            type: object
            properties:
              promptId:
                type: string
              created:
                type: boolean
                description: true if newly tracked, false if an existing prompt was reused.
            required:
              - promptId
              - created
        activeCount:
          type: integer
          example: 14
        cap:
          type: integer
          description: The effective prompt cap; -1 means unlimited.
          example: 50
      required:
        - results
        - activeCount
        - cap
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        A workspace API key issued in Settings → Developer, sent as `Bearer
        sk_…`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.