add tag API, document new listing function input/output and deprecate old listing function