Victus Spiritus


Twitter's List and Search APIs leave much to be desired

13 May 2011

Like polishing up an old wooden rocking chair, over the past several evenings I've been migrating an old Rails application. I was able to get the 3.1beta Rails app (sweet updates) working locally without much trouble. But it's the first Heroku app I've migrated from the 1.8.7 stack to 1.9.2 Badious Bamboo, and it's not quite ready for prime time.

I gutted 20 or so superfluous files and rearranged the interface to incorporate a few visual tricks I've learned since that project went into hibernation. After I was happy with the look and feel I wanted to jazz up the list search functionality and that's where I hit a roadblock.

Twitter's List API Blow's Chunks

I spent a couple of hours digging through the API docs and refreshing myself on limits, paging and returned hash data. There's a straight forward URL to get follow (friend) ids. One call returns up to 5000 friends, with iterative calls returning lists of up to the next 5000 friends:

The next_cursor value in the returned hash allows repeat calls to receive friend lists greater than 5000 accounts. Easy peasy, you'll have a full set of ids in a few API calls even for a super user like Robert Scoble.

But for lists there's no easy way to get back ids or screen_names. List membership requires the following API call:

Each page returns member data on 20 users, so a list of 500 accounts requires 25 consecutive API hits, which blows. The reason I'm returning all list members is to rapidly narrow down search within lists (that's a long URL of +OR+from:). Context is vital to the quality of information we extract from datasets, and being unable to easily sift through collections of data makes the challenging task of refining information from large collections even more cumbersome. A well implemented API could take in a set of criteria and a list name (context) and rapidly extract matches from the twitter stream. Here's to hoping Twitter and future social data services nail this feature.