Recommendations API
Last updated
Was this helpful?
Developers Docs
Last updated
Was this helpful?
Recommendations API provides recommendations of casino lobbies, user lobbies and similar games for a player to an Operator based on a player's interactions (gameplays) on Hub88 platform.
Our recommendation engine uses player interaction data—specifically bet activity across all suppliers—to deliver personalised game suggestions.
How it works?
For similar games, recommendations are generated using collaborative filtering, based on what a player plays alongside others who play the same games.
For lobbies, recommendations are done in two ways, either by:
Reflecting network-wide trends (all game plays across Hub88) (default).
Showing top-performing games by turnover in the last 30 days (Configurable on demand).
The Recommendations API's use case enables more tailored, data-driven experiences for players.
Casino lobby recommendation: The endpoint provides a list of recommended top games based on overall unique users’ interactions with the games. The list of games returned is sorted and scored from high to low, a higher score indicates an increased possibility of interaction with the game.
RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided operator_id.
Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.
1The device platform type for which game recommendations are provided. It's the current device platform the user is accessing the Operator's site from.
GPL_DESKTOPThe unique user name of the player on Operator's side. The parameter is required to reference if a user exists on Hub88 platform, i.e. has launched a game at least once.
johndoeThe language enabled for the user on the site, used to help improve the quality of recommendations. Optional context parameter.
enThe currency which has been currently enabled for the wallet on the site. This value can be provided to help improve the quality of recommendations, in a situation where user switches between multiple wallets (currencies) to play games on the site. Optional context parameter.
EURThe country location provided to help improve the quality of the recommendation in a situation player plays from multiple locations (countries). Optional context parameter.
JPNThe limits for the count of returned game recommendations. Default limit: 50, Maximum limit: 500.
50User personalized lobby: The endpoint provides a predefined and recommended list of games the player is likely to interact with next. The predicted list is based on player's historical interactions on the Hub88 platform. The response of the endpoint is a mixture of games the player has played before and new games the player is likely to play next, based on their historical interactions.
The list of games is scored and ordered from high to low according to the likelihood of the player interacting with them.
Note: For new users with no historical interactions, initially top games based on overall unique users’ interactions are recommended (as in casino lobby recommendation). Subsequently, the player gets recommendations based on their personal playing history.
RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided operator_id.
Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.
1The device platform type for which game recommendations are provided. It's the current device platform the user is accessing the Operator's site from.
GPL_DESKTOPThe unique user name of the player on Operator's side. The parameter is required to reference if a user exists on Hub88 platform, i.e. has launched a game at least once.
johndoeThe language enabled for the user on the site, used to help improve the quality of recommendations. Optional context parameter.
enThe currency which has been currently enabled for the wallet on the site. This value can be provided to help improve the quality of recommendations, in a situation where user switches between multiple wallets (currencies) to play games on the site. Optional context parameter.
EURThe country location provided to help improve the quality of the recommendation in a situation player plays from multiple locations (countries). Optional context parameter.
JPNThe limits for the count of returned game recommendations. Default limit: 50, Maximum limit: 500.
50Similar games recommendation: Endpoint recommends similar games to the game requested based on co-occurrence of interactions (game plays) on the requested game and other games in all recorded game plays on Hub88 platform.
The response game list contains popular games played by other players, who have also played the game in the request.
RSA-SHA256 is used to sign the request body using a private key. The signature is validated using the public key associated with the provided operator_id.
Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.
1The platform of the device Game gets recommendations for.
GPL_DESKTOPThe Game reference code to recommend similar games for.
evo_crazytimeThe language enabled for the user on the site, used to help improve the quality of recommendations. Optional context parameter.
enThe currency which has been currently enabled for the wallet on the site. This value can be provided to help improve the quality of recommendations, in a situation where user switches between multiple wallets (currencies) to play games on the site. Optional context parameter.
EURThe country location provided to help improve the quality of the recommendation in a situation player plays from multiple locations (countries). Optional context parameter.
JPNLimits the count of returned games in the response. Maximum is 500.
50