AI Search Value

​

Ce que vous recevez

• market — valeur mensuelle accessible de vos sujets suivis (value_usd_mo), part de ces sujets valorisée (coverage_pct) et votre part de voix IA pondérée par la valeur (current_sov_pct).
• captured / headroom — fourchettes (conservative, expected, upside) pour la valeur déjà captée et la valeur encore disponible.
• measured_responses — nombre de réponses IA sur 28 jours à l’appui de l’estimation. Zéro signifie que le marché n’a pas encore été échantillonné et que le site est toujours en phase de collecte.
• is_stale_value — true lorsque le site a été valorisé, mais est depuis passé sous le seuil d’actualisation et que sa valeur n’est plus entretenue (voir Quand une valeur est obsolète). La valeur est toujours renvoyée ; traitez-la comme la dernière estimation connue et non comme une valeur actuelle.
• topics — détail par sujet : catégorie, part pondérée par la position, taux de mention, taille de l’échantillon et fourchettes de valeur captée et disponible de chaque sujet. L’indicateur counted_in_total identifie les lignes incluses dans les totaux principaux (les marchés canoniques en double ne sont comptés qu’une fois).
• merge_suggestions — paires de sujets presque identiques qu’il serait utile de fusionner.
• contribution.modeled_attributed — portion de la valeur captée attribuable à vos contenus publiés, accompagnée de attributed_share et de l’indicateur attribution_unavailable, qui distingue l’absence de contenu attribué d’un échec de lecture de l’attribution.
• forecast — lorsqu’une prévision active existe, variation de part effectivement obtenue par rapport au scénario sans action.

​

Démarrage rapide

curl "https://api.athenahq.ai/api/v1/ai-search-value?website_id=$WEBSITE_ID" \
  -H "x-api-key: $ATHENA_API_KEY"

{
  "assumptions_version": "2026.06",
  "computed_at": "2026-06-20T07:14:02.000Z",
  "has_computed_valuations": true,
  "is_stale_value": false,
  "market": {
    "value_usd_mo": 105100,
    "topics_priced": 18,
    "topics_total": 20,
    "coverage_pct": 90.0,
    "current_sov_pct": 12.4
  },
  "captured": { "conservative": 45000, "expected": 58500, "upside": 90000 },
  "headroom": { "conservative": 60100, "expected": 46600, "upside": 15100 },
  "measured_responses": 2843,
  "topics": [
    {
      "topic_id": "9f1c…",
      "category": "market_segment",
      "local_intent": false,
      "share_basis": "pw_sov",
      "pw_sov_pct": 11.8,
      "mix_adjusted_share_pct": 12.4,
      "mention_rate_pct": 31.2,
      "drift_pp": 0.4,
      "standard_error_pp": 1.1,
      "responses_28d": 412,
      "models_measured": 4,
      "personas_measured": 3,
      "locations_measured": 2,
      "captured": { "conservative": 3200, "expected": 4100, "upside": 6300 },
      "headroom": { "conservative": 4800, "expected": 3900, "upside": 1700 },
      "counted_in_total": true
    }
  ],
  "merge_suggestions": [],
  "contribution": {
    "modeled_attributed": {
      "conservative": 5400,
      "expected": 7000,
      "upside": 10800
    },
    "attributed_share": 0.12,
    "attribution_unavailable": false
  },
  "forecast": null
}

​

Interpréter le résultat

• Il s’agit d’une fourchette, pas d’une valeur ponctuelle. Présentez l’intervalle, pas un montant unique en dollars. L’écart reflète l’incertitude réelle sur la conversion du volume de réponses IA en valeur.
• current_sov_pct est volontairement inférieur à votre graphique de part de voix. La métrique Part de voix compte chaque mention de marque de la même façon sur tous les sujets, y compris les requêtes portant sur votre marque, où vous dominez naturellement. current_sov_pct est pondéré par la position, mesuré uniquement sur vos sujets commerciaux hors marque et pondéré par la valeur de marché de chaque sujet : les sujets à forte valeur où vous êtes réellement en concurrence déterminent donc le résultat. Une valeur plus basse est attendue ; elle traduit le fonctionnement prévu de la métrique, pas une incohérence.
• La valeur du canal et la contribution sont distinctes. market / captured / headroom évaluent l’opportunité ; contribution mesure l’impact de vos contenus publiés. Ne les additionnez pas.

​

Quand aucune valeur n’est disponible

• Collecte de données — computed_at vaut null ou has_computed_valuations vaut false. Le marché n’a pas encore accumulé assez de réponses IA pour une estimation fiable ; la valeur apparaît généralement après un ou deux jours de collecte.
• Aucun marché accessible — has_computed_valuations vaut true, mais market.value_usd_mo vaut 0. Aucun sujet suivi ne correspond à une demande de recherche valorisée.

​

Quand une valeur est obsolète

​

Limites de requêtes

​

Authentification

​

Référence de l’endpoint