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 retrieve or generate your tokens:
Log in to the Mentionlytics app.
Navigate to Settings > API / Access Tokens.
You'll land on the API Tokens page, which is divided into two sections:
User API Tokens
This section contains three tokens tied to your user account:
Your Access Token (API v1 — deprecated)
Bearer Token (API v2)
Refresh Token (API v2)
To copy an existing token, click the copy icon next to it. To generate a new token, click the key+ icon. You'll be prompted to confirm before a new token is created.
⚠️ Note: The Access Token (API v1) is deprecated. It is recommended to use the Bearer Token and Refresh Token for API v2 integrations.
Account Access Tokens
This section lets you manage tokens at the account level. You can view all existing tokens (including their name, status, and expiry) or create a new one by clicking + New Token.
When creating a token, you can set a name and choose an expiration period (default is 30 days).
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)