added some api docs, largely ripped from twitter's api docs.