Skip to main content

Simple Twitter streaming API access

Project description


tweetstream provides a class, TweetStream, that can be used to get tweets from Twitter’s streaming API. An instance of the class can be used as an iterator. In addition to fetching tweets, the object keeps track of the number of tweets collected and the rate at which tweets are received.

There’s also a ReconnectingTweetStream class that handles automatic reconnecting.

Twitter’s documentation about the streaming API can be found here: .

Note that the API is blocking. If for some reason data is not immediatly available, calls will block until enough data is available to yield a tweet.


Printing all incomming tweets:

>>> stream = tweetstream.TweetStream("username", "password")
>>> for tweet in stream:
...     print tweet

The stream object can also be used as a context, as in this example that prints the author for each tweet as well as the tweet count and rate:

>>> with tweetstream.TweetStream("username", "password") as stream
...     for tweet in stream:
...         print "Got tweet from %-16s\t( tweet %d, rate %.1f tweets/sec)" % (
...                 tweet["user"]["screen_name"], stream.count, stream.rate )

Simple tweet fetcher that sends tweets to an AMQP message server using carrot:

>>> from carrot.messaging import Publisher
>>> from carrot.connection import AMQPConnection
>>> from tweetstream import TweetStream
>>> amqpconn = AMQPConnection(hostname="localhost", port=5672,
...                           userid="test", password="test",
...                           vhost="test")
>>> publisher = Publisher(connection=amqpconn,
...                       exchange="tweets", routing_key="stream")
>>> with TweetStream("username", "password") as stream:
...    for tweet in stream:
...        publisher.send(tweet)
>>> publisher.close()


See the CHANGELOG file


The author is Rune Halvorsen <>. The project resides at . If you find bugs, or have feature requests, please report them in the project site issue tracker. Patches are also very welcome.


This software is licensed under the New BSD License. See the LICENCE file in the top distribution directory for the full license text.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tweetstream, version 0.2
Filename, size File type Python version Upload date Hashes
Filename, size tweetstream-0.2.tar.gz (4.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page