Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A tiny JavaScript library for consuming the Twitter Search API

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 spec
Octocat-spinner-32 src
Octocat-spinner-32 LICENSE
Octocat-spinner-32 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.

Something went wrong with that request. Please try again.