AI Recommendations — API Reference

Hyper-personalized item recommendations for your customers

36 endpoints across 3 tags.

Recommendation campaigns

• GET /recommendations/v2/campaigns — Get all recommendation campaigns
• POST /recommendations/v2/campaigns — Create a recommendation campaign
• GET /recommendations/v2/campaigns/{campaignId} — Get recommendation campaign details
• POST /recommendations/v2/campaigns/{campaignId} — Update a recommendation campaign
• DELETE /recommendations/v2/campaigns/{campaignId} — Delete a recommendation campaign
• POST /recommendations/v2/campaigns/state — Change campaigns' states
• POST /recommendations/v2/campaigns/{campaignId}/copy — Copy a recommendation campaign
• GET /recommendations/v2/campaigns/simplified — Get simplified recommendation campaigns

Recommendation statistics

• POST /recommendations/v2/campaigns/stats — Get recommendation campaign statistics
• GET /recommendations/v2/campaigns/stats/global — Get global recommendation campaign statistics
• GET /recommendations/v2/campaigns/{campaignId}/stats — Get recommendation campaign statistics
• GET /recommendations/v2/campaigns/{campaignId}/products/stats — Get statistics for top items in a campaign

Recommendations

• GET /recommendations/v2/recommend/campaigns/{campaignIdentifier} — Get recommendations by campaign
• POST /recommendations/v2/recommend/campaigns — Get recommendations by campaign
• POST /recommendations/v2/recommend/campaigns/{campaignIdentifier}/by/{identifierName} — Get recommendations by campaign and profile identifier
• POST /recommendations/v2/recommend/campaigns/preview — Preview campaign recommendations
• GET /recommendations/v2/recommend/items/users/{clientUuid} — Personalized recommendations
• POST /recommendations/v2/recommend/items/users/{clientUuid} — Personalized recommendations
• POST /recommendations/v2/recommend/items/users/{clientUuid}/sections — Section recommendations
• POST /recommendations/v2/recommend/items/users/{clientUuid}/attributes — Attribute recommendations
• GET /recommendations/v2/recommend/items/users/{clientUuid}/last — Last viewed recommendations
• POST /recommendations/v2/recommend/items/users/{clientUuid}/last — Last viewed recommendations
• GET /recommendations/v2/recommend/items/users/{clientUuid}/aggregates/{aggregateUUID} — Recent interactions recommendations
• POST /recommendations/v2/recommend/items/users/{clientUuid}/aggregates/{aggregateUUID} — Recent interactions recommendations
• GET /recommendations/v2/recommend/items/metric — Scoring by metric
• POST /recommendations/v2/recommend/items/metric — Scoring by metric
• GET /recommendations/v2/recommend/items/complementary — Complementary items for a cart
• POST /recommendations/v2/recommend/items/complementary — Complementary items for a cart
• GET /recommendations/v2/recommend/items/{itemId}/complementary — Complementary items
• POST /recommendations/v2/recommend/items/{itemId}/complementary — Complementary items
• GET /recommendations/v2/recommend/items/{itemId}/similar — Similar items
• POST /recommendations/v2/recommend/items/{itemId}/similar — Similar items
• GET /recommendations/v2/recommend/items/{itemId}/similar/visual — Visually similar
• POST /recommendations/v2/recommend/items/{itemId}/similar/visual — Visually similar
• GET /recommendations/v2/recommend/items/next-interaction — Next interaction
• POST /recommendations/v2/recommend/items/next-interaction — Next interaction

Back to all API categories