basic search api specification + docs