> ## 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. # Valor de las búsquedas con IA > Consulta el valor mensual estimado, en dólares, de la presencia de un sitio web en las respuestas de búsqueda con IA: un intervalo basado en los datos económicos de las palabras clave de Google. El valor de las búsquedas con IA estima el valor mensual, en dólares, de la presencia de una marca en las respuestas de búsqueda con IA: cuánto vale aparecer, y hacerlo en una posición destacada, cuando ChatGPT, Claude, Perplexity y otros sistemas de IA responden a preguntas de tu mercado. El resultado siempre se devuelve como un **intervalo** y se basa en los datos económicos reales de las palabras clave de Google. > [!NOTE] > > El valor de las búsquedas con IA se está activando por fases. Hasta que se active en tu organización, el endpoint devuelve **403**, como cualquier otro recurso sujeto a permisos. Ponte en contacto con tu representante de AthenaHQ para solicitar acceso durante el despliegue. ## Qué devuelve La respuesta separa el **valor del canal** (cuánto vale el mercado y qué parte captas) de la **contribución** (qué impacto medido genera tu contenido). Estos valores no se suman ni se confunden entre sí. * **`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](#when-a-value-is-stale)). 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 ```bash theme={null} curl "https://api.athenahq.ai/api/v1/ai-search-value?website_id=$WEBSITE_ID" \ -H "x-api-key: $ATHENA_API_KEY" ``` ```json theme={null} { "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 Algunos estados devuelven `200` sin una valoración: * **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. Los sitios web en pausa se tratan como eliminados en toda la API v1 y devuelven `403`. ## Cuándo queda desactualizado un valor `is_stale_value` es `true` cuando un sitio que ya se había valorado cae por debajo del umbral de actividad (menos respuestas de IA en los últimos 28 días de las que exige la revisión) y su valor supera la ventana de actualización. La revisión diaria deja de recalcular el sitio y el intervalo `captured` permanece en su última cifra calculada. El endpoint sigue devolviendo el valor; utiliza `is_stale_value` y `computed_at` para decidir si lo presentas como un valor actual o como la última estimación conocida. ## Límites de solicitudes Se aplican los límites estándar de la API por organización. Si los superas, se devuelve `429` con `Retry-After`. Consulta [Límites de solicitudes](https://docs.athenahq.ai/es/api-reference/rate-limits.md). ## Autenticación Se utiliza la autenticación estándar de AthenaHQ mediante claves de API. Consulta [Autenticación](https://docs.athenahq.ai/es/api-reference/authentication.md). ## Referencia del endpoint Consulta [GET /api/v1/ai-search-value](https://docs.athenahq.ai/es/api-reference/ai-search-value/get-ai-search-value.md) para ver el esquema completo de la consulta y la respuesta. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.