Add comments for the 2 search methods

And puts the methods in a format the doc generation understands.
Switch request/response
Merge pull request #80 from cassiedoll/methods

Add comments for the 2 search methods