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 code429 (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.