La API v2 le permite recuperar sus resultados de menciones en formato JSON, diseñada para ofrecer alto rendimiento y una integración más sencilla con tableros externos, CRMs o herramientas de análisis de datos.
Nota: esta es una API de solo lectura. El acceso de escritura está previsto para el futuro cercano. Actualmente, la adición de palabras clave, trackers y perfiles debe realizarse desde el Tablero de Mentionlytics.
La funcionalidad de la API está disponible en los planes Pro, Business y Enterprise.
Autenticación y seguridad
La API v2 de Mentionlytics usa un sistema de doble token, Bearer Token y Refresh Token, para garantizar una seguridad óptima.
1. Cómo obtener sus credenciales
Para acceder a la API, debe recuperar o generar sus tokens:
Inicia sesión en la app de Mentionlytics.
Ve a Ajustes > API / Access Tokens.
Llegará a la página de API Tokens, que está dividida en dos secciones:
User API Tokens
Esta sección contiene tres tokens asociados a su cuenta de usuario:
Su Access Token, (API v1, obsoleto).
Bearer Token, API v2.
Refresh Token, API v2.
Para copiar un token existente, haz clic en el icono de copiar que aparece junto a él. Para generar un nuevo token, haz clic en el key+ icon. Se le pedirá que confirme antes de crear un nuevo token.
⚠️ Nota: el Access Token, API v1, está obsoleto. Se recomienda usar el Bearer Token y el Refresh Token para integraciones con la API v2.
Account Access Tokens
Esta sección le permite gestionar tokens a nivel de cuenta. Puede ver todos los tokens existentes, incluyendo su nombre, estado y vencimiento, o crear uno nuevo haciendo clic en + New token.
Al crear un token, puede establecer un nombre y elegir un periodo de vencimiento. El valor predeterminado es 30 días.
2. Uso del token, Bearer Auth
Todos los endpoints de la API, excepto los endpoints de autenticación, requieren autenticación. Debe incluir su Bearer Token en el encabezado Authorization de sus solicitudes HTTP.
Ejemplo de encabezado:
Authorization: Bearer <YOUR_ACCESS_TOKEN>
3. Vencimiento y renovación del token
Vencimiento: su Bearer Token es válido durante 1 hora.
Renovación: una vez que el token vence, no necesita generar uno nuevo desde la interfaz. En su lugar, use su Refresh Token mediante el endpoint de renovación de la API para generar un nuevo Bearer Token de forma programática.
Advertencia de seguridad: nunca comparta sus tokens. Trátelos como contraseñas.
Funciones clave y rendimiento
Hemos optimizado la API v2 para velocidad y estabilidad:
Caché: las respuestas de la API se almacenan automáticamente en caché para mejorar los tiempos de respuesta.
Request Coalescing: las solicitudes concurrentes duplicadas se agrupan para reducir la carga del servidor.
Rate Limiting: todos los endpoints están sujetos a límites de uso para garantizar un uso justo y la estabilidad del sistema para todos los usuarios.
Mantenimiento continuo para garantizar soporte para nuevas funciones de la aplicación.
Restricciones importantes, disponibilidad de datos
Algunos Trackers de su cuenta pueden tener límites específicos respecto a los datos disponibles a través de la API en comparación con la Web App.
Fuentes afectadas: los datos recuperados mediante la API para las siguientes fuentes pueden diferir de lo que ve en la Web App de Mentionlytics debido a restricciones de las plataformas:
X, anteriormente Twitter
LinkedIn
Web News
Si necesita más detalles sobre limitaciones específicas de trackers, contacte a su Account Manager.
📚 Documentación técnica completa
Para una guía técnica detallada, incluyendo la lista completa de endpoints, parámetros, esquemas de respuesta y la posibilidad de probar llamadas directamente:
👉 Consulte la documentación completa de la API v2, se requiere autenticación.