Update README.md

Updated Readme for a more extended description of the API.