Go (SDK)

package main

import(
	"context"
	mka1 "github.com/MeetKai/mka1-sdks/go"
	"github.com/MeetKai/mka1-sdks/go/models/components"
	"github.com/MeetKai/mka1-sdks/go/types"
	"github.com/MeetKai/mka1-sdks/go/optionalnullable"
	"log"
)

func main() {
    ctx := context.Background()

    s := mka1.New(
        mka1.WithSecurity("<YOUR_BEARER_TOKEN_HERE>"),
    )

    res, err := s.Analytics.Query(ctx, "<id>", components.AnalyticsQueryRequest{
        Metric: components.AnalyticsQueryRequestMetricUniqueVisitors,
        From: types.MustTimeFromString("2026-09-01T00:00:00Z"),
        To: types.MustTimeFromString("2026-09-02T00:00:00Z"),
        EventName: mka1.Pointer("page_view"),
        Bucket: components.BucketHour.ToPointer(),
        Timezone: mka1.Pointer("America/Los_Angeles"),
        GroupBy: mka1.Pointer("pathname"),
        Filters: []components.AnalyticsQueryRequestFilter{
            components.AnalyticsQueryRequestFilter{
                Property: "plan",
                Op: components.AnalyticsQueryRequestOpEq,
                Value: optionalnullable.From(mka1.Pointer(components.CreateAnalyticsQueryRequestValueStr(
                    "pro",
                ))),
            },
        },
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.AnalyticsQueryResponse != nil {
        // handle response
    }
}

using MeetKai.MKA1;
using MeetKai.MKA1.Types.Components;
using System;
using System.Collections.Generic;

var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

var res = await sdk.Analytics.QueryAsync(
    id: "<id>",
    body: new MeetKai.MKA1.Types.Components.AnalyticsQueryRequest() {
        Metric = AnalyticsQueryRequestMetric.UniqueVisitors,
        From = System.DateTime.Parse("2026-09-01T00:00:00Z").ToUniversalTime(),
        To = System.DateTime.Parse("2026-09-02T00:00:00Z").ToUniversalTime(),
        EventName = "page_view",
        Bucket = Bucket.Hour,
        Timezone = "America/Los_Angeles",
        GroupBy = "pathname",
        Filters = new List<AnalyticsQueryRequestFilter>() {
            new AnalyticsQueryRequestFilter() {
                Property = "plan",
                Op = AnalyticsQueryRequestOp.Eq,
                Value = AnalyticsQueryRequestValue.CreateStr(
                    "pro"
                ),
            },
        },
    }
);

// handle response

from meetkai_mka1 import SDK
from meetkai_mka1.utils import parse_datetime


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.analytics.query(id="<id>", metric="unique_visitors", from_=parse_datetime("2026-09-01T00:00:00Z"), to=parse_datetime("2026-09-02T00:00:00Z"), event_name="page_view", bucket="hour", timezone="America/Los_Angeles", group_by="pathname", filters=[
        {
            "property": "plan",
            "op": "eq",
            "value": "pro",
        },
    ], limit=100)

    # Handle response
    print(res)

import { SDK } from "@meetkai/mka1";

const sdk = new SDK({
  bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await sdk.analytics.query({
    id: "<id>",
    analyticsQueryRequest: {
      metric: "unique_visitors",
      from: new Date("2026-09-01T00:00:00Z"),
      to: new Date("2026-09-02T00:00:00Z"),
      eventName: "page_view",
      bucket: "hour",
      timezone: "America/Los_Angeles",
      groupBy: "pathname",
      filters: [
        {
          property: "plan",
          op: "eq",
          value: "pro",
        },
      ],
    },
  });

  console.log(result);
}

run();

curl --request POST \
  --url https://apigw.mka1.com/api/v1/analytics/projects/{id}/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metric": "unique_visitors",
  "from": "2026-09-01T00:00:00Z",
  "to": "2026-09-02T00:00:00Z",
  "event_name": "page_view",
  "bucket": "hour",
  "timezone": "America/Los_Angeles",
  "group_by": "pathname",
  "filters": [
    {
      "property": "plan",
      "op": "eq",
      "value": "pro"
    }
  ],
  "limit": 100
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    metric: 'unique_visitors',
    from: '2026-09-01T00:00:00Z',
    to: '2026-09-02T00:00:00Z',
    event_name: 'page_view',
    bucket: 'hour',
    timezone: 'America/Los_Angeles',
    group_by: 'pathname',
    filters: [{property: 'plan', op: 'eq', value: 'pro'}],
    limit: 100
  })
};

