Using Game Recommendations API

Overview

The Game Recommendations API provides real-time, AI-powered game recommendations that power personalised player experiences across casino platforms.

It supports:

  • Player-level personalisation for existing users

  • Site-level recommendations for new or low-activity users

These endpoints are typically consumed by your frontend, CMS, or CRM systems to drive onboarding, engagement, retention, and reactivation journeys.

For a full overview of recommendation types, use cases, and performance, see:
Game Recommendations Feature Guide

Before You Start

Before integrating the API, ensure:

  • You have an active Game Recommendations subscription

  • Player session and transaction data is available and you have completed Data Transfer

  • Your backend or CMS can authenticate and call REST APIs

For full onboarding steps, see: Getting Started Guide

How It Works

Recommendations are generated using a combination of machine learning models that analyse player behaviour, preferences, and game attributes. These models continuously update based on new activity to ensure recommendations remain relevant and effective over time.

For a deeper explanation of the models and logic:
How it Works Guide

How to Use the API

The API is flexible and supports two main ways of working, depending on how much control you want over the experience.

Most implementations call individual endpoints to power specific carousels. For example, you might use:

  • /recommended_for_you/{player_id} for a primary personalised carousel

  • /because_you_played/{player_id} for similarity-based content

  • /players_like_you/{player_id} for collaborative recommendations

  • /trending_games or /popular_games for broader site content

This approach gives you full control over placement and layout across your frontend.

Alternatively, you can call /personalise_site/{player_id} to retrieve multiple recommendation categories in a single response. This is useful for simplifying integration or supporting pages with multiple carousels, where results can be lazy loaded as needed.

In both cases, the API handles player state automatically. Existing players receive personalised recommendations, while new or low-activity players are served optimised, site-level content without requiring separate logic.

For more detail on how recommendation categories behave:
Game Recommendations Feature Guide

Integration Patterns

In practice, most operators integrate the API directly into their frontend to personalise key areas such as the homepage, lobby, and category pages. Recommendations are often used to power “next game” suggestions or discovery-focused sections that encourage players to explore beyond their usual behaviour.

The same outputs can also be extended into CRM channels, including email, push notifications, and reactivation campaigns, allowing you to maintain consistent personalisation across both on-site and outbound experiences.

Where you already manage your own content collections, ranking endpoints can be used to personalise ordering rather than replacing content entirely. This is particularly useful for optimising existing carousels without changing their structure.

Fallbacks and Player States

Fallback behaviour is built into the API to ensure a consistent experience across all players.

If a player has limited or no activity, the system automatically returns recommendations optimised for conversion based on site-wide performance. In some cases, endpoints may return redirect responses, so your implementation should be able to handle these or fall back to site-level endpoints where appropriate.

More detail on player behaviour and fallback logic:
Game Recommendations FAQ

Metadata-Driven Personalisation

For more advanced use cases, the API supports personalisation based on game attributes such as theme, volatility, provider, or features. This allows you to create tailored carousels like “High Volatility” or “Egyptian Slots”, with results ranked specifically for each player.

This approach is particularly effective for structuring discovery journeys and creating richer, more targeted content experiences.

Try Game Recommendations API