update README
raise instance of UnexpectedResultError
simplify query parameters passing

After this change, all keyword arguments pass to list will find their
way into the HTTP query parameters.