Fork me on GitHub Streaming API — Twython 3.8.0 documentation
Open Table Of Contents

Streaming API

This section will cover how to use Twython and interact with the Twitter Streaming API.

Streaming Documentation:


The Streaming API requires that you have OAuth 1 authentication credentials. If you don’t have credentials, head over to the authentication section and find out how!

Setting Up Your Streamer


When stream data is sent back to Twython, we send the data through signals (i.e. on_success, on_error, etc.)

Make sure you import TwythonStreamer

from twython import TwythonStreamer

Now set up how you want to handle the signals.

class MyStreamer(TwythonStreamer):
    def on_success(self, data):
        if 'text' in data:

    def on_error(self, status_code, data):

        # Want to stop trying to get data because of the error?
        # Uncomment the next line!
        # self.disconnect()

More signals that you can extend on can be found in the Developer Interface section under Streaming Interface

Filtering Public Statuses

stream = MyStreamer(APP_KEY, APP_SECRET,
                    OAUTH_TOKEN, OAUTH_TOKEN_SECRET)

With the code above, data should be flowing in.