Tres formas de construir sobre tus datos de visibilidad en IA

Sí. La API de visibilidad en búsqueda de IA devuelve JSON sobre REST estándar, así que cualquier cosa que pueda llamar a un endpoint HTTP puede leerla: Looker Studio, Power BI, Tableau, Metabase o un job de warehouse programado. Trae puntajes de visibilidad, tasas de mención, posiciones en el ranking y fuentes citadas por marca y por motor, y crúzalos con tus propias tablas. Las claves de solo lectura (`read:brands`, `read:reports`) hacen que un conector de BI nunca tenga acceso de escritura.

La referencia completa está en /docs/v1/, generada a partir de una especificación OpenAPI 3.1. Cada endpoint documenta sus parámetros, el schema de respuesta y los códigos de error, con ejemplos ejecutables en curl, JavaScript (fetch) y Python (httpx). Como el spec es legible por máquina, también puedes generar un cliente tipado en cualquier lenguaje con openapi-generator, Stainless, Speakeasy o Fern.

Sí. Una sola solicitud devuelve datos de visibilidad en IA de los siete motores: ChatGPT, Claude, Gemini, Perplexity, Google AI Mode (AI Overviews), Muse y Grok. Están normalizados en un solo schema, así que comparas posiciones y citas entre motores sin escribir parsers por plataforma ni mantener seis scrapers distintos.

Sí. Los datos competitivos de visibilidad en búsqueda de IA son parte del payload del reporte: junto a tu propia marca, los reportes devuelven las marcas competidoras que nombró cada motor para el mismo prompt, su posición en la respuesta y las fuentes citadas para ellas. Eso te permite monitorear tu share of voice en el tiempo y alertar cuando un competidor te supera en una categoría.

Casi. Los reportes se ejecutan a demanda o programados, y los webhooks salientes envían `report.completed`, `report.failed`, `schedule.run.completed` y `schedule.run.failed` a tu endpoint en el momento en que una ejecución termina, con payloads firmados con HMAC. No necesitas hacer polling: tus sistemas se enteran de nuevos datos de visibilidad en IA apenas existen.

Sí. La restricción de clave por marca te permite generar una clave acotada a una sola marca, lo que hace prácticos los paneles empresariales de marca blanca por cliente: cada cliente ve solo sus propios datos de visibilidad en IA. Combinado con permisos acotados, escrituras idempotentes y un formato de error estable, la API está construida para sostener integraciones personalizadas en producción.

Gestión de marcas (crear, listar, obtener, actualizar, eliminar), reportes de visibilidad en IA en las siete plataformas LLM principales, monitoreo de citas y fuentes con el Rank Prompt Score, reportes programados, webhooks salientes, además de los endpoints de cuenta (`/v1/me`, `/v1/me/quota`). También puedes conectar un cliente MCP. Las auditorías de marca, la generación de contenido optimizado para IA, las auditorías técnicas de SEO y el outreach están en el roadmap público y se publican bajo el mismo contrato /v1; suscríbete al registro de cambios para seguir las fechas de lanzamiento. La superficie final replica el panel 1 a 1.

Todos los planes incluyen acceso a la API para desarrolladores, también el gratuito, así que puedes generar una clave directamente desde la página de Desarrolladores en tu espacio de trabajo. ¿Quieres una cuota dedicada más grande? Suscríbete a un plan independiente API Starter o API Pro. Cada clave lleva permisos acotados (por ejemplo, `read:brands`, `write:brands`) y una restricción de marca opcional para uso de marca blanca. Las claves llevan el prefijo `rp_live_`, se muestran una sola vez al crearlas y se guardan con hash en la base de datos.

El acceso a la API para desarrolladores está incluido en todos los planes, con un tope mensual de solicitudes por nivel: 1.000 en Free, 10.000 en Starter, 25.000 en Pro, 50.000 en Agency y 100.000 en Agency Plus. Los endpoints /v1 que consumen créditos (los que usan un LLM pago o un backend de búsqueda de terceros) descuentan de tu saldo de créditos, así que nunca pagas dos veces; en Free no hay créditos mensuales, así que recargas antes de ejecutar trabajo facturable. ¿Quieres una cuota dedicada más grande? Dos suscripciones independientes lo cubren: API Starter ($99/mes, 50.000 unidades de solicitud, 500 créditos de API incluidos) y API Pro ($299/mes, 200.000 unidades de solicitud, 2.000 créditos de API incluidos). Todo plan aplica un límite de 120 solicitudes/minuto por clave, y el mapa de costo por endpoint está en la documentación para desarrolladores.

