update readme with more API usage info