updated reamde with more api usage examples