Referencia
Rutas de lectura de la API (endpoints)
La lista completa de rutas GET, generada desde el código del servidor.
Todas son GET https://visibai.app/api/v1/<ruta> con tu clave.
Rutas básicas#
| Ruta | Qué devuelve |
|---|---|
airank | Tu último AI Rank |
airank/history | El historial de tu AI Rank |
clientes | Tus clientes (agencias) |
mediciones | El archivo de mediciones |
respuestas | Las respuestas de los motores (?texto=1 para el texto completo) |
acciones | Tus acciones |
citas | Las citas |
Rutas de inteligencia#
Esta tabla se genera desde el código del servidor, así que está siempre al día. La columna MCP indica la herramienta equivalente.
| Ruta | MCP | Lista paginable | Por cliente (agencias) | Qué devuelve |
|---|---|---|---|---|
GET /api/v1/visibility | visibai_visibilidad | — | ✓ | AI Rank oficial (v1 y v2), método, si es comparable, dimensiones y por qué. |
GET /api/v1/visibility/history | — | puntos | ✓ | — |
GET /api/v1/rank2 | — | — | ✓ | — |
GET /api/v1/prediccion | — | — | — | — |
GET /api/v1/prompts | — | preguntas | — | — |
GET /api/v1/prompt-clusters | visibai_clusters | clusters | — | Clusters de preguntas del panel con sus preguntas y su puntuación de oportunidad. |
GET /api/v1/prompt-gaps | — | huecos | — | — |
GET /api/v1/fanouts | visibai_fanouts | porPrompt | — | Búsquedas internas (fanout) que hacen los motores por pregunta, términos y cobertura de tu web. aiMode: las de Google AI Mode, ESTIMADAS (Google no las publica), con su método y su confianza. |
GET /api/v1/sources | visibai_fuentes | dominios | — | Fuentes por dominio: tipo, autoridad, gaps frente a rivales, oportunidades de cita e inteligencia por fuente (en qué preguntas influye, a qué rival beneficia, dónde te falta, qué afirma, su antigüedad y qué hacer, con su valor). |
GET /api/v1/citations | — | urls | — | — |
GET /api/v1/competitors | visibai_competencia | competidores | — | Competidores clasificados (primario, emergente, descubierto), serie por 100 respuestas, movimiento, temas y alertas. |
GET /api/v1/competitors/battle | visibai_batalla_rival | — | — | Modo batalla con un competidor: por qué aparece más que tú (preguntas, respuestas, visibilidad, recomendación, posición, fuentes, afirmaciones, productos, páginas, reputación), qué hacer y el valor esperado simulado. |
GET /api/v1/perception | visibai_percepcion | atributos | — | Percepción: atributos que las IAs asocian a tu marca y a los rivales (con la frase literal), afirmaciones verificadas contra tus hechos y diagnóstico por atributo (tú frente al rival, fuentes, impacto y acción). |
GET /api/v1/products | visibai_productos | productos | ✓ | Catálogo y productos medidos: presencia, win rate, SKU, precio que dice la IA, atributos y su oportunidad (valor de negocio esperado con 14 dimensiones), ordenados por ella. |
GET /api/v1/shopping | visibai_shopping | merchants | — | Shopping: cuota de preguntas de compra, recomendación en compra, merchants y destino de los enlaces. |
GET /api/v1/crawl | visibai_rastreo | salud | — | Rastreo de bots de IA: salud, propósito, render, sitemap y cruce rastreo → cita. |
GET /api/v1/revenue | visibai_ingresos | porCanal | — | Ingresos desde IA por moneda (sin sumar monedas), producto, landing y embudo, con procedencia; y el AI Conversion Gap (brecha): en qué etapa se pierde el valor del canal IA frente al resto de tu web, con la clase de dato de cada etapa (medido, atribuido, estimado, no disponible), los eventos de conversión de GA4, los pedidos atribuidos, las preguntas en las que no apareces en tus últimas mediciones oficiales y cómo te presentan cuando sí te nombran. |
GET /api/v1/benchmark | visibai_benchmark | cortes | — | Benchmark en percentiles (global, sector, tipo y país) de tu presencia frente al índice público de marcas medidas; con menos de 20 marcas comparables, muestra insuficiente. |
GET /api/v1/experiments | visibai_experimentos | experimentos | — | Experimentos: acción, hipótesis, ventana, objetivo, métrica, antes y después, esperado frente a real, lectura (nunca causal), grupo de comparación (preguntas de la acción frente a las demás), factores externos conocidos, nivel de evidencia, conclusión y aprendizaje por tipo de acción. |
GET /api/v1/demand | visibai_demanda | prompts | — | Demanda de tus preguntas (prompt canónico, tipo de demanda: observada, relativa, estimada o proxy; tendencia; cobertura por cluster). Sin proveedor: not_available, nunca un volumen supuesto. |
GET /api/v1/bgpi | visibai_bgpi | prompts | — | BGPi (VisibAI Prompt & Demand Intelligence) de tus preguntas: observadas en VisibAI (anónimas, k-anónimas), generadas, Google Trends (interés relativo de búsqueda en Google, no volumen de IA) y confianza del dato. VisibAI no dice conocer el volumen global de prompts de IA. |
GET /api/v1/surfaces | visibai_superficies | — | — | Superficies observadas por motor y pregunta (texto, fuentes, anuncios, mapas, shopping…); lo que la API de un motor no expone sale como no disponible. |
GET /api/v1/actions | — | acciones | — | Centro de acciones: cada acción con su ficha (origen, problema, evidencia, objetivo, impacto, € solo con base observada, confianza, esfuerzo, responsable, estado y fecha límite), su fase (detectada, aprobada, en marcha, publicada, midiendo, completada, revertida), lo esperado congelado y el resultado. |
GET /api/v1/triggers | visibai_disparadores | registros | — | Los 16 disparadores (configuración) y el registro de lo que ha saltado: cuándo, datos y qué se hizo. |
GET /api/v1/agent/memory | visibai_memoria_agente | entradas | — | Memoria del agente: cada decisión, lo esperado al tomarla, su registro (problema, evidencias, motivo y ejecución congelados al decidir) y lo observado después (tiempo, cambio, antes y después, factores externos, nivel de evidencia y validación; veredicto por dirección). |
GET /api/v1/agent/os | visibai_agente_estado | — | — | Agente autónomo: última decisión (ACT, REQUIRE_APPROVAL, WAIT, INVESTIGATE_MORE, NO_ACTION) con «¿Por qué?» y «¿Por qué no?», aprobaciones pendientes, proyectos, aprendizaje por palanca y configuración de autonomía. Sin datos, unavailable. |
GET /api/v1/agent/runs | visibai_agente_ejecuciones | runs | — | Ejecuciones del agente (run_id, estado, decisión, resumen); ?id= devuelve la traza completa reconstruible (eventos, hipótesis, evidencia, herramientas, política, dry run, cambios, rollback). |
GET /api/v1/optimizer | visibai_optimizaciones | versiones | — | Optimizador de páginas: versiones (aprobada, borrador creado, exportada, revertida) con su puntuación antes / después y la última optimización. |
GET /api/v1/prompt-research | — | — | — | El último Prompt Research terminado (o en curso): candidatos normalizados, intención, demanda y oportunidad. |
GET /api/v1/ask | — | — | — | Pregunta en lenguaje natural (?pregunta=) respondida solo con tus datos, con «Basado en». |
Ruta pública#
GET /api/v1/airank/:id devuelve un resultado público de AI Rank por su id, sin clave.
Actualizado el
¿Te ha resultado útil este artículo?
Gracias por tu respuesta.
Artículos relacionados
APIRutas de escritura: lanzar una medición, enviar logs y aportar preguntasPOST airank/run, crawl-logs y bgpi/observe, con sus parámetros y límites. APIPaginación, CSV y el parámetro ?clientelimite y cursor, la respuesta paginacion.siguiente, ?format=csv y cómo leer datos de un cliente de agencia. MCPHerramientas MCP de lecturaLa lista de herramientas que solo leen datos, generada desde el código del servidor.
¿No encontraste la respuesta?
Escríbenos y te respondemos. Si tienes cuenta, usa «Contáctanos» en el panel: nos llega con el contexto de tu cuenta.