api method added + readme about it