added more examples of api usage