Update README.md
Update README.md
Merge pull request #17 from erran/documentation

Add example output to all API methods (replacement for #3 which is outdated)