Game Tags

Casino game tags related endpoints

get
/api/casino/game_tags/popular

Returns popular casino game tags for the given time frame.

The games are sorted by popularity.

Popularity

The metric used to measure popularity is the number of sessions played on each game tag.

Example

In this example we get all popular game tags from 2022-03-15 to 2022-03-25.

$ curl --request GET \
  --url 'https://api.vaix.ai/api/casino/game_tags/popular?from=2022-03-25%2000%3A00%3A00&from_offset=-10d'
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
countinteger · min: 1Optional

Number of game tags to return.

Default: 100Example: 5
filtersstring · enumOptional

Optional filtering of the games to retrieve. It expects a string adhering to the filtering format, as described in the filtering section, e.g. enabled:eq:1.

Example: enabled:eq:1Possible values:
operatorstringOptional

The operator to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored.

bookmaker_idintegerOptional

The bookmaker id to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored. Note that this parameter is used together with the sub_bookmaker_id parameter.

sub_bookmaker_idintegerOptional

The sub-bookmaker id to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored. Note that this parameter is used together with the bookmaker_id parameter.

locationstringOptional

The location of the page where the request takes place.

Example: inplay_widget
Header parameters
x-vaix-client-idstringRequired

Custom client header, the value should be the name of the group the user belongs to

x-vaix-authentication-methodstringOptional

Authentication method to be used, supported values [vaix, iam]. Defaults to vaix

Responses
200

OK

application/json
get
/api/casino/game_tags/popular
GET /api/casino/game_tags/popular HTTP/1.1
Host: api.vaix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
x-vaix-client-id: text
Accept: */*
{
  "data": [
    {
      "confidence": 1,
      "game_tag": ""
    },
    {
      "confidence": 0.14987820604671157,
      "game_tag": "greek/roman"
    },
    {
      "confidence": 0.07164350193437455,
      "game_tag": "norse"
    },
    {
      "confidence": 0.0630462817022496,
      "game_tag": "mythology"
    },
    {
      "confidence": 0.0402636480871185,
      "game_tag": "gems"
    },
    {
      "confidence": 0.03395901991689354,
      "game_tag": "casino"
    },
    {
      "confidence": 0.017910875483593637,
      "game_tag": "movies/tv"
    },
    {
      "confidence": 0.01748101447198739,
      "game_tag": "jungle"
    },
    {
      "confidence": 0.016478005444906147,
      "game_tag": "scifi"
    },
    {
      "confidence": 0.015331709413956155,
      "game_tag": "animals"
    }
  ],
  "status": "success"
}
get
/api/casino/game_tags/recommended

Returns personalized game tags recommendations.

Confidence

Each returned item is associated with a number from 0 to 1 indicating the confidence of the system in this specific recommendation. The higher the number the more confident the recommendation of it.

Result ordering

By default game tags are sorted based on confidence, with the most confident one on top. The order_by parameter can be used to order the results in the desired order.

Getting recommendations for a user

In this example we get all recommended game tags for the user with id 0 without passing any extra parameters except the user

$ curl --request GET \
  --url 'https://api.vaix.ai/api/casino/game_tags/recommended?user=0'
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
userstringOptional

The user to get recommendations for.

Default: 0
typestring · enumOptional

Whether to return vaix or operator tags.

Default: vaixPossible values:
daysinteger · min: 1 · max: 120Optional

How many days before to search for favourite game tags. Defaults to 28.

Default: 28
countinteger · min: 1Optional

Number of game tags to return.

Default: 100Example: 5
filtersstring · enumOptional

Optional filtering of the games to retrieve. It expects a string adhering to the filtering format, as described in the filtering section, e.g. enabled:eq:1.

Example: enabled:eq:1Possible values:
operatorstringOptional

The operator to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored.

bookmaker_idintegerOptional

The bookmaker id to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored. Note that this parameter is used together with the sub_bookmaker_id parameter.

sub_bookmaker_idintegerOptional

The sub-bookmaker id to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored. Note that this parameter is used together with the bookmaker_id parameter.

locationstringOptional

The location of the page where the request takes place.

Example: inplay_widget
Header parameters
x-vaix-client-idstringRequired

Custom client header, the value should be the name of the group the user belongs to

x-vaix-authentication-methodstringOptional

Authentication method to be used, supported values [vaix, iam]. Defaults to vaix

Responses
200

OK

application/json
get
/api/casino/game_tags/recommended
GET /api/casino/game_tags/recommended HTTP/1.1
Host: api.vaix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
x-vaix-client-id: text
Accept: */*
{
  "data": [
    {
      "confidence": 1,
      "game_tag": "gems"
    },
    {
      "confidence": 0.9504405286343612,
      "game_tag": "greek/roman"
    },
    {
      "confidence": 0.76431718061674,
      "game_tag": "fantasy"
    },
    {
      "confidence": 0.6354625550660793,
      "game_tag": ""
    },
    {
      "confidence": 0.2973568281938326,
      "game_tag": "casino"
    }
  ],
  "status": "success"
}
get
/api/casino/game_tags/trending

