return data formatted for our api, update README