Updates on API and some more text in the README.md