Volume streams consist of two streaming endpoints that deliver a random sample of publicly available Tweets in real-time:
- 1% sampled stream. Available at all levels of access.
- 10% sampled stream. Available to Enterprise levels of access. Commonly referred to as the "Decahose."
These are referred to as "volume streams" because they both deliver large volumes of data. Even the 1% stream can emit many dozens of Tweets every second. With these streams, you can identify and track trends, monitor general sentiment, monitor global events, and much more.
These streaming endpoints deliver Tweet objects through a persistent HTTP GET connection and use OAuth 2.0 App-Only authentication. With Essential access, you can have one connection at a time. With all levels of access, connection requests can be made up to 50 times per 15-minute window.
These volume stream endpoints support edited Tweets. These endpoints will deliver edited Tweets, along with its edit history, including an array of Tweet IDs. For Tweets with no edit history, this array will hold a single ID. For Tweets that have been edited, this array contains multiple IDs, arranged in ascending order reflecting the order of edits, with the most recent version in the last position of the array. To learn more about how Tweet edits work, see the Tweet edits fundamentals page.
The 10% sampled stream is an Enterprise endpoint available within our managed access levels only. To use this API, you must first set up an account with our enterprise sales team. Learn more
With Academic Research access, you can utilize Backfill and multiple connections with these streams.
To access these endpoints, you will need:
- An approved developer account.
- To authenticate using the keys and tokens from a developer App that is located within a Project.
Learn more about getting access to the Twitter API v2 endpoints in our getting started guide.