The API v2 allows you to retrieve your mention results in JSON format, designed for high performance and easier integration with external dashboards, CRMs, or data analysis tools.
Note: This is a read-only API. Write access is planned for the near future. Currently, adding keywords (trackers) and profiles must be done through the Mentionlytics Dashboard.
API functionality is available in Pro, Business and Enterprise plans.
Authentication & Security
The Mentionlytics API v2 uses a Dual-Token System (Bearer & Refresh Tokens) to ensure optimal security.
1. How to get your Credentials
To access the API, you need to generate your initial tokens:
Log in to the Mentionlytics App.
Navigate to Settings > User Setup.
Click on Get API Token.
Copy and store the Bearer and Refresh Token
You will receive a Bearer Token and a Refresh Token. Copy and store them securely immediately.
2. Using the Token (Bearer Auth)
All API endpoints (except authentication endpoints) require authentication. You must include your Bearer token in the Authorization header of your HTTP requests.
Example Header:
Authorization: Bearer <YOUR_ACCESS_TOKEN>
3. Token Expiration & Refreshing
Expiration: Your Bearer token is valid for 1 hour.
Refreshing: Once the token expires, you do not need to generate a new one from the UI. Instead, use your Refresh Token via the API's refresh endpoint to generate a new Bearer token programmatically.
Security Warning: Never share your tokens. Treat them like passwords.
Key Features & Performance
We have optimized API v2 for speed and stability:
Caching: API responses are automatically cached to improve response times.
Request Coalescing: Duplicate concurrent requests are coalesced to reduce server load.
Rate Limiting: All endpoints are subject to rate limiting to ensure fair usage and system stability for all users.
Continuous maintenance ensuring support for new application features.
Important Restrictions (Data Availability)
Some Trackers in your account may have specific limits regarding the data available through the API vs the Web App.
Affected Sources: The data retrieved via API for the following sources may differ from what you see in the Mentionlytics Web App due to platform restrictions:
X (formerly Twitter)
LinkedIn
Web News
If you require more details about specific tracker limitations, please contact your account manager.
📚 Full Technical Documentation
For a detailed technical guide, including a full list of endpoints, parameters, response schemas, and the ability to test calls directly:
👉 View the Full API v2 Documentation (Authentication required)