X API v2 has a Post consumption cap that limits the number of Posts that you can receive from a set of endpoints on a monthly basis. Post caps apply at the Project-level, meaning that any requests to the endpoints listed below using the keys and tokens from developer Apps within that Project will count towards the Project Post cap.
Limited v2 endpoints
Posts you receive from any of the following endpoints count towards this monthly Post cap:
- Posts Lookup
- Recent search
- Full-archive search
- Filtered stream
- User Post timeline
- User mention timeline
- Likes lookup - Posts liked by a user
- Bookmarks lookup - Posts bookmarked by a user
- List Posts lookup
- Spaces Lookup
Note:
If the same Post is returned from multiple queries during a day, then the Post is only counted once against the post cap - i.e, the Posts are deduplicated.
Dedupe Counter gets reset on a daily basis.
Post cap volumes
The Post cap volume depends on your access level:
| Free tier | 500 Posts per month |
| Basic tier | 10,000 Posts per month |
| Pro tier | 1,000,000 Posts per month |
| Enterprise tier | 50+ million Posts per month |
You can check your usage towards the monthly Post cap by viewing the main dashboard page in the developer portal. Under the name of your Project, you'll see a status bar that illustrates your current month’s usage in relation to the Post cap. You will also see the number of Posts you pulled this month, the percentage of Posts used in relation to the cap, and the date your Post cap usage resets.