Searches WEM's partner-feed products by meaning, for a plain-language need such as "comfortable shoes for standing all day" or "gift for a 10 year old who likes science"

Search partner-feed products by meaning, for a plain-language need. A product identifier is looked up as that product. With no results, reason says why; an index that could not be searched is not 'nothing found'.

post/api/agent/products/semantic_search

Request

  • Base URL: https://wem3.ai
  • URL: https://wem3.ai/api/agent/products/semantic_search
  • Auth: none declared

Request body

descriptionstring required

Plain-language description of what the shopper needs.

categorystring

Optional. Keeps only products whose feed category matches this text exactly.

providerstring

Optional. Keeps only products from this partner feed, e.g. "awin".

min_pricenumber

Optional lower price bound, compared with each product's listed price (currencies are not converted).

max_pricenumber

Optional upper price bound, compared with each product's listed price (currencies are not converted).

limitnumber

Max products to return (default 10, max 20).

Response

Tool result. success: false means the tool ran and reported a problem.

successboolean required
dataobject

Shape depends on the tool. Search-style results carry products, an optional catalogMatch of identity-resolved offers, and filtered, a count by reason of the weak matches withheld — report that count rather than implying the search was exhaustive.

errorstring

Changes

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