Skip to main content
Each page below documents a single product discovery operation — request, parameters, response shape, and errors. A discovery execution records search, evaluation, and refinement history. A DRAFT campaign is the durable shopping cart for selected proposals/products and the parent of its media buys. Legacy session-selection endpoints remain available as a compatibility workflow. For the conceptual model, see the Product Discovery guide.

​
Discover

Get products across storefronts

POST /products/query or MCP get_products — retrieve canonical products and proposals, optionally screen and refine them from buyer instructions

Discover products (session view)

POST /discovery/discover-products — project the shared raw fan-out into grouped, browsable session results

Browse products

GET /discovery/:id/discover-products — page through cached results

Stream discovery events

GET /discovery/:id/events — SSE stream of progressive discovery revisions

​
Build a selection

Get products

GET /discovery/:id/products — list the selected products

Add products

POST /discovery/:id/products — add products to the selection

Remove products

DELETE /discovery/:id/products — drop products from the selection

Apply proposal

POST /discovery/:id/apply-proposal — accept a seller’s full allocation

Create media buys

POST /media-buys/batch or MCP create_media_buys — stage or execute qualified selections through a DRAFT campaign cart