Haskell binding to the Twitter API

Latest on Hackage:0.2.8

This package is not currently in any snapshots. If you're interested in using it, we recommend adding it to Stackage Nightly. Doing so will make builds more reliable, and allow stackage.org to host generated Haddocks.

BSD3 licensed by Sigbjorn Finne
Maintained by Sigbjorn Finne
= hs-twitter - Programming Twitter from Haskell =

'hs-twitter' is a Haskell package providing a binding to
the Twitter API -


The binding is functionally complete (Christmas 2008), letting you write
applications in Haskell that accesses Twitter streams and updates your

For more info on use, please visit: http://haskell.forkIO.com/twitter

= Getting started =

For some code samples showing you how to get started using this
API binding, have a look at Web/Twitter.hs at the top.

= Building and installing =

This package is provided in Cabal form, so only thing you need to
do to get going is:

foo% runghc Setup configure --user # that option being optional
foo% runghc Setup build
foo% runghc Setup install

(or, if you are versed in its ways, "cabal update ; cabal install twitter")

The package depends on a bunch of other packages though, so you
need to have them built&installed, as well. They are:

* HTTP: http://hackage.haskell.org/cgi-bin/hackage-scripts/package/HTTP
* json: http://hackage.haskell.org/cgi-bin/hackage-scripts/package/json
* utf8-string: http://hackage.haskell.org/cgi-bin/hackage-scripts/package/utf8-string
* mime: http://hackage.haskell.org/cgi-bin/hackage-scripts/package/mime

('cabal install' will take care of chasing these down for you, btw..)

= Authentication =

When using this API binding to build your own Twitter applications,
authentication is required ...

= Feedback / question =

Please send them to sof@forkIO.com , and I'll try to respond to them
as best/quickly as possible. (Or, try to send a tweet 'sigbjorn_finne' :-) )



Version 0.2.8 - released 2009-05-27; changes from 0.2.7
* remove default passing of 'source=hs-twitter' argument to
all API actions. The default argument list is now empty.
If you want to configure the 'source=' argument, now use

Web.Twitter.Monad.fromSource :: String -> TM a -> TM a
Web.Twitter.Monad.getSource :: String -> TM (Maybe String)

(Passing in source= to the search APIs causes problems.)

Version 0.2.6/0.2.7 - released 2009-05-20; changes from 0.2.4
* Added social graph API additions (getUserFollowers / getUserFollowing )
* support for default arguments via Web.Twitter.Monad.getDefArgs / withDefaultArgs

Version 0.2.5 - released 2009-02-05; changes from 0.2.4

* Fix bug in percent-encoding UTF-8 content.
(Bug reported by Ilya Kuznetsov; thanks.)

comments powered byDisqus