Update README.md

Better documentation of the api.