The 1% sampled stream endpoint is the Twitter API v2 versions of the v1.1 GET statuses/sample endpoint. To see what's new with v2, you can view our migration guide.

Learn more about the new Twitter API v2.

Introduction

1% sampled stream

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 App-Only authentication. You can connect one client per session, and can disconnect and reconnect no more than 50 times per 15 minute window.

If you have Academic Research access, 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. 

Account setup

To access these endpoints, you will need:

Learn more about getting access to the Twitter API v2 endpoints in our getting started guide.