count and offset are now working correctly
documented api and schema; updated readme