The Twitter API is a mess.

I’m not going to go into the details of the API, but it’s a mess. The API is a mess because Twitter has a mess of an API. It’s not just that the API is poorly documented, it’s that the API is poorly designed.

The API is poorly designed because Twitte