Top Charts - Get New Items

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

Returns the catalog items ranked by release date, newest first.

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

URI Parameters

Name In Required Type Description
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