Returns trending game tags for the given time frame.

The game tags are sorted by trending score.

Trending score

To calculate trending score for a game tags, each session played with this game tag contributes a value determined by how recently the session was played.

Recent sessions add more value than older ones.

Filtering example

In this example we get all trending game tags at 2022-03-25.

$ curl --request GET \
  --url 'https://api.vaix.ai/api/casino/game_tags/trending?&at=2022-03-25%2000%3A00%3A00'
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
countinteger · min: 1Optional

Number of game tags to return.

Default: 100Example: 5
filtersstring · enumOptional

Optional filtering of the games to retrieve. It expects a string adhering to the filtering format, as described in the filtering section, e.g. enabled:eq:1.

Example: enabled:eq:1Possible values:
operatorstringOptional

The operator to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored.

bookmaker_idintegerOptional

The bookmaker id to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored. Note that this parameter is used together with the sub_bookmaker_id parameter.

sub_bookmaker_idintegerOptional

The sub-bookmaker id to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored. Note that this parameter is used together with the bookmaker_id parameter.

locationstringOptional

The location of the page where the request takes place.

Example: inplay_widget
trending_withinstringOptional

Considers game sessions played after the current timestamp minus the given minutes/hours/days. If not set defaults to 2 days. The value must be in range [1m - 7d].

Default: 2dExample: 3hPattern: ^[+-]?[0-9]+([.][0-9]+)?[smhd]?$
Header parameters
x-vaix-client-idstringRequired

Custom client header, the value should be the name of the group the user belongs to

x-vaix-authentication-methodstringOptional

Authentication method to be used, supported values [vaix, iam]. Defaults to vaix

Responses
200

OK

