Recommendations API

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.

---

Recommendations API Reference

---

Get casino lobby recommendations

---

post

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.

Header parameters

X-Hub88-SignaturestringRequired

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.

Body

application/json

operator_idintegerRequired

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.

Example: 1

platformstringRequired

The device platform type for which game recommendations are provided. It's the current device platform the user is accessing the Operator's site from.

Example: GPL_DESKTOP

userstringOptional

The 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.

Example: johndoe

languagestringOptional

The language enabled for the user on the site, used to help improve the quality of recommendations. Optional context parameter.

Example: en

currencystringOptional

The 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.

Example: EUR

locationstringOptional

The country location provided to help improve the quality of the recommendation in a situation player plays from multiple locations (countries). Optional context parameter.

Example: JPN

limitintegerOptional

The limits for the count of returned game recommendations. Default limit: 50, Maximum limit: 500.

Example: 50

Responses

200

OK

application/json

recommendation_idstringRequired

Unique identifier for a recommendation. Operator must send this unique identifier as part of the meta object values when requesting the Game URL for any game returned in the list of games in this response which the recommendation_id belongs to, this helps in improving the quality of recommendations.

Example: RID-65d1700a-00af-4a90-a554-9304f4c181d6

400Error

application/json

post

/recommendations/lobby

HTTPcURLJavaScriptPython

POST /recommendations/lobby HTTP/1.1
X-Hub88-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 122

{
  "operator_id": 1,
  "platform": "GPL_DESKTOP",
  "user": "johndoe",
  "language": "en",
  "currency": "EUR",
  "location": "JPN",
  "limit": "50"
}

{
  "games": [
    {
      "url_thumb": "https://picture-hosting.com/blackjack/thumb.png",
      "url_background": "https://picture-hosting.com/blackjack/bg.png",
      "product": "OneTouch",
      "platforms": [
        "GPL_DESKTOP",
        "GPL_MOBILE"
      ],
      "name": "Blackjack Classic",
      "game_code": "ont_blackjackclassic",
      "freebet_support": true,
      "enabled": true,
      "category": "Blackjack",
      "blocked_countries": [
        "PL",
        "BG"
      ],
      "release_date": "2024-11-05",
      "scatters": true,
      "in_game_freebets": true,
      "volatility": 6,
      "rtp": "94.79",
      "paylines": 20,
      "hit_ratio": "24.47",
      "certifications": [
        "CURACAO"
      ],
      "languages": [
        "eng",
        "jpn",
        "kor",
        "deu"
      ],
      "theme": [
        [
          "Nature",
          "Halloween",
          "Horror"
        ]
      ],
      "technology": [
        [
          "HTML5"
        ]
      ],
      "score": "0.015"
    }
  ],
  "recommendation_id": "RID-65d1700a-00af-4a90-a554-9304f4c181d6"
}

---

Get personalized user lobby recommendations

---

post

User 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.

Header parameters

X-Hub88-SignaturestringRequired

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.

Body

application/json

operator_idintegerRequired

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.

Example: 1

platformstringRequired

The device platform type for which game recommendations are provided. It's the current device platform the user is accessing the Operator's site from.

Example: GPL_DESKTOP

userstringRequired

The unique user name of the player on Operator's side.

In case of first time user, 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.

Example: johndoe

languagestringOptional

The language enabled for the user on the site, used to help improve the quality of recommendations. Optional context parameter.

Example: en

currencystringOptional

The 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.

Example: EUR

locationstringOptional

The country location provided to help improve the quality of the recommendation in a situation player plays from multiple locations (countries). Optional context parameter.

Example: JPN

limitintegerOptional

The limits for the count of returned game recommendations. Default limit: 50, Maximum limit: 500.

Example: 50

Responses

200

OK

application/json

recommendation_idstringRequired

Unique identifier for a recommendation. Operator must send this unique identifier as part of the meta object values when requesting the Game URL for any game returned in the list of games in this response which the recommendation_id belongs to, this helps in improving the quality of recommendations.

Example: RID-65d1700a-00af-4a90-a554-9304f4c181d6

400Error

application/json

post

/recommendations/user_lobby

HTTPcURLJavaScriptPython

POST /recommendations/user_lobby HTTP/1.1
X-Hub88-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 122

