Referència
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.
Actualitzat el
T’ha estat útil aquest article?
Gràcies per la teva resposta.
Articles relacionats
⌨️ 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 has trobat la resposta?
Escriu-nos i et respondrem. Si tens compte, fes servir «Contacta’ns» al panell: ens arriba amb el context del teu compte.