split out query method in the API. kind of creates code duplication but is more explicit, and will probably be a good thing later on for other query types.