Recommendation API now available through Microsoft Cognitive services

Recommendation API has moved from its home in Data marketplace to a new home in Cognitive services. All of our customers have already moved to consume the service from its new location.

If you are trying out the service and have built some infrastructure and integrations, this post will provide you all that is needed to move to Cognitive services.

The DataMarket Recommendations API will stop accepting new customers December 31, 2016, and will be deprecated February 28, 2017.

How do I start using the Azure Cognitive Services Recommendations API?

  1. To migrate to the Cognitive Services Recommendations API, do the following:
  2. If you don’t already have an Azure subscription, sign up for one.
  3. Get step-by-step instructions from the Quick Start Guide to sign up for the Cognitive Services Recommendations API and use it programmatically.
  4. Go to the Cognitive Services Recommendations API landing page to learn about the service and find documentation.

I used the Recommendations UI to build my models. Is there a similar tool for the Cognitive Services Recommendations API?

  1. Absolutely! The URL for the new Recommendations UI is
  2. Note: (Use Azure note markup)
  3. Your DataMarket credentials don’t work here.
  4. You need to sign up for a subscription in the Azure Portal, and
  5. Get the Account Key needed to use the new Recommendations UI.
  6. If you don’t have an Account Key, see Task 1 of the Quick Start Guide.

Is the new API format the same as the DataMarket Recommendations API?

The API supports the same scenarios and process flows as those supported in the DataMarket version, but the actual API interface has been updated to conform to the Microsoft REST API Guidelines. This means that the APIs are more consistent and work better with tools that support Swagger.

  1. To understand each of the APIs, check out the API explorer.
  2. Use the Try it button to test an API call.
  3. The format of files consumed by the Recommendations API (catalog and usage files) has not changed, so you can keep using the same files and/or infrastructure you have built to generate those files.

What are some new features in the Cognitive Services Recommendations API?

Over the last two months, we have released new capabilities for the Cognitive Services Recommendations API:

  1. Recommendations UI for training and testing models without having to write a single line of code
  2. Batch scoring to provide you thousands of recommendations at once
  3. Build metrics support to query the quality of recommendations models
  4. Support for business rules
  5. Ability to enumerate and download usage and catalog files
  6. Ranking build support to query the quality of item features in a recommendations model
  7. Added ability to search for a product in the catalog

When does Microsoft stop supporting the DataMarket Recommendations API?

Recommendations API on DataMarket stops accepting new customers after December 31, 2016, and will be completely deprecated by February 28, 2017.

What if I don’t have the data that I need to recreate my models in the Cognitive Services Recommendations API?

We want to make this transition as easy as possible for you. We can help you move your old models from your DataMarket account to your new Azure Cognitive Services Recommendations API subscription.

  • Contact us at or
  • We will ask you to provide your DataMarket subscription ID and your Cognitive Services subscription ID, before we associate the models with your new account.

Hope you have all you need to start consuming the new and revamped API. A lot more is coming so use this blog to stay on top and let us know if you have any questions.

Comments (0)

Skip to main content