This endpoint was recently graduated from Twitter Developer Labs, and is the replacement of v1.1 statuses/sample and Labs sampled stream. If you are currently using this endpoint, you can use our migration materials to start working with this new endpoint. 

Learn more about the new Twitter API v2: Early Access.


The sampled stream endpoint delivers a roughly 1% random sample of publicly available Tweets in real-time. With it, you can identify and track trends, monitor general sentiment, monitor global events, and much more.

This streaming endpoint delivers Tweet objects through a persistent HTTP GET connection, and uses OAuth 2.0 Bearer Token authentication. You can connect one client per session, and can disconnect and reconnect no more than 50 times per 15 minute window.

If you are using the academic research product track, you can utilize the recovery and redundancy features, redundant connections and backfill, to maximize your streaming up-time and recover up to five minutes of data that you might have missed during a disconnection. 

To access this endpoint, you must have an approved developer account, and have activated the new developer portal. When authenticating, you must use 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" page.

Was this document helpful?
Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?
Thank you for the feedback. Your comments will help us improve our documents in the future.