updated search api docs to include pagination changes

Signed-off-by: Nathan Hsieh <hsieh.nathan@gmail.com>
what happens if n=0 - will that turn off paging, or zero results? please document how the user asks for all results.

what happens if there are 10 results and the request is for `page=1000&n=100` - ie, what is the out of bounds response?