---
title: "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\""
method: POST
path: "/api/agent/products/semantic_search"
---

# 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"

`POST /api/agent/products/semantic_search`

## Request

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

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'.

## Request body

- object
  - `description` string, required: Plain-language description of what the shopper needs.
  - `category` string: Optional. Keeps only products whose feed category matches this text exactly.
  - `provider` string: Optional. Keeps only products from this partner feed, e.g. "awin".
  - `min_price` number: Optional lower price bound, compared with each product's listed price (currencies are not converted).
  - `max_price` number: Optional upper price bound, compared with each product's listed price (currencies are not converted).
  - `limit` number: Max products to return (default 10, max 20).

## Response `200`

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

- object
  - `success` boolean, required
  - `data` object: 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.
  - `error` string

## Other responses

- `400`: Unknown tool or a malformed body.
- `429`: Burst or daily quota exhausted. Respect `retry-after` — retrying sooner cannot succeed.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/wem3/apis/wem-price-compare-api.md) · [All operations](https://skmtc.dev/wem3/apis/wem-price-compare-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wem3/apis/wem-price-compare-api/revisions/52e5c33c3f39?raw)