> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Product discovery tasks

> Per-operation reference for the buyer product discovery API

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](/v2/guides/discovery).

## Discover

<CardGroup cols={2}>
  <Card title="Get products across storefronts" href="/v2/buyer/discovery/multi-storefront-get-products" icon="network-wired">
    `POST /products/query` or MCP `get_products` — retrieve canonical products and proposals, optionally screen and refine them from buyer instructions
  </Card>

  <Card title="Discover products (session view)" href="/v2/buyer/discovery/tasks/discover-products" icon="magnifying-glass">
    `POST /discovery/discover-products` — project the shared raw fan-out into grouped, browsable session results
  </Card>

  <Card title="Browse products" href="/v2/buyer/discovery/tasks/browse-products" icon="layer-group">
    `GET /discovery/:id/discover-products` — page through cached results
  </Card>

  <Card title="Stream discovery events" href="/v2/buyer/discovery/tasks/events" icon="tower-broadcast">
    `GET /discovery/:id/events` — SSE stream of progressive discovery revisions
  </Card>
</CardGroup>

## Build a selection

<CardGroup cols={2}>
  <Card title="Get products" href="/v2/buyer/discovery/tasks/get-products" icon="list">
    `GET /discovery/:id/products` — list the selected products
  </Card>

  <Card title="Add products" href="/v2/buyer/discovery/tasks/add-products" icon="plus">
    `POST /discovery/:id/products` — add products to the selection
  </Card>

  <Card title="Remove products" href="/v2/buyer/discovery/tasks/remove-products" icon="trash">
    `DELETE /discovery/:id/products` — drop products from the selection
  </Card>

  <Card title="Apply proposal" href="/v2/buyer/discovery/tasks/apply-proposal" icon="wand-magic-sparkles">
    `POST /discovery/:id/apply-proposal` — accept a seller's full allocation
  </Card>

  <Card title="Create media buys" href="/v2/buyer/discovery/tasks/create-media-buys" icon="cart-shopping">
    `POST /media-buys/batch` or MCP `create_media_buys` — stage or execute qualified selections through a DRAFT campaign cart
  </Card>
</CardGroup>