Skip to content

dbrown/twitter-search

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

A Twitter Search client for Ruby.

Access the Twitter Search API from your Ruby code.

Usage

Install the gem.

sudo gem install dancroak-twitter-search -s http://gems.github.com

Require the gem.

require 'twitter_search'

Set up a TwitterSearch::Client. Name your client (a.k.a. 'user agent') to something meaningful, such as your app's name. This helps Twitter Search answer any questions about your use of the API.

@client = TwitterSearch::Client.new 'politweets'

Request tweets by calling the query method of your client. It takes either a String or a Hash of arguments.

@tweets = @client.query 'twitter search'

The String form uses the default Twitter Search behavior, which in this example finds tweets containing both "twitter" and "search". It is identical to the more verbose, explicit version:

@tweets = @client.query :q => 'twitter search'

Use the Twitter Search API's query operators with the :q key to access a variety of behavior.

Search Operators

The following operator examples find tweets...

Foreign Languages

The Twitter Search API supports foreign languages, accessible via the :lang key. Use the ISO 639-1 codes as the value:

@tweets = @client.query :q => 'programmé', :lang => 'fr'

Pagination

Alter the number of Tweets returned per page with the :rpp key. Stick with 10, 15, 20, 25, 30, or 50.

@tweets = @client.query :q => 'Boston Celtics', :rpp => '30'

Gotchas

  • Searches are case-insenstive.

  • The "near" operator available in the Twitter Search web interface is not available via the API. You must geocode before making your Twitter Search API call, and use the :geocode key in your request using the pattern lat,lngmi or lat,lngkm:

      @tweets = @client.query :q => 'Pearl Jam', :geocode => '43.4411,-70.9846mi'
    
  • Searching for a positive attitude :) returns tweets containing the text :), =), :D, and :-)

Authors

Written by Dustin Sallings (dustin@spy.net), forked by Dan Croak (dcroak@thoughtbot.com).

Resources

License

MIT License, same terms as Ruby.

About

Ruby wrapper for the Twitter Search API. Forked from Dustin Sallings' ruby-summize gem.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages