What is the Mentions Cap?
The Mentions Cap is a monthly limit on how many raw mentions can be retrieved through Listen API. It defines the maximum number of mentions your account can extract within a given calendar month.
This cap is predefined during your contract negotiation and varies depending on your subscription plan.
Default Limits by API Tier
| API Tier | Monthly Mentions Cap |
|---|---|
| Basic (Free) | 10K mentions |
| Enterprise | Up to 100M mentions (negotiable) |
Key Points
- The cap resets monthly.
- Once your account reaches its limit, you will not be able to retrieve more mentions until the cap resets or your limit is increased.
- The cap applies across all Listen API endpoints that return mentions — including search, stream, and export endpoints.
- When the cap is reached, all endpoints that return mentions will respond with HTTP status code
429(Too Many Requests) and include a message indicating that the monthly mentions cap has been exceeded. - No additional mentions are accessible, even if data exists, once the cap is reached.
For best results, design your queries carefully and monitor usage regularly. If you're building an integration or running large-scale analyses, always take the mentions cap into account to avoid disruptions.