update readme with new api examples