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.
Sorry, meant to say `Defaults to the relevance of the search query`.

The double `to` just seemed weird to me, maybe I'm just reading it wrong?