User-to-Item Recommendations - Get User Picks
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}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 |
|---|---|---|---|---|
|
user
|
query | True |
string |
User identifier for the user to personalize the results for. |
|
catalog
|
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. |
|
|
channel
|
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. |
|
|
skip
|
query |
integer |
Number of items to skip, used for paging the recommendation results. |
Responses
| Name | Type | Description |
|---|---|---|
| 200 OK |
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 |
|---|---|
|
paging |
|
|
recommended |
|
|
reco |
pagingInfo
| Name | Type | Description |
|---|---|---|
| totalItems |
integer |
recommendedItems
| Name | Type | Description |
|---|---|---|
| id |
string |
|
| trackingId |
string |
recoResponse
| Name | Type | Description |
|---|---|---|
| id |
string |
|
| interactionsVersion |
string |
|
| items | ||
| longTitle |
string |
|
| name |
string |
|
| pagingInfo | ||
| status |
string |
|
| title |
string |
|
| titleId |
integer |
|
| version |
string |