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.

Sí. Una sola solicitud devuelve datos de visibilidad en IA de los seis motores: ChatGPT, Claude, Gemini, Perplexity, Google AI Mode (AI Overviews) 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.

Casi. Los reportes corren 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.

Gestión de marcas (crear, listar, obtener, actualizar, eliminar), reportes de visibilidad en IA en las seis plataformas LLM principales, seguimiento 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.

El acceso a la API para desarrolladores está incluido en todo plan de panel Starter o superior, con un tope mensual de solicitudes por nivel: 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 los créditos mensuales de tu plan, así que nunca pagas dos veces. ¿Quieres la API sola, sin un plan de panel? 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, 2000 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.

A toda clave de API se le aplica un límite de 120 solicitudes por minuto móvil, sin importar el plan. Además, tu plan otorga una cuota mensual de unidades de solicitud. 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`.

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.

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í. El servidor MCP de Rank Prompt permite que Claude Code, Cursor, Claude Desktop o cualquier cliente MCP lea tus reportes, marcas y citas, y corra 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.

La referencia completa está en [/docs/v1/](/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í. 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 seguir tu share of voice en el tiempo y alertar cuando un competidor te supera en una categoría.

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.

Todo plan de panel Starter o superior incluye acceso a la API para desarrolladores, así que puedes generar una clave directamente desde la página de Desarrolladores en tu espacio de trabajo. ¿Quieres la API sola, sin un plan de panel? 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.

No. El acceso a la API para desarrolladores está incluido en tu plan Starter, Pro, Agency o Agency Plus, con un tope mensual de solicitudes que escala por nivel (10 000 / 25 000 / 50 000 / 100 000 solicitudes). 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 no tienes ningún plan de panel, o si quieres una cuota de solicitudes dedicada más grande con sus propios créditos de API incluidos.

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.

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í, 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` y `schedule.run.failed`. 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.

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 corre 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.