Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Ruby gem for searching for data from Twitter's web pages instead of the API, which provides limited search results

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 doc
Octocat-spinner-32 examples
Octocat-spinner-32 lib
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore
Octocat-spinner-32 History.txt
Octocat-spinner-32 README
Octocat-spinner-32 twitterscour-0.2.1.gem
Octocat-spinner-32 twitterscour.gemspec
Octocat-spinner-32 twitterscour.rb
README
= twitterscour gem

This gem is on Gemcutter, simply type "gem install twitterscour" to install it.

Code is available on github at http://github.com/brentsowers1/twitterscour

Class for retrieving lists of tweets.  For user tweet searches, this gem uses
the actual Twitter web pages rather than the API.  The API that other twitter
gems use returns only what Twitter considers the "most popular" tweets in many
cases, this returns all tweets that you can see if you go to the web page
directly.  TwitterScour is the main class to use.  There is no need to
instantiate it, two class methods are provided to search for tweets.  These will
return an array of Tweet objects.  Location info can be retrieved on tweets
as well.

WARNING - the user tweet search capability should probably not be relied upon
for a production system.  Because it uses the structure of the Twitter web pages
as they are now, it could break if Twitter changes the structure of their web
page.  Unlike the API, which the search term search uses, Twitter makes no
guarantees of consistency for their web pages.

Note that this gem needs the gems HTTParty, Nokogiri, and json_pure.  HTTParty should
install without any trouble when you install this.  For Nokogiri, follow
the instructions here to install if you get an error:
http://nokogiri.org/tutorials/installing_nokogiri.html

== Examples:

Get the 40 most recent tweets from me (@sowersb), with location info on all
tweets:
  require 'twitterscour'
  brent_tweets = TwitterScour.from_user('sowersb', 2, true)

Get the 45 most recent tweets with the term Ruby in the tweet.
  require 'twitterscour'
  ruby_tweets = TwitterScour.search_term('Ruby', 3)

Author:: Brent Sowers (mailto:brent@coordinatecommons.com)
License:: You're free to do whatever you want with this

To post comments about this gem, visit my blog post at
http://rails.brentsowers.com/2010/11/new-twitterscour-gem.html

See more gems by me, my blog posts, etc. at http://coordinatecommons.com.
Something went wrong with that request. Please try again.