> ## 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.

# Obtenir la valeur de recherche IA

> Valeur de la recherche IA pour un site web : valeur de marché des sujets, plage de valeur captée, potentiel inexploité, couverture, part de voix IA pondérée par la valeur, détails par sujet et contribution attribuée modélisée.



## OpenAPI

````yaml fr/api-reference/openapi.json get /api/v1/ai-search-value
openapi: 3.1.0
info:
  title: API AthenaHQ
  description: >-
    L’API AthenaHQ permet de gérer vos sites et prompts par programme pour
    l’optimisation de contenu par IA.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
  - url: https://api.athenahq.ai
    description: Serveur de production
security:
  - apiKey: []
tags:
  - name: Basics
    description: Opérations API principales pour gérer sites et prompts
  - name: Metrics
    description: Points de terminaison de métriques et analyses de visibilité IA
  - name: Billing
    description: Points de facturation et crédits pour gérer la consommation
  - name: Team Management
    description: Points de terminaison de gestion des membres et invitations
  - name: Groups
    description: Points de terminaison de gestion des groupes de sites
  - name: Content
    description: >-
      Points de terminaison Content Hub : onglets, URL suivies et détail des
      prompts par URL.
  - name: Pitch Workspace
    description: >-
      Points de terminaison des rapports Pitch Workspace : exécutions à
      l’échelle de l’organisation avec concurrents, prompts, attributs et
      métriques agrégées.
  - name: Knowledge Base
    description: >-
      Endpoints de lecture de la base de connaissances de la marque — faits
      approuvés et piliers qui les organisent.
paths:
  /api/v1/ai-search-value:
    get:
      tags:
        - AI Search Value
      summary: Obtenir la valeur de recherche IA
      description: >-
        Valeur de la recherche IA pour un site web : valeur de marché des
        sujets, plage de valeur captée, potentiel inexploité, couverture, part
        de voix IA pondérée par la valeur, détails par sujet et contribution
        attribuée modélisée.
      operationId: getAiSearchValue
      parameters:
        - name: website_id
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Réussite
          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: 'Requête incorrecte : échec de la validation'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          description: Non authentifié
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '403':
          description: Interdit
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '404':
          description: Introuvable
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '409':
          description: Conflit
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '429':
          description: Limite de débit atteinte
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '500':
          description: Erreur interne
          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: >-
        Clé API d’authentification. Créez-en une
        [ici](https://app.athenahq.ai/organization?tab=api).

````

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