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

# Get one AI Visibility run

> Reads a single AI Visibility run by id. Ids do not cross workspaces.



## OpenAPI

````yaml /openapi.json get /api/entities/VisibilityRun/{id}
openapi: 3.1.0
info:
  title: Reputably API
  version: 1.0.0
  description: >-
    The HTTP surface an agent credential can reach. It is read plus safe writes:
    you can read your reputation data, generate drafts, queue reports and run
    first-time tracking setup. You cannot send anything to an external platform,
    trigger syncs, touch billing or manage credentials.


    The same endpoints back the MCP server, so anything documented here is
    reachable both ways.
servers:
  - url: https://app.reputably.net
    description: Reputably
  - url: https://your-domain.example
    description: Your own verified white-label domain
security:
  - agentKey: []
tags:
  - name: Businesses
    description: The locations you track, their plan usage and AI-generated insights.
  - name: Reviews
    description: Google and Facebook reviews, including which still need a reply.
  - name: Brand mentions
    description: Mentions across X, Reddit, YouTube, Facebook communities and the open web.
  - name: Brand tracking
    description: The trackers that find mentions, and competitor share of voice.
  - name: Leads
    description: Buying signals detected in mentions, with the public post to reply to.
  - name: AI Visibility
    description: >-
      Whether AI assistants recommend the business, what they cite, and how it
      moves.
  - name: AI Traffic
    description: Which AI crawlers read the website, and who arrives from an AI answer.
  - name: Posts
    description: Google Business Profile posts and drafts.
  - name: Reports
    description: Queued report renders and their CSV output.
  - name: Setup
    description: First-time tracking configuration.
  - name: Account
    description: Workspaces, notifications, sync status and prospect audits.
paths:
  /api/entities/VisibilityRun/{id}:
    get:
      tags:
        - AI Visibility
      summary: Get one AI Visibility run
      description: Reads a single AI Visibility run by id. Ids do not cross workspaces.
      operationId: getVisibilityRun
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: The AI Visibility run id.
        - name: X-Workspace-Id
          in: header
          required: false
          schema:
            type: string
          description: >-
            Which workspace to read. Omit it and you get the account’s home
            workspace, which on an agency account is often not where the live
            businesses are. A workspace this credential cannot read is refused
            with 403 rather than quietly answered from the default.
      responses:
        '200':
          description: The AI Visibility run.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VisibilityRun'
        '401':
          description: Missing or invalid credential.
        '403':
          description: Not readable by this credential, or not in this workspace.
        '404':
          description: No such AI Visibility run in this workspace.
components:
  schemas:
    VisibilityRun:
      type: object
      title: VisibilityRun
      properties:
        id:
          type: string
          description: Unique id.
        tracker_id:
          type: string
        prompt_id:
          type: string
        variant_index:
          type: integer
        prompt_variant:
          type: string
          description: >-
            The exact phrasing asked for this run — stored verbatim so the UI
            can show it even if the prompt's variations are regenerated later.
        location_id:
          type: string
        engine:
          type: string
          description: Engine registry key, e.g. 'chatgpt' | 'gemini'.
        provider:
          type: string
          description: Which backend produced this run.
        model:
          type: string
          description: Exact provider model id used for this run (for reproducibility).
        run_date:
          type: string
          description: YYYY-MM-DD bucket used for daily rollups and dedup.
        run_at:
          type: string
        answer_text:
          type: string
          description: The AI engine's full answer to the prompt.
        brand_mentioned:
          type: boolean
        brand_position:
          type: integer
          description: >-
            1-based rank of the brand among all brands named in the answer; null
            when not mentioned.
        brand_sentiment:
          type: string
          description: >-
            'positive' | 'neutral' | 'negative' | 'mixed' — how the answer
            describes the brand.
        brand_sentiment_score:
          type: number
        competitors_mentioned:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              position:
                type: integer
              domain:
                type: string
          description: >-
            Brands the AI answer recommended as alternatives (discovered, not
            user-supplied). domain is set only when the answer/its citations
            contained it.
        citations:
          type: array
          items:
            type: object
            properties:
              url:
                type: string
              domain:
                type: string
              title:
                type: string
          description: >-
            Sources the engine cited (url_citation annotations / grounding
            chunks).
        brand_entities:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              category:
                type: string
              domain:
                type: string
        brand_cited:
          type: boolean
          description: True when any citation domain matches the tracker's brand_domain.
        competitor_domains_cited:
          type: array
          items:
            type: string
        cost:
          type: number
          description: Optional estimated provider cost for this run, in USD.
  securitySchemes:
    agentKey:
      type: http
      scheme: bearer
      description: >-
        An agent key (`rpk_...`) created in Settings → API & MCP, sent as
        `Authorization: Bearer rpk_...`. Bearer only: a cookie session can never
        drive this API. An OAuth 2.1 access token obtained from the same host
        works identically and lands on the same ceiling.

````