Request & show recommendations

Froomle generates a set of recommendations for each recommendation request you sent us. In the request you will have to specify the module for which you request recommendations, the user and any specific context we need to know. This includes, but is not limited to:

  • the item currently watched by the user (context_item)

  • the category from which you expect recommendations (context_category)

  • articles to be excluded from the recommendations to avoid duplicates. You can see an example in our Example API Integration for News


In various Froomle modules, including Editor’s Picks and Topical Recommendations, filters play a crucial role in defining module behaviour. Read Filters in Modules to learn more about this topic.

Specific filters and business rules need to be discussed during onboarding. By default, items will not be recommended to a user which has viewed the item already.

Recommendation Response: Froomle can communicate any information you share with us, back to you. This could save you some time fetching the information from your own back-end. Just let us know what you’d like to see in your recommendation response.

Recommendation Integration Connectors

Recommendation API

The most common way to request recommendations, is by using our API directly. For a full overview of the API specification see: Reference - Recommendations API.

Code templates

You can use our templates for JavaScript/Swift/Kotlin to set up sharing of recommendations and/or events with Froomle in your front-end. These examples explains how to do this.

Batch Recommendations

Our batch recommendation service allows requesting large volumes of recommendations at the same time, through file-based integration. This is often used in e-mail/newsletter use cases. Read How to generate batch recommendations to understand how to use this connector.

Audience Selection

Froomle supports recommending users for a given item or campaign in outbound use cases. This is typically used for push notifications, sms notifications or e-mails. Learn how to use this connnector by reading How to generate an audience.