User-to-Item Recommendations - Get User Picks

  • Reference
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