add REST documentation for search module

A bit more documentation about what each of these means is probably worthwhile