modify handlers to accept query string

I think the conversion of ``max_results`` to an integer should perhaps happen here rather than in the collection since it's not collection specific?