update README with more examples of API