tweetstream-no-urllib /

Filename Size Date modified Message
1.5 KB
2.3 KB
683 B

tweetstream - Simple twitter streaming API


tweetstream provides a single 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.

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()


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.

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.