Update README.md

added example for api and convenience functions