add REST documentation for search module

This is a bit tricky, as it as an additional parameter specific to only one of the search types. I'm going to remove this from here and just keep it limited to the shared ones