fetch('https://apigw.mka1.com/api/v1/analytics/projects/{id}/query', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apigw.mka1.com/api/v1/analytics/projects/{id}/query",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'metric' => 'unique_visitors',
    'from' => '2026-09-01T00:00:00Z',
    'to' => '2026-09-02T00:00:00Z',
    'event_name' => 'page_view',
    'bucket' => 'hour',
    'timezone' => 'America/Los_Angeles',
    'group_by' => 'pathname',
    'filters' => [
        [
                'property' => 'plan',
                'op' => 'eq',
                'value' => 'pro'
        ]
    ],
    'limit' => 100
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.post("https://apigw.mka1.com/api/v1/analytics/projects/{id}/query")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"metric\": \"unique_visitors\",\n  \"from\": \"2026-09-01T00:00:00Z\",\n  \"to\": \"2026-09-02T00:00:00Z\",\n  \"event_name\": \"page_view\",\n  \"bucket\": \"hour\",\n  \"timezone\": \"America/Los_Angeles\",\n  \"group_by\": \"pathname\",\n  \"filters\": [\n    {\n      \"property\": \"plan\",\n      \"op\": \"eq\",\n      \"value\": \"pro\"\n    }\n  ],\n  \"limit\": 100\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/analytics/projects/{id}/query")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"metric\": \"unique_visitors\",\n  \"from\": \"2026-09-01T00:00:00Z\",\n  \"to\": \"2026-09-02T00:00:00Z\",\n  \"event_name\": \"page_view\",\n  \"bucket\": \"hour\",\n  \"timezone\": \"America/Los_Angeles\",\n  \"group_by\": \"pathname\",\n  \"filters\": [\n    {\n      \"property\": \"plan\",\n      \"op\": \"eq\",\n      \"value\": \"pro\"\n    }\n  ],\n  \"limit\": 100\n}"

response = http.request(request)
puts response.read_body

