Improve documentation

Add direct API call example, and document the public response properties