Valor de las búsquedas con IA

​

Qué devuelve

• market: valor mensual al que puedes acceder con los temas que sigues (value_usd_mo), porcentaje de esos temas que tienen una valoración (coverage_pct) y cuota de voz en IA ponderada por valor (current_sov_pct).
• captured / headroom: bandas de valor (conservative, expected, upside) para el valor que ya captas y el que todavía puedes captar.
• measured_responses: número de respuestas de IA de los últimos 28 días en las que se basa el cálculo. Un cero significa que todavía no se ha tomado una muestra del mercado y el sitio sigue recopilando datos.
• is_stale_value: true cuando se ha valorado el sitio, pero su actividad ha caído por debajo del umbral de actualización y el valor ha dejado de mantenerse (consulta Cuándo queda desactualizado un valor). El valor sigue devolviéndose; interprétalo como la última cifra conocida.
• topics: detalle por tema: categoría, cuota ponderada por posición, porcentaje de menciones, tamaño de la muestra y bandas propias de valor captado y potencial. counted_in_total indica qué filas se incluyen en los totales principales; los mercados canónicos duplicados solo se cuentan una vez.
• merge_suggestions: pares de temas casi duplicados que conviene combinar.
• contribution.modeled_attributed: parte del valor captado que se atribuye al contenido que has publicado, junto con attributed_share y attribution_unavailable. Este último distingue la ausencia de contenido atribuido de un fallo al consultar la atribución.
• forecast: cuando existe una previsión activa, muestra la variación real de la cuota frente al escenario de no intervenir.

​

Primeros pasos

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
}

​

Cómo interpretar el resultado

• Es un intervalo. Comunica la banda de valores, en lugar de una sola cifra en dólares. La amplitud refleja la incertidumbre real sobre cómo se convierte en valor el volumen de respuestas de IA.
• current_sov_pct suele ser menor que la cifra del gráfico de cuota de voz, de forma deliberada. La métrica de cuota de voz cuenta por igual cada mención de marca en todos los temas, incluidas tus propias consultas de marca, en las que sueles dominar. current_sov_pct se pondera por posición, se mide solo en los temas comerciales sin marca y se pondera según el valor de mercado de cada tema. Así, los temas de mayor valor en los que compites realmente tienen más peso. Por eso es normal que el resultado sea menor: es el comportamiento previsto de la métrica.
• El valor del canal y la contribución se mantienen separados. market, captured y headroom dimensionan la oportunidad; contribution mide el impacto de tu contenido publicado. No los sumes.

​

Cuándo no hay un valor disponible

• Recopilando datos: computed_at es null o has_computed_valuations es false. El mercado aún no ha acumulado suficientes respuestas de IA para obtener un cálculo fiable. Normalmente se completa en uno o dos días de análisis.
• Sin mercado al que acceder: has_computed_valuations es true, pero market.value_usd_mo es 0. Ninguno de los temas que sigues se corresponde con una demanda de búsqueda valorada.

​

Cuándo queda desactualizado un valor

​

Límites de solicitudes

​

Autenticación

​

Referencia del endpoint