{
  "operator_id": 1,
  "platform": "GPL_DESKTOP",
  "user": "johndoe",
  "language": "en",
  "currency": "EUR",
  "location": "JPN",
  "limit": "50"
}

{
  "games": [
    {
      "url_thumb": "https://picture-hosting.com/blackjack/thumb.png",
      "url_background": "https://picture-hosting.com/blackjack/bg.png",
      "product": "OneTouch",
      "platforms": [
        "GPL_DESKTOP",
        "GPL_MOBILE"
      ],
      "name": "Blackjack Classic",
      "game_code": "ont_blackjackclassic",
      "freebet_support": true,
      "enabled": true,
      "category": "Blackjack",
      "blocked_countries": [
        "PL",
        "BG"
      ],
      "release_date": "2024-11-05",
      "scatters": true,
      "in_game_freebets": true,
      "volatility": 6,
      "rtp": "94.79",
      "paylines": 20,
      "hit_ratio": "24.47",
      "certifications": [
        "CURACAO"
      ],
      "languages": [
        "eng",
        "jpn",
        "kor",
        "deu"
      ],
      "theme": [
        [
          "Nature",
          "Halloween",
          "Horror"
        ]
      ],
      "technology": [
        [
          "HTML5"
        ]
      ],
      "score": "0.015"
    }
  ],
  "recommendation_id": "RID-65d1700a-00af-4a90-a554-9304f4c181d6"
}

---

Get recommendations for a similar game

---

post

Similar 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.

Header parameters

X-Hub88-SignaturestringRequired

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.

Body

application/json

operator_idintegerRequired

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.

Example: 1

platformstringRequired

The platform of the device Game gets recommendations for.

Example: GPL_DESKTOP

game_codestringRequired

The Game reference code to recommend similar games for.

Example: evo_crazytime

languagestringOptional

The language enabled for the user on the site, used to help improve the quality of recommendations. Optional context parameter.

Example: en

currencystringOptional

The 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.

Example: EUR

locationstringOptional

The country location provided to help improve the quality of the recommendation in a situation player plays from multiple locations (countries). Optional context parameter.

Example: JPN

limitintegerOptional

Limits the count of returned games in the response. Maximum is 500.

Example: 50

Responses

200

OK

application/json

recommendation_idstringRequired

Unique identifier for a recommendation. Operator must send this unique identifier as part of the meta object values when requesting the Game URL for any game returned in the list of games in this response which the recommendation_id belongs to, this helps in improving the quality of recommendations.

Example: RID-65d1700a-00af-4a90-a554-9304f4c181d6

400Error

application/json

post

/recommendations/similar_games

HTTPcURLJavaScriptPython

POST /recommendations/similar_games HTTP/1.1
X-Hub88-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 133

{
  "operator_id": 1,
  "platform": "GPL_DESKTOP",
  "game_code": "evo_crazytime",
  "language": "en",
  "currency": "EUR",
  "location": "JPN",
  "limit": "50"
}

{
  "games": [
    {
      "url_thumb": "https://picture-hosting.com/blackjack/thumb.png",
      "url_background": "https://picture-hosting.com/blackjack/bg.png",
      "product": "OneTouch",
      "platforms": [
        "GPL_DESKTOP",
        "GPL_MOBILE"
      ],
      "name": "Blackjack Classic",
      "game_code": "ont_blackjackclassic",
      "freebet_support": true,
      "enabled": true,
      "category": "Blackjack",
      "blocked_countries": [
        "PL",
        "BG"
      ],
      "release_date": "2024-11-05",
      "scatters": true,
      "in_game_freebets": true,
      "volatility": 6,
      "rtp": "94.79",
      "paylines": 20,
      "hit_ratio": "24.47",
      "certifications": [
        "CURACAO"
      ],
      "languages": [
        "eng",
        "jpn",
        "kor",
        "deu"
      ],
      "theme": [
        [
          "Nature",
          "Halloween",
          "Horror"
        ]
      ],
      "technology": [
        [
          "HTML5"
        ]
      ],
      "score": "0.015"
    }
  ],
  "recommendation_id": "RID-65d1700a-00af-4a90-a554-9304f4c181d6"
}