Reference
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. |
GET /api/v1/sources | visibai_fuentes | dominios | — | Fuentes por dominio: tipo, autoridad, gaps frente a rivales y oportunidades de cita. |
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/perception | visibai_percepcion | atributos | — | Percepción: atributos que las IAs asocian a tu marca y a los rivales (con la frase literal) y afirmaciones verificadas contra tus hechos. |
GET /api/v1/products | visibai_productos | productos | ✓ | Catálogo y productos medidos: presencia, win rate, SKU, precio que dice la IA y atributos. |
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. |
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), 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: evidencia, impacto, estado (también pospuesta), 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 y lo observado después (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.
Updated on
Was this article helpful?
Thanks for your feedback.
Related articles
⌨️ 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.
Didn’t find your answer?
Write to us and we will reply. If you have an account, use “Contact us” in the dashboard: it reaches us with your account context.