Improve README with API examples

This pull request is for issue #16 (Improve README with API examples)