search api improvements

addresses: #227
soe improvements

closes: #227