Game Studios

Casino game studios endpoints

Get popular game studios

get

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

/api/casino/game_studios/popular

Returns popular game studios for the given time frame.

The game studios are sorted by popularity.

Popularity

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

Filtering example

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

$ curl --request GET \
  --url 'https://api.vaix.ai/api/casino/game_studios/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 studios to return.

Default: 100Example: 10

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

API response

statusstring · enumOptional

The status of the request

Possible values:

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_studios/popular

HTTPcURLJavaScriptPython

GET /api/casino/game_studios/popular HTTP/1.1
Host: api.vaix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
x-vaix-client-id: text
Accept: */*

{
  "data": [
    {
      "confidence": 1,
      "game_studio": "ogs"
    },
    {
      "confidence": 0.34103827207275483,
      "game_studio": "oryx"
    },
    {
      "confidence": 0.3024188455222938,
      "game_studio": "micro"
    },
    {
      "confidence": 0.2480106100795756,
      "game_studio": "playngo"
    },
    {
      "confidence": 0.22868510799545283,
      "game_studio": "yggdrasil"
    },
    {
      "confidence": 0.2116647720095996,
      "game_studio": "quickspin"
    },
    {
      "confidence": 0.06258683844890742,
      "game_studio": "leander"
    },
    {
      "confidence": 0.061039535177466214,
      "game_studio": "nolimitcity"
    },
    {
      "confidence": 0.018157130226095743,
      "game_studio": "novomatic"
    },
    {
      "confidence": 0.015915119363395226,
      "game_studio": "redtiger"
    }
  ],
  "status": "success"
}

Get recommended game studios

get

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

/api/casino/game_studios/recommended

Returns personalized game studios 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 studios 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 studios 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_studios/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

countinteger · min: 1Optional

Number of game studios to return.

Default: 100Example: 10

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

API response

statusstring · enumOptional

The status of the request

Possible values:

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_studios/recommended

HTTPcURLJavaScriptPython

GET /api/casino/game_studios/recommended HTTP/1.1
Host: api.vaix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
x-vaix-client-id: text
Accept: */*

{
  "data": [
    {
      "confidence": 0.999753,
      "game_studio": "ogs"
    },
    {
      "confidence": 0.147892907,
      "game_studio": "yggdrasil"
    },
    {
      "confidence": 0.105069004,
      "game_studio": "micro"
    },
    {
      "confidence": 0.0962480903,
      "game_studio": "quickspin"
    },
    {
      "confidence": 0.0286131557,
      "game_studio": "playngo"
    }
  ],
  "status": "success"
}

Get trending game studios

get

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

/api/casino/game_studios/trending

Returns trending game studios for the given time frame.

The game studios are sorted by trending score.

Trending score

To calculate trending score for a game studio, each session played on this game studio 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 studios at 2022-03-25.

$ curl --request GET \
  --url 'https://api.vaix.ai/api/casino/game_studios/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 studios to return.

Default: 100Example: 10

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

API response

statusstring · enumOptional

The status of the request

Possible values:

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_studios/trending

HTTPcURLJavaScriptPython

GET /api/casino/game_studios/trending HTTP/1.1
Host: api.vaix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
x-vaix-client-id: text
Accept: */*

{
  "data": [
    {
      "confidence": 1,
      "game_studio": "ogs"
    },
    {
      "confidence": 0.8062638943376491,
      "game_studio": "yggdrasil"
    },
    {
      "confidence": 0.7409293008547623,
      "game_studio": "micro"
    },
    {
      "confidence": 0.6723165353020203,
      "game_studio": "pragmatic"
    },
    {
      "confidence": 0.6485460727320286,
      "game_studio": "playngo"
    },
    {
      "confidence": 0.6370828726654545,
      "game_studio": "redtiger"
    },
    {
      "confidence": 0.3895526469084726,
      "game_studio": "quickspin"
    },
    {
      "confidence": 0.2814294375691003,
      "game_studio": "netent"
    },
    {
      "confidence": 0.19909174126514273,
      "game_studio": "evolution"
    },
    {
      "confidence": 0.19311791908888823,
      "game_studio": "skywind"
    },
    {
      "confidence": 0.18128915676973753,
      "game_studio": "novomatic"
    },
    {
      "confidence": 0.17337755744974273,
      "game_studio": "nolimitcity"
    },
    {
      "confidence": 0.16970113056813735,
      "game_studio": "betsoft"
    },
    {
      "confidence": 0.15186882556439257,
      "game_studio": "leander"
    },
    {
      "confidence": 0,
      "game_studio": "oryx"
    }
  ],
  "status": "success"
}

Get all casino game studios

get

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

/api/casino/offering/game_studios

Returns all casino game studios.

Example

In this example we get all casino game studios.

$ curl --request GET \
  --url 'https://api.vaix.ai/api/casino/offering/game_studios

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

Default: operatorPossible values:

countinteger · min: 1Optional

Number of game studios to return.

Default: 100Example: 10

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

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

API response

statusstring · enumOptional

The status of the request

Possible values:

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_studios

HTTPcURLJavaScriptPython

GET /api/casino/offering/game_studios HTTP/1.1
Host: api.vaix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
x-vaix-client-id: text
Accept: */*

{
  "data": [
    {
      "game_studio": "yggdrasil"
    },
    {
      "game_studio": "skywind"
    },
    {
      "game_studio": "redtiger"
    },
    {
      "game_studio": "quickspin"
    },
    {
      "game_studio": "pragmatic"
    },
    {
      "game_studio": "playngo"
    },
    {
      "game_studio": "oryx"
    },
    {
      "game_studio": "ogs"
    },
    {
      "game_studio": "novomatic"
    },
    {
      "game_studio": "nolimitcity"
    },
    {
      "game_studio": "netent"
    },
    {
      "game_studio": "micro"
    },
    {
      "game_studio": "leander"
    },
    {
      "game_studio": "igt"
    },
    {
      "game_studio": "evolution"
    },
    {
      "game_studio": "betsoft"
    }
  ],
  "status": "success"
}