User-to-Item Recommendations - Get User Picks

Service:

Intelligent Recommendations

API Version:

2021-07-14-GA-010

Returns personal picks, or items from the catalog that the user is likely to interact with.

GET https://<ir-account-name>-<service-endpoint-name>.mir.prod.reco.microsoft.com/reco/v1.0/picks?userId={userId}

With optional parameters:

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

URI Parameters

Name	In	Required	Type	Description
userId	query	True	string	User identifier for the user to personalize the results for.
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.

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