Semantic product search

Runs the search-agent Lambda pipeline (pgvector + BM25 RRF + Cohere rerank) and returns ranked product results. If the caller has a verified-email session and either sets bundle: true or the query matches a bundle-search pattern (e.g. "full kitchen set $900"), a multi-category bundle response is returned instead of a flat result list — see the two response schemas below. Anonymous callers always get the regular (non-bundle) response shape.

post/api/search/

Request

  • Base URL: https://productindex.ai
  • URL: https://productindex.ai/api/search/
  • Auth: none required

Request body

querystring required

Free-text search query.

session_idstring

Anonymous session UUID for search-analytics correlation; not an auth credential.

bundleboolean

Explicitly opt into the bundle-search path (skips the keyword-trigger gate, still requires a verified-email session). Ignored for anonymous callers.

limitnumber

Response

Search results — regular or bundle shape depending on caller eligibility and query.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.