Game Tags

Casino game tags related endpoints

Get popular game tags

get

https://api.vaix.aihttps://staging-api.vaix.ai

/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

BearerAuth

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

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

406

Not Acceptable

application/json

413

Request Entity Too Large

application/json

422

Unprocessable Entity

application/json

425

Too Early

application/json

500

Internal Server Error

application/json

get

/api/casino/game_tags/popular

HTTPcURLJavaScriptPython

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 recommended game tags

get

https://api.vaix.aihttps://staging-api.vaix.ai

/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

BearerAuth

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

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

406

Not Acceptable

application/json

413

Request Entity Too Large

application/json

422

Unprocessable Entity

application/json

425

Too Early

application/json

500

Internal Server Error

application/json

get

/api/casino/game_tags/recommended

HTTPcURLJavaScriptPython

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 trending game tags

get

https://api.vaix.aihttps://staging-api.vaix.ai

/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

BearerAuth

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

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

406

Not Acceptable

application/json

413

Request Entity Too Large

application/json

422

Unprocessable Entity

application/json

425

Too Early

application/json

500

Internal Server Error

application/json

get

/api/casino/game_tags/trending

HTTPcURLJavaScriptPython

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

https://api.vaix.aihttps://staging-api.vaix.ai

/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

BearerAuth

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

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

406

Not Acceptable

application/json

413

Request Entity Too Large

application/json

422

Unprocessable Entity

application/json

425

Too Early

application/json

500

Internal Server Error

application/json

get

/api/casino/offering/game_tags

HTTPcURLJavaScriptPython

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"
}