{
  "metric": "count",
  "rows": [
    {
      "value": 1,
      "bucket": "2026-09-17T07:00:00Z",
      "group": "<string>"
    }
  ]
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

Eventos

Query events

Conte eventos ou visitantes únicos em um intervalo de tempo. Opcionalmente, filtre por nome do evento ou propriedades, agrupe por uma propriedade e divida os resultados em intervalos de hora, dia ou semana que começam no horário de um fuso horário IANA, UTC por padrão. Cada intervalo é retornado como o instante em UTC em que ele começa. O intervalo inclui o valor inicial e exclui o final. IDs de eventos duplicados são contados apenas uma vez. Um fuso horário desconhecido retorna 400.

POST

api

analytics

projects

{id}

query

Go (SDK)

package main

import(
	"context"
	mka1 "github.com/MeetKai/mka1-sdks/go"
	"github.com/MeetKai/mka1-sdks/go/models/components"
	"github.com/MeetKai/mka1-sdks/go/types"
	"github.com/MeetKai/mka1-sdks/go/optionalnullable"
	"log"
)

func main() {
    ctx := context.Background()

    s := mka1.New(
        mka1.WithSecurity("<YOUR_BEARER_TOKEN_HERE>"),
    )

    res, err := s.Analytics.Query(ctx, "<id>", components.AnalyticsQueryRequest{
        Metric: components.AnalyticsQueryRequestMetricUniqueVisitors,
        From: types.MustTimeFromString("2026-09-01T00:00:00Z"),
        To: types.MustTimeFromString("2026-09-02T00:00:00Z"),
        EventName: mka1.Pointer("page_view"),
        Bucket: components.BucketHour.ToPointer(),
        Timezone: mka1.Pointer("America/Los_Angeles"),
        GroupBy: mka1.Pointer("pathname"),
        Filters: []components.AnalyticsQueryRequestFilter{
            components.AnalyticsQueryRequestFilter{
                Property: "plan",
                Op: components.AnalyticsQueryRequestOpEq,
                Value: optionalnullable.From(mka1.Pointer(components.CreateAnalyticsQueryRequestValueStr(
                    "pro",
                ))),
            },
        },
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.AnalyticsQueryResponse != nil {
        // handle response
    }
}

using MeetKai.MKA1;
using MeetKai.MKA1.Types.Components;
using System;
using System.Collections.Generic;

var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

var res = await sdk.Analytics.QueryAsync(
    id: "<id>",
    body: new MeetKai.MKA1.Types.Components.AnalyticsQueryRequest() {
        Metric = AnalyticsQueryRequestMetric.UniqueVisitors,
        From = System.DateTime.Parse("2026-09-01T00:00:00Z").ToUniversalTime(),
        To = System.DateTime.Parse("2026-09-02T00:00:00Z").ToUniversalTime(),
        EventName = "page_view",
        Bucket = Bucket.Hour,
        Timezone = "America/Los_Angeles",
        GroupBy = "pathname",
        Filters = new List<AnalyticsQueryRequestFilter>() {
            new AnalyticsQueryRequestFilter() {
                Property = "plan",
                Op = AnalyticsQueryRequestOp.Eq,
                Value = AnalyticsQueryRequestValue.CreateStr(
                    "pro"
                ),
            },
        },
    }
);

// handle response

from meetkai_mka1 import SDK
from meetkai_mka1.utils import parse_datetime


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.analytics.query(id="<id>", metric="unique_visitors", from_=parse_datetime("2026-09-01T00:00:00Z"), to=parse_datetime("2026-09-02T00:00:00Z"), event_name="page_view", bucket="hour", timezone="America/Los_Angeles", group_by="pathname", filters=[
        {
            "property": "plan",
            "op": "eq",
            "value": "pro",
        },
    ], limit=100)

    # Handle response
    print(res)

import { SDK } from "@meetkai/mka1";

const sdk = new SDK({
  bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await sdk.analytics.query({
    id: "<id>",
    analyticsQueryRequest: {
      metric: "unique_visitors",
      from: new Date("2026-09-01T00:00:00Z"),
      to: new Date("2026-09-02T00:00:00Z"),
      eventName: "page_view",
      bucket: "hour",
      timezone: "America/Los_Angeles",
      groupBy: "pathname",
      filters: [
        {
          property: "plan",
          op: "eq",
          value: "pro",
        },
      ],
    },
  });

  console.log(result);
}

run();

curl --request POST \
  --url https://apigw.mka1.com/api/v1/analytics/projects/{id}/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metric": "unique_visitors",
  "from": "2026-09-01T00:00:00Z",
  "to": "2026-09-02T00:00:00Z",
  "event_name": "page_view",
  "bucket": "hour",
  "timezone": "America/Los_Angeles",
  "group_by": "pathname",
  "filters": [
    {
      "property": "plan",
      "op": "eq",
      "value": "pro"
    }
  ],
  "limit": 100
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    metric: 'unique_visitors',
    from: '2026-09-01T00:00:00Z',
    to: '2026-09-02T00:00:00Z',
    event_name: 'page_view',
    bucket: 'hour',
    timezone: 'America/Los_Angeles',
    group_by: 'pathname',
    filters: [{property: 'plan', op: 'eq', value: 'pro'}],
    limit: 100
  })
};

fetch('https://apigw.mka1.com/api/v1/analytics/projects/{id}/query', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apigw.mka1.com/api/v1/analytics/projects/{id}/query",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'metric' => 'unique_visitors',
    'from' => '2026-09-01T00:00:00Z',
    'to' => '2026-09-02T00:00:00Z',
    'event_name' => 'page_view',
    'bucket' => 'hour',
    'timezone' => 'America/Los_Angeles',
    'group_by' => 'pathname',
    'filters' => [
        [
                'property' => 'plan',
                'op' => 'eq',
                'value' => 'pro'
        ]
    ],
    'limit' => 100
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.post("https://apigw.mka1.com/api/v1/analytics/projects/{id}/query")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"metric\": \"unique_visitors\",\n  \"from\": \"2026-09-01T00:00:00Z\",\n  \"to\": \"2026-09-02T00:00:00Z\",\n  \"event_name\": \"page_view\",\n  \"bucket\": \"hour\",\n  \"timezone\": \"America/Los_Angeles\",\n  \"group_by\": \"pathname\",\n  \"filters\": [\n    {\n      \"property\": \"plan\",\n      \"op\": \"eq\",\n      \"value\": \"pro\"\n    }\n  ],\n  \"limit\": 100\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/analytics/projects/{id}/query")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"metric\": \"unique_visitors\",\n  \"from\": \"2026-09-01T00:00:00Z\",\n  \"to\": \"2026-09-02T00:00:00Z\",\n  \"event_name\": \"page_view\",\n  \"bucket\": \"hour\",\n  \"timezone\": \"America/Los_Angeles\",\n  \"group_by\": \"pathname\",\n  \"filters\": [\n    {\n      \"property\": \"plan\",\n      \"op\": \"eq\",\n      \"value\": \"pro\"\n    }\n  ],\n  \"limit\": 100\n}"

response = http.request(request)
puts response.read_body

{
  "metric": "count",
  "rows": [
    {
      "value": 1,
      "bucket": "2026-09-17T07:00:00Z",
      "group": "<string>"
    }
  ]
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

Autorizações

Authorization

string

header

obrigatório

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Parâmetros de caminho

string

obrigatório

ID of the analytics project. ID do projeto de análises.

Required string length: 1 - 128

Pattern: ^[^\u0000]*$

Corpo

application/json

metric

enum<string>

obrigatório

count conta eventos. unique_visitors conta valores distintos de distinct_id. Ambos deduplicam os IDs de evento primeiro.

Opções disponíveis:

count,

unique_visitors

from

string<date-time>

obrigatório

Início do intervalo de tempo, inclusive. Use um carimbo de data/hora ISO 8601 com Z para UTC ou um deslocamento como -07:00. Deve ser anterior a to.

Exemplo:

"2026-09-01T00:00:00Z"

string<date-time>

obrigatório

Fim do intervalo de tempo, exclusivo. Use um timestamp ISO 8601 com Z para UTC ou um deslocamento como -07:00. Deve ser posterior a from.

Exemplo:

"2026-09-02T00:00:00Z"

event_name

string

Inclua apenas eventos com este nome exato. Omita para incluir todos os nomes de eventos.

Required string length: 1 - 255

Exemplo:

"page_view"

bucket

enum<string>

Divida os resultados em intervalos de tempo. As horas, os dias e as semanas com início na segunda-feira começam no relógio do fuso horário, que por padrão é UTC. Intervalos vazios são omitidos.

Opções disponíveis:

hour,

day,

week

timezone

string

Nome de fuso horário da IANA que define onde os buckets começam. O padrão é UTC. Um dia é um dia de calendário local e dura 23 ou 25 horas quando os relógios mudam. Em zonas com deslocamento de 30 ou 45 minutos, as horas começam no relógio local. Deslocamentos UTC como +05:30 são rejeitados, assim como identificadores fora do banco de dados IANA, como PST ou BST, e nomes que o banco de dados de fuso horário do serviço não conhece, o que pode ficar atrás das zonas IANA mais recentes; use UTC como fallback quando os nomes de timezone retornarem 400. Apenas os limites dos buckets mudam: from, to, filters e o formato UTC do bucket de cada linha permanecem os mesmos. Não tem efeito sem bucket.

Required string length: 1 - 64

Exemplos:

"America/Los_Angeles"

"Asia/Kolkata"

"UTC"

group_by

string

Agrupe os resultados por uma propriedade do evento. Valores ausentes e nulos compartilham um grupo.

Required string length: 1 - 128

Pattern: ^[^\u0000]*$

Exemplo:

"pathname"

filters

object[]

Filtros de propriedade combinados com AND. Um evento deve corresponder a todos os filtros.

Maximum array length: 10

Show child attributes

limit

integer

padrão:100

Número máximo de linhas de resultado, incluindo linhas criadas por intervalos de tempo e grupos de propriedades.

Intervalo obrigatório: 1 <= x <= 1000

Resposta

Sucesso

metric

enum<string>

obrigatório

Opções disponíveis:

count,

unique_visitors

rows

object[]

obrigatório

Show child attributes

⌘I

Responses and conversations

Models and routing

Images and audio

Files and retrieval

Agents

Tools and sandbox

Evals and feedback

Compute

Repositories

Dataset generations

Organizations and access

Usage and budgets

Application utilities

Analytics

Legacy APIs

Additional APIs

Query events

Autorizações

Parâmetros de caminho

Corpo

Resposta