document new search API