add REST documentation for search module

It could be done, this is just almost identical to how it's represented by swagger. If we want to change it, I'd say it should be opened as an issue against restjsdoc.