Item-to-Item Recommendations - Get Next Best Action

  • Reference
Service:
Intelligent Recommendations
API Version:
2021-07-14-GA-010

Cart or frequently bought together recommendations return items that are likely to be consumed together with the seed item(s).

GET https://<ir-account-name>-<service-endpoint-name>.mir.prod.reco.microsoft.com/reco/v1.0/cart/items?seedItemIds={seedItemIds}
With optional parameters: 
GET https://<ir-account-name>-<service-endpoint-name>.mir.prod.reco.microsoft.com/reco/v1.0/cart/items?seedItemIds={seedItemIds}&modeling={modeling}&channelId={channelId}&catalogId={catalogId}&count={count}&skipItems={skipItems}&userId={userId}

URI Parameters

Name In Required Type Description
seedItemIds
 query True

string

Item IDs (comma-separated) for which recommendations are requested.
catalogId
 query

string

Items may be assigned to a catalog entity within a channel, allowing Intelligent Recommendations to provide recommendations only within the confines of a specific catalog. Items from other catalogs are automatically filtered out. This parameter is optional, relevant only for customers who have previously defined a catalog ID in their dataset.
channelId
 query

string

Items may be assigned to a channel entity, allowing Intelligent Recommendations to provide recommendations only within the confines of a specific channel. Items from other channels are automatically filtered out. This parameter is optional, relevant only for customers who have previously defined a channel ID in their dataset.
count
 query

integer

Number of items to return.
modeling
 query

string

Modeling instance name.
skipItems
 query

integer

Number of items to skip, used for paging the recommendation results.
userId
 query

string

User identifier, used to apply personalization on the results. To turn on personalization, set other flags to true.

Responses

Name Type Description
200 OK

recoResponse

Successful. The response includes the list of items.

Security

azure_auth

Azure Active Directory OAuth 2.0 flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Impersonate your user account.

Definitions

Name Description
pagingInfo
recommendedItems
recoResponse

pagingInfo

Name Type Description
totalItems

integer

recommendedItems

Name Type Description
id

string

trackingId

string

recoResponse

Name Type Description
id

string

interactionsVersion

string

items

recommendedItems[]

longTitle

string

name

string

pagingInfo

pagingInfo

status

string

title

string

titleId

integer

version

string