Fix glitches in api  and correct description in readme