add more examples on how to use the API