api search functions