document api search and sorting

Adds docs for search and sorting - this has been in for a little while, it was just left undocumented because I thought I might tune/change the search indexing a bit. Happy to commit to this though.