documenting new search API #183