---
title: "Lists current promotions (sales and offers) that retailers in WEM's Awin affiliate programmes have published, for the shopper's market"
method: POST
path: "/api/agent/products/search_promotions"
---

# Lists current promotions (sales and offers) that retailers in WEM's Awin affiliate programmes have published, for the shopper's market

`POST /api/agent/products/search_promotions`

## Request

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

Current sales and offers from WEM's affiliate retailers, with dates and tracked links. Filter by merchant or words. A promotion is not a price. Promotions WEM may not show are counted in withheld; a withheld code may exist.

## Request body

- object
  - `merchant` string: Retailer name, e.g. "iHoverboard". Omit for every retailer.
  - `query` string: Words that must appear in the offer, e.g. "hoverboard" or "free delivery".
  - `currency` string: ISO 4217 code for the shopper's market: GBP (default) or USD. Promotions are regional, so this decides which market's offers are read.
  - `limit` number: Max promotions to return (default 10, max 25).

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