Retrieve Bloomreach Discovery product recommendations using the Recommendations and Pathways API v2

domain: documentation.bloomreach.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Identify the widget type and widget_id you want to call; widget IDs are configured in the Bloomreach dashboard for each recommendation strategy (e.g., 'recently viewed', 'similar products', 'top sellers').
  2. Send a GET request to the production endpoint: https://pathways.dxpapi.com/api/v2/widgets/{widget_type}/{widget_id}?account_id=YOUR_ACCOUNT&domain_key=YOUR_DOMAIN&_br_uid_2=USER_COOKIE.
  3. Pass the auth-key as a request header (Authorization: YOUR_AUTH_KEY) for the v2 API; unlike v1, the v2 API does not accept the auth key as a query parameter.
  4. Include item_ids (comma-separated product IDs) for item-context widgets like 'similar items' or 'bought together'; include user_id and _br_uid_2 for user-context widgets like 'personalized recommendations'.
  5. Parse the response JSON; results are in the response.docs array. Cache responses per user/product at the edge according to the Bloomreach caching guide to reduce latency and API load.

Known gotchas

Related routes

Integrate Bloomreach Discovery search API to power a product search page with faceted filtering
documentation.bloomreach.com · 5 steps · unrated
Implement Bloomreach Discovery autosuggest to power a search-as-you-type typeahead dropdown
documentation.bloomreach.com · 5 steps · unrated
Integrate Searchspring Recommendations API to surface personalised product recommendations on product detail pages
docs.searchspring.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans