Tu equipo de datos monta el reporting mensual de marketing en un data warehouse. Tu agencia envía a sus clientes un deck generado desde una hoja de cálculo. Tu dirección general mira un único panel interno y nada más. La visibilidad en IA vive en Mentionable, y mientras nadie copie las cifras a mano, no vive en ningún otro sitio.
La API de Mentionable elimina la copia. Cada cifra del panel está disponible como filas que tus propias herramientas pueden leer, en JSON o CSV, al ritmo que elijas.
¿Qué devuelve la API de Mentionable?
La API de Mentionable es una API REST de solo lectura en /api/v1, con cuatro endpoints, uno por cada pregunta que le haces a tus datos.
¿Qué proyectos puedo leer? GET /api/v1/projects lista los proyectos a los que tu clave tiene acceso: nombre, sitio web, marca, fecha de creación.
¿Cómo evoluciona mi visibilidad? GET /api/v1/projects/{id}/metrics devuelve una fila por día, motor de IA y categoría de prompts: el número de respuestas, las menciones, las citas de tu sitio, la tasa de mención, la tasa de cita, la posición media y el reparto entre sentimiento positivo, neutro y negativo.
¿Qué respondió realmente cada IA? GET /api/v1/projects/{id}/results devuelve una fila por respuesta de IA: la pregunta, el motor, la fecha, si tu marca fue mencionada, en qué posición, con qué sentimiento y cuántos competidores se citaron junto a ti. Los resultados están paginados, del más reciente al más antiguo, hasta 1.000 filas por página.
¿Quién ocupa mi lugar? GET /api/v1/projects/{id}/competitors devuelve una fila por día, motor de IA y marca: la tuya y cada competidor que hayas confirmado, con menciones, posición media y share of voice.
Las definiciones son las del panel. Una tasa de mención en tu warehouse es la misma que tu equipo lee en Mentionable, así que nadie discute qué cifra es la buena.
¿Cómo es una llamada?
Una URL, una clave, filtros opcionales:
curl -H "Authorization: Bearer mnt_sk_..." \
"https://mentionable.ai/api/v1/projects/{id}/metrics?from=2026-09-01&to=2026-09-30&llm=chatgpt,perplexity"
Todos los endpoints aceptan los mismos filtros:
| Parámetro | Qué hace |
|---|---|
from, to |
Periodo, hasta 366 días por llamada. Por defecto, los últimos 30 días. |
llm |
Uno o varios motores de IA, separados por comas. |
categoryId |
Una sola categoría de prompts. |
format |
json (por defecto) o csv. |
limit, cursor |
Tamaño de página y página siguiente, en los resultados. |
Las filas son planas a propósito. Los contadores como mentions y results se suman en cualquier dimensión, por mes, por motor, por categoría, y las tasas se recalculan a partir de ellos: un total mensual coincide con el panel en lugar de promediar porcentajes diarios.
Los errores vuelven en JSON, con un código de máquina y un mensaje legible: falta la clave, oferta requerida, proyecto fuera de alcance, consulta no válida.
¿Dónde está la documentación?
En mentionable.ai/api/v1/docs, una referencia interactiva donde pegas una clave y pruebas cada endpoint. El mismo contrato se publica como archivo OpenAPI en /api/v1/openapi.json, que la mayoría de clientes HTTP, generadores de código y herramientas no-code importan directamente.
¿Cómo se protegen las claves API?
Las claves se crean en Ajustes, MCP, por un propietario o un administrador del espacio de trabajo. La clave completa se muestra una vez, al crearla. Después, la lista solo enseña sus primeros caracteres, su alcance, cuándo se usó por última vez y si está activa, caducada o revocada.
Una clave se puede limitar a una lista de proyectos. Entonces solo lista y lee esos proyectos, y cualquier llamada sobre otro proyecto se rechaza. Una clave nunca lee más que la persona que la creó: si un miembro del equipo solo tiene acceso a dos proyectos, sus claves no llegan a un tercero.
La API solo lee. Ningún endpoint crea, modifica ni borra nada, así que una clave filtrada no puede alterar tu seguimiento. Revócala con un clic y la siguiente llamada se rechaza.
¿Quién usa la API de Mentionable?
Marcas con un equipo de datos. La visibilidad en IA se une al resto de tus datos de marketing en tu warehouse o tu herramienta de BI, junto al tráfico, el paid y el CRM. La revisión semanal de marketing la muestra sin que nadie exporte un archivo.
Agencias. Lleva las métricas de cada cliente al reporting que ya vendes, y dale a un cliente una clave limitada a su proyecto si su equipo quiere los datos en bruto.
Cualquiera con una hoja de cálculo. format=csv y una clave en la URL bastan para que Google Sheets o Excel lean una tabla actualizada.
Si trabajas en Looker Studio, el conector de Looker Studio lee los mismos datos sin código. Si prefieres preguntar en lenguaje natural, el servidor MCP permite a Claude, ChatGPT o Cursor leer tus proyectos con la misma clave.
¿Qué ofertas incluyen la API?
Todas las ofertas de Mentionable, para marcas y agencias, incluyen la API, el servidor MCP y el conector de Looker Studio. También funciona durante la prueba gratuita de 7 días, así que puedes conectar tu reporting antes de suscribirte.
Leer datos por la API no consume nada de tu oferta. El único límite es técnico: 100 peticiones por minuto y por clave, compartidas con el servidor MCP. Por encima, la API responde 429 con una cabecera Retry-After.