fix callers for params_for_search with clear distinction between query params and options
clearer docs for params_for_search and custom query params