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

Cuenta eventos o visitantes únicos en un intervalo de tiempo. Opcionalmente, filtra por nombre de evento o propiedades, agrupa por una propiedad y divide los resultados en intervalos de hora, día o semana que comienzan en el reloj de una zona horaria IANA, UTC de forma predeterminada. Cada intervalo se devuelve como el instante UTC en el que comienza. El intervalo incluye desde y excluye hasta. Los IDs de evento duplicados se cuentan una sola vez. Una zona horaria desconocida devuelve 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>"
}

Autorizaciones

Authorization

string

header

requerido

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 ruta

string

requerido

ID of the analytics project. ID del proyecto de análisis.

Required string length: 1 - 128

Pattern: ^[^\u0000]*$

Cuerpo

application/json

metric

enum<string>

requerido

count cuenta eventos. unique_visitors cuenta valores distintos de distinct_id. Ambos eliminan primero los IDs de evento duplicados.

Opciones disponibles:

count,

unique_visitors

from

string<date-time>

requerido

Inicio del intervalo de tiempo, inclusivo. Use una marca de tiempo ISO 8601 con Z para UTC o un desplazamiento como -07:00. Debe ser anterior a to.

Ejemplo:

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

string<date-time>

requerido

Fin del intervalo de tiempo, exclusivo. Utilice una marca de tiempo ISO 8601 con Z para UTC o un desfase como -07:00. Debe ser posterior a from.

Ejemplo:

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

event_name

string

Solo incluye eventos con este nombre exacto. Omite para incluir todos los nombres de eventos.

Required string length: 1 - 255

Ejemplo:

"page_view"

bucket

enum<string>

Dividir los resultados en intervalos de tiempo. Las horas, los días y las semanas que comienzan en lunes empiezan en la hora de la zona horaria, que por defecto es UTC. Los intervalos vacíos se omiten.

Opciones disponibles:

hour,

day,

week

timezone

string

Nombre de zona horaria IANA que establece dónde comienzan los buckets. El valor predeterminado es UTC. Un día es un día natural local y dura 23 o 25 horas cuando cambia el reloj. En zonas con desfase de 30 o 45 minutos, las horas comienzan según el reloj local. Se rechazan desfases UTC como +05:30, al igual que identificadores fuera de la base de datos IANA como PST o BST, y nombres que la base de datos de zonas horarias del servicio no conoce, que puede ir por detrás de las zonas IANA más recientes; vuelva a UTC cuando el 400 nombres timezone. Solo cambian los límites de los buckets: from, to, filters y el formato UTC del bucket de cada fila permanecen igual. No tiene efecto sin bucket.

Required string length: 1 - 64

Ejemplos:

"America/Los_Angeles"

"Asia/Kolkata"

"UTC"

group_by

string

Agrupa los resultados por una propiedad del evento. Los valores faltantes y null comparten un grupo.

Required string length: 1 - 128

Pattern: ^[^\u0000]*$

Ejemplo:

"pathname"

filters

object[]

Filtros de propiedades combinados con AND. Un evento debe coincidir con todos los filtros.

Maximum array length: 10

Show child attributes

limit

integer

predeterminado:100

Número máximo de filas de resultados, incluidas las filas creadas por intervalos de tiempo y grupos de propiedades.

Rango requerido: 1 <= x <= 1000

Respuesta

Éxito

metric

enum<string>

requerido

Opciones disponibles:

count,

unique_visitors

rows

object[]

requerido

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

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta