Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
OLD repository: Please see for latest official repository for project.Twitter4R: The most Ruby-like bindings for the REST API by a long way. (Anyone want to take over? I don't have time for Ruby OSS projects any more)
Failed to load latest commit information.
bin Reorganized code
config Commented out require_path from gemspec
examples Added examples for newish graph and profile methods
lib Merge branch 'master' of git:// into tw…
scripts Moved sanity test to more uniform location
spec Added use of screen_name and user_id in users/show to disambiguate wh…
tasks Added metrics tasks
web Updated styles
.gitignore Added gem product to ignore list
CHANGES Updated CHANGES and modified gemspec
MIT-LICENSE Added missing files (hopefully finally?)
README Merged upstread changes from twitter4r-0_3_2 branch
Rakefile Removed metrics rake tasks
pkg-info.yml Added extra_rdoc_files property and value and upped json version depe…
twitter4r.gemspec Upped version to 0.3.2


= Twitter4R

* Project Website -
* Mailing List -

== Developers
* {Susan Potter}[http://SusanPotter.NET] <me at susanpotter dot net>

== Contributors
* Kaiichi Matsunaga <ma2 at lifemedia dot co dot jp> - proxy code suggestion
* Sergio Santos <> - message paging code suggestion
* Adam Stiles <adam at stilesoft dot com> - URI.encode => CGI.escape fix
* Carl Crawley <cwcrawley at gmail dot com> - Friendship get => post fix
* Christian Johansen <christian at cjohansen dot no> - in_reply_to attributes in Twitter::Status
* Harry Love <harrylove at gmail dot com> - added attributes to Twitter::Status
* Filipe Giusti <filipegiusti at gmail dot com> - fixed users/show issue that changed from under us

Design Suggestions:
* Bosco So <rubymeetup at boscoso dot com> - making Twitter::Error a RuntimeError instead of an Exception to prevent irb from crashing out.

== Description
Twitter4R provides an object based API to query or update your Twitter account via pure Ruby.  It hides the ugly HTTP/REST code from your code.

== External Dependencies
* Ruby 1.8 (tested with 1.8.6)
* RSpec gem 1.0.0+ (tested with 1.1.3)
* JSON gem 0.4.3+ (tested with versions: 1.1.1 and 1.1.2)
* jcode (for unicode support)

== Usage Examples
Twitter4R starting with version 0.1.1 and above is organized into seven parts:
* {Configuration API}[link:files/examples/configure_rb.html]
* {Friendship API}[link:files/examples/friendship_rb.html]
* {Messaging API}[link:files/examples/messaging_rb.html]
* {Model API}[link:files/examples/model_rb.html]
* {Status API}[link:files/examples/status_rb.html]
* {Timeline API}[link:files/examples/timeline_rb.html]
* {User API}[link:files/examples/user_rb.html]
Something went wrong with that request. Please try again.