application/json
get
/api/casino/game_tags/trending
GET /api/casino/game_tags/trending HTTP/1.1
Host: api.vaix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
x-vaix-client-id: text
Accept: */*
{
  "data": [
    {
      "confidence": 1,
      "game_tag": ""
    },
    {
      "confidence": 0.21565461890820894,
      "game_tag": "circus/magician"
    },
    {
      "confidence": 0.21472767019164668,
      "game_tag": "sports"
    },
    {
      "confidence": 0.21441868728612593,
      "game_tag": "space"
    },
    {
      "confidence": 0.21410970438060517,
      "game_tag": "mystery"
    },
    {
      "confidence": 0.21006975289092136,
      "game_tag": "music"
    },
    {
      "confidence": 0.20945178707987985,
      "game_tag": "romance/love"
    },
    {
      "confidence": 0.20789914797963807,
      "game_tag": "travel"
    },
    {
      "confidence": 0.20751291934773713,
      "game_tag": "scifi"
    },
    {
      "confidence": 0.2069721992630758,
      "game_tag": "christmas"
    },
    {
      "confidence": 0.2057826150768209,
      "game_tag": "mexican"
    },
    {
      "confidence": 0.20232200653498847,
      "game_tag": "ocean"
    },
    {
      "confidence": 0.20192805333044953,
      "game_tag": "jungle"
    },
    {
      "confidence": 0.19921672833450493,
      "game_tag": "asian"
    },
    {
      "confidence": 0.1985137922244452,
      "game_tag": "movies/tv"
    },
    {
      "confidence": 0.19673714051770091,
      "game_tag": "magic"
    },
    {
      "confidence": 0.19611145013402137,
      "game_tag": "famous people"
    },
    {
      "confidence": 0.19146125740593403,
      "game_tag": "arabian"
    },
    {
      "confidence": 0.19084329159489252,
      "game_tag": "ice/snow/winter"
    },
    {
      "confidence": 0.18835597920545047,
      "game_tag": "cash & gold"
    },
    {
      "confidence": 0.18246213028264216,
      "game_tag": "cartoon"
    },
    {
      "confidence": 0.18091721575503839,
      "game_tag": "horror"
    },
    {
      "confidence": 0.18029152537135884,
      "game_tag": "western"
    },
    {
      "confidence": 0.17656828135983382,
      "game_tag": "steam punk"
    },
    {
      "confidence": 0.17272144418610041,
      "game_tag": "science"
    },
    {
      "confidence": 0.16965478884880697,
      "game_tag": "food"
    },
    {
      "confidence": 0.16797855658635688,
      "game_tag": "neon"
    },
    {
      "confidence": 0.16417806684845165,
      "game_tag": "fantasy"
    },
    {
      "confidence": 0.1607483565971713,
      "game_tag": "fairy tales"
    },
    {
      "confidence": 0.1542288172906834,
      "game_tag": "retro"
    },
    {
      "confidence": 0.15299288566860042,
      "game_tag": "medieval"
    },
    {
      "confidence": 0.15118533567130402,
      "game_tag": "american"
    },
    {
      "confidence": 0.143777470511444,
      "game_tag": "greek/roman"
    },
    {
      "confidence": 0.14317495384567852,
      "game_tag": "irish"
    },
    {
      "confidence": 0.1328240265107333,
      "game_tag": "maya/inca/aztec"
    },
    {
      "confidence": 0.13034443869392928,
      "game_tag": "adventure"
    },
    {
      "confidence": 0.128173833782646,
      "game_tag": "egyptian"
    },
    {
      "confidence": 0.10972755432305707,
      "game_tag": "casino"
    },
    {
      "confidence": 0.1045907135187746,
      "game_tag": "fruits"
    },
    {
      "confidence": 0.09930710583436973,
      "game_tag": "mythology"
    },
    {
      "confidence": 0.04986984095104939,
      "game_tag": "norse"
    },
    {
      "confidence": 0.01666962775284456,
      "game_tag": "gems"
    },
    {
      "confidence": 0,
      "game_tag": "animals"
    }
  ],
  "status": "success"
}

Get all casino game tags

get
/api/casino/offering/game_tags

Returns all casino game tags.

Example

In this example we get all casino game tags.

$ curl --request GET \
  --url 'https://api.vaix.ai/api/casino/offering/game_tags
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
filtersstring · enumOptional

Optional filtering of the games to retrieve. It expects a string adhering to the filtering format, as described in the filtering section, e.g. enabled:eq:1.

Example: enabled:eq:1Possible values:
typestring · enumOptional

Whether to return vaix or operator tags.

Default: vaixPossible values:
countinteger · min: 1Optional

Number of game tags to return.

Default: 100Example: 5
order_bystring · enumOptional

The columns to sort the results by. It expects a string adhering to the ordering format, as described in the ordering section, e.g. +game_tag.

Possible values:
operatorstringOptional

The operator to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored.

bookmaker_idintegerOptional

The bookmaker id to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored. Note that this parameter is used together with the sub_bookmaker_id parameter.

sub_bookmaker_idintegerOptional

The sub-bookmaker id to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored. Note that this parameter is used together with the bookmaker_id parameter.

locationstringOptional

The location of the page where the request takes place.

Example: inplay_widget
Header parameters
x-vaix-client-idstringRequired

Custom client header, the value should be the name of the group the user belongs to

x-vaix-authentication-methodstringOptional

Authentication method to be used, supported values [vaix, iam]. Defaults to vaix

Responses
200

OK

application/json
get
/api/casino/offering/game_tags
GET /api/casino/offering/game_tags HTTP/1.1
Host: api.vaix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
x-vaix-client-id: text
Accept: */*
{
  "data": [
    {
      "game_tag": ""
    },
    {
      "game_tag": "adventure"
    },
    {
      "game_tag": "american"
    },
    {
      "game_tag": "animals"
    },
    {
      "game_tag": "arabian"
    }
  ],
  "status": "success"
}

Was this helpful?