A tiny JavaScript library for consuming the Twitter Search API
JavaScript Ruby
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
spec
src
LICENSE
README.md

README.md

Twitcher

The term 'twitcher', sometimes misapplied as a synonym for birder, is reserved for those who travel long distances to see a rare bird that would then be "ticked", or checked off, on a list. (...) The main goal of twitching is often to accumulate species on one's lists. Some birders engage in competition to accumulate the longest species list. The act of the pursuit itself is referred to as a "twitch" or a "chase". A rare bird that stays put long enough for people to see it is "twitchable" or "chaseable".

http://en.wikipedia.org/wiki/Birdwatching#Birding.2C_birdwatching_and_twitching

Twitcher is a tiny JavaScript library for consuming the Twitter Search API.

...but really it is just some Twitter specific stuff on top of a simple JSONP interface.

Here is how it works

var tooter = Twitcher('from:markwunsch');
tooter.load(function(response){
	alert("Alright I'm finished loading Tweets from the Twitter Search API!");
});

then you can do stuff like this:

tooter.complete

will be true if tooter.load() has completed

tooter.successful

will be true if tooter.load() has responded successfully

tooter.response

will contain the full response

tooter.tweets()

will return all the tweets in the search results. you can loop over them like this:

tooter.tweets(function(tweet){
	tweet.from_user 
	// that's who wrote the tweet
	
	tweet.profile_image_url 
	// that's their little avatar
	
	tweet.source 
	// that's a link to the program they used to write their tweet
	
	tweet.id 
	// that's the tweet id
	
	tweet.text 
	// that's the tweet
});

You can do the same thing this way: tooter.each_tweet

That's it

You just get a nice interface to the Twitter Search API.

It doesn't do anything else.

Thanks.