No. El acceso a la API para desarrolladores está incluido en tu plan, con un tope mensual de solicitudes que escala por nivel (1.000 en Free, luego 10.000 / 25.000 / 50.000 / 100.000). Los endpoints /v1 que consumen créditos usan los mismos créditos mensuales que ya pagas, así que no hay nada extra que comprar. Solo sumarías un plan independiente API Starter o API Pro si quieres una cuota de solicitudes dedicada más grande con sus propios créditos de API incluidos.

A toda clave de API se le aplica un límite de 120 solicitudes en cualquier ventana de un minuto, sin importar el plan. Además, tu plan otorga una cuota mensual de unidades de solicitud. La cuota es de la cuenta: toda clave creada en ella, la tuya y las de tu equipo, usa un mismo cupo, y el dueño de la cuenta las ve y puede revocar cualquiera. Cada respuesta medida incluye `X-RP-Quota-Limit`, `X-RP-Quota-Used`, `X-RP-Quota-Remaining` y `X-RP-Quota-Reset` para que administres tu ritmo sin hacer polling. Las llamadas limitadas devuelven un 429 con `Retry-After`.

Todavía no. La API se publica con una especificación OpenAPI 3.1, así que puedes generar clientes idiomáticos en cualquier lenguaje con openapi-generator, oazapfts, hey-api, Stainless, Speakeasy o Fern. La documentación incluye ejemplos en curl, JavaScript (fetch) y Python (httpx) para cada endpoint. Hay SDKs propios de TypeScript y Python en el roadmap.

Los endpoints `GET /v1/me` y `GET /v1/me/quota` cuestan 0 unidades de solicitud y nunca cuentan contra tu cuota, así que puedes validar claves, permisos y firma de solicitudes sin gastar presupuesto. Para pruebas end-to-end completas, genera una clave separada con permisos limitados y úsala contra una marca de prueba.

El contrato /v1 es aditivo. Solo agregamos campos y endpoints; nunca los quitamos ni renombramos en silencio. Cuando un cambio disruptivo es inevitable, publicamos /v2 junto a /v1 con una ventana de descontinuación larga, y anunciamos el retiro de cualquier endpoint vía el header HTTP estándar `Sunset` con mucha anticipación.

Sí. Opcionalmente puedes fijar una clave a una sola marca al crearla (`allowed_brand_id`). La API rechazará cualquier solicitud cuya marca objetivo no coincida, incluso si la clave que llama tiene `write:all`. Esto permite que agencias y plataformas emitan claves por marca a sus clientes sin crear un nuevo espacio de trabajo de Rank Prompt.

Sí, los webhooks están disponibles. Registra un endpoint por marca con `POST /v1/brands/{brand_id}/webhooks` y suscríbete a `report.completed`, `report.failed`, `schedule.run.completed`, `schedule.run.failed` y `local_rank.dropped` (cayó la posición de una sede en Maps). Los payloads se firman con HMAC, el secreto de firma rota (el secreto anterior sigue siendo válido por 24 horas), y un endpoint se autodesactiva tras fallos repetidos. Ya no necesitas hacer polling del estado del reporte desde un worker.

Sí. El servidor MCP de Rank Prompt permite que Claude Code, Cursor, Claude Desktop o cualquier cliente MCP lea tus reportes, marcas y citas, y ejecute reportes en tu nombre. Te conectas por OAuth en el navegador, así que no hay ninguna clave que pegar. Mira la página del servidor MCP en rankprompt.com/mcp para la configuración de 30 segundos.

Autenticación por bearer token sobre TLS, con permisos acotados por recurso. Las llamadas CORS desde el navegador se bloquean en el borde: la API es solo servidor a servidor. Las claves se guardan con hash y enviamos el prefijo `rp_live_` al escaneo de secretos de GitHub, así que las claves filtradas se detectan automáticamente. La API funciona sobre la misma infraestructura reforzada que el resto de la plataforma Rank Prompt, con opciones de residencia de datos en la UE y EE. UU.