Twitter Offers New Lists API to Developers

Michael Manoochehri, November 4th, 2009

TwitterTwitter has just taken a step toward a richer social experience with its exciting new “lists” feature, which gives users the ability to organize individual accounts into groups. For example, a user can create and share a list of “celebrity” accounts that they follow. Twitter lists may be marked by their creators as public, or kept private for personal use.

In a move sure to be popular with developers, Twitter has added list manipulation features to their API (see our Twitter API profile). Last week, Twitter founder Biz Stone wrote about the significance of the Lists API on the Twitter Blog:

Lists also make it easier to curate tweets into meaningful real-time experiences on your own sites via the Lists API. Media companies are already taking advantage: for example, check out @huffingtonpost’s use of the Lists API in their World Series coverage… We’ve been taking our time rolling out the lists feature to make sure things go smoothly and developers have a chance to begin experimenting with our Lists API.

The Twitter API’s new list functions are still in private beta, and will be rolled out to the public soon. The List API uses the same familiar RESTful interface as other aspects of the Twitter API, and data can be returned in either XML or JSON format. Developers are also able to access data about the number of accounts and tweets associated with a particular list, and to find out whether or not a list has been made public.

Listorious

The Twitter API allows developers to create and update lists, add accounts, and manage user subscriptions to lists. Developers are also able to include list descriptions when creating new lists and query if a user account belongs to a particular list. Another interesting feature of the API is access to the entire collection of a user’s public lists, with the data returned either as a single array, or optionally, broken up into pages.

The Twitter API’s new list features are likely to inspire tons of new apps that take advantage of grouped accounts. Several new sites have already been built using the Lists API: Listorious provides a searchable directory of interesting Twitter lists, while TLISTS is a platform that allows media organizations to publish and manage a large amount of lists at a time. Certainly lots more coming soon.

For a listing of hundreds of mashups that are already using the Twitter API, see our Twitter mashup directory.

Both comments and pings are currently closed.

2 Responses to “Twitter Offers New Lists API to Developers”

November 8th, 2009
at 3:06 pm
Comment by: Twitter Lists « Joseph Kelly

[...] Some significant value and structure may start to emerge with the lists api [...]

February 26th, 2010
at 8:38 pm
Comment by: Josh

Anyone know if Twitter will merge the search and list APIs so that one can filter a list by keywords or other parameters? Lists are useful but even more useful would be the ability to cull tweets about a specific thing or from a specific location from a preset list of users.

Follow the PW team on Twitter

ProgrammableWeb
APIs, mashups and code. Because the world's your programmable oyster.

John Musser
Founder, ProgrammableWeb

Adam DuVander
Executive Editor, ProgrammableWeb. Author, Map Scripting 101. Lover, APIs.