About

erlang_twitter is a client library to the Twitter API. Using it is simple:

1> inets:start().
...
2> Auth = {"ngerakines", "secretpassword!"}.
3> twitter_client:status_mentions(Auth, []).
twitter_client:status_mentions({"ngerakines", "secretpassword"}, []).
[{status,"Mon Nov 16 13:07:54 +0000 2009","5764367829",
         "@ngerakines Have a safe trip back. Great seeing you & meeting @jacobvorreuter",
         "web","false","5763249258","10590","false",
         {user,"15592821","Francesco Cesarini","FrancescoC",
...

The module layout is relatively simple and self explanatory. Each of the Twitter API methods map directly to a module function. For example, the Twitter API "statuses/friends_timeline.xml" can be accessed using twitter_client:status_friends_timeline/4.

Each API method function has the same function parameters. They are a string representing the root API url, the login and password for the account and then a list of API method specific arguments. API methods that do not use certain arguments ignore them.

The status and user records as defined in twitter_client.hrl represent statuses and users as returned by API requests.

TODO

• Add support for search.
• Add support for trends.
• Add support for lists.
• Document existing OAuth support.
• Add support for the streaming API.

Contributions

• Harish Mallipeddi
• Joshua Miller