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

# Get AI Search Value

> AI Search Value for a website: topic-market value, captured value range, headroom, coverage, value-weighted AI share of voice, per-topic detail, and modeled attributed contribution.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/ai-search-value
openapi: 3.1.0
info:
  title: AthenaHQ API
  description: >-
    AthenaHQ API provides programmatic access to manage your websites and
    prompts for AI-powered content optimization.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
  - url: https://api.athenahq.ai
    description: Production server
security:
  - apiKey: []
tags:
  - name: Basics
    description: Core API operations for managing websites and prompts
  - name: Metrics
    description: Metrics and analytics endpoints for tracking AI visibility
  - name: Billing
    description: Billing and credits endpoints for managing usage
  - name: Team Management
    description: Endpoints for managing team members and invitations
  - name: Groups
    description: Endpoints for managing groups of websites
  - name: Content
    description: >-
      Endpoints for accessing Content Hub data — tabs, tracked URLs, and per-URL
      prompt breakdowns.
  - name: Pitch Workspace
    description: >-
      Endpoints for accessing pitch workspace reports — org-scoped pitch runs
      with competitors, prompts, attributes, and aggregate metrics.
  - name: Knowledge Base
    description: >-
      Endpoints for reading the brand Knowledge Base — approved brand facts and
      the pillars that organize them.
paths:
  /api/v1/ai-search-value:
    get:
      tags:
        - AI Search Value
      summary: Get AI Search Value
      description: >-
        AI Search Value for a website: topic-market value, captured value range,
        headroom, coverage, value-weighted AI share of voice, per-topic detail,
        and modeled attributed contribution.
      operationId: getAiSearchValue
      parameters:
        - name: website_id
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  assumptions_version:
                    anyOf:
                      - type: string
                      - type: 'null'
                  computed_at:
                    anyOf:
                      - type: string
                      - type: 'null'
                  has_computed_valuations:
                    type: boolean
                  is_stale_value:
                    type: boolean
                  market:
                    type: object
                    properties:
                      value_usd_mo:
                        type: number
                      topics_priced:
                        type: number
                      topics_total:
                        type: number
                      coverage_pct:
                        type: number
                      current_sov_pct:
                        type: number
                    required:
                      - value_usd_mo
                      - topics_priced
                      - topics_total
                      - coverage_pct
                      - current_sov_pct
                  captured:
                    type: object
                    properties:
                      conservative:
                        type: number
                      expected:
                        type: number
                      upside:
                        type: number
                    required:
                      - conservative
                      - expected
                      - upside
                  headroom:
                    type: object
                    properties:
                      conservative:
                        type: number
                      expected:
                        type: number
                      upside:
                        type: number
                    required:
                      - conservative
                      - expected
                      - upside
                  measured_responses:
                    type: number
                  topics:
                    type: array
                    items:
                      type: object
                      properties:
                        topic_id:
                          type: string
                        category:
                          type: string
                        local_intent:
                          type: boolean
                        share_basis:
                          type: string
                        pw_sov_pct:
                          type: number
                        mix_adjusted_share_pct:
                          type: number
                        mention_rate_pct:
                          type: number
                        drift_pp:
                          type: number
                        standard_error_pp:
                          type: number
                        responses_28d:
                          type: number
                        models_measured:
                          type: number
                        personas_measured:
                          type: number
                        locations_measured:
                          type: number
                        captured:
                          type: object
                          properties:
                            conservative:
                              type: number
                            expected:
                              type: number
                            upside:
                              type: number
                          required:
                            - conservative
                            - expected
                            - upside
                        headroom:
                          type: object
                          properties:
                            conservative:
                              type: number
                            expected:
                              type: number
                            upside:
                              type: number
                          required:
                            - conservative
                            - expected
                            - upside
                        counted_in_total:
                          type: boolean
                      required:
                        - topic_id
                        - category
                        - local_intent
                        - share_basis
                        - pw_sov_pct
                        - mix_adjusted_share_pct
                        - mention_rate_pct
                        - drift_pp
                        - standard_error_pp
                        - responses_28d
                        - models_measured
                        - personas_measured
                        - locations_measured
                        - captured
                        - headroom
                        - counted_in_total
                  merge_suggestions:
                    type: array
                    items:
                      type: object
                      properties:
                        topic_id_a:
                          type: string
                        topic_id_b:
                          type: string
                        name_a:
                          type: string
                        name_b:
                          type: string
                        similarity:
                          type: number
                      required:
                        - topic_id_a
                        - topic_id_b
                        - name_a
                        - name_b
                        - similarity
                  contribution:
                    type: object
                    properties:
                      modeled_attributed:
                        anyOf:
                          - type: object
                            properties:
                              conservative:
                                type: number
                              expected:
                                type: number
                              upside:
                                type: number
                            required:
                              - conservative
                              - expected
                              - upside
                          - type: 'null'
                      attributed_share:
                        anyOf:
                          - type: number
                          - type: 'null'
                      attribution_unavailable:
                        type: boolean
                    required:
                      - modeled_attributed
                      - attributed_share
                      - attribution_unavailable
                  forecast:
                    anyOf:
                      - type: object
                        properties:
                          id:
                            type: string
                          created_at:
                            type: string
                          days_elapsed:
                            type: number
                          share_delta_pp:
                            type: number
                          share_vs_do_nothing_pp:
                            type: number
                          captured_delta_expected:
                            type: number
                        required:
                          - id
                          - created_at
                          - days_elapsed
                          - share_delta_pp
                          - share_vs_do_nothing_pp
                          - captured_delta_expected
                      - type: 'null'
                required:
                  - assumptions_version
                  - computed_at
                  - has_computed_valuations
                  - is_stale_value
                  - market
                  - captured
                  - headroom
                  - measured_responses
                  - topics
                  - merge_suggestions
                  - contribution
                  - forecast
        '400':
          description: Bad Request — validation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '429':
          description: Rate Limited
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. You can create one
        [here](https://app.athenahq.ai/organization?tab=api).

````