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

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.

post/api/agent/products/search_promotions

Request

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

Request body

merchantstring

Retailer name, e.g. "iHoverboard". Omit for every retailer.

querystring

Words that must appear in the offer, e.g. "hoverboard" or "free delivery".

currencystring

ISO 4217 code for the shopper's market: GBP (default) or USD. Promotions are regional, so this decides which market's offers are read.

limitnumber

Max promotions to return (default 10, max 25).

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.