new api + updated readme