Query events

Python (SDK)

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();

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

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

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\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}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

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

POST

api

analytics

projects

{id}

query

Python (SDK)

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();

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

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

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\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}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

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

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

ID of the analytics project.

Required string length: 1 - 128

Pattern: ^[^\u0000]*$

Body

application/json

metric

enum<string>

required

count counts events. unique_visitors counts distinct values of distinct_id. Both deduplicate event IDs first.

Available options:

count,

unique_visitors

from

string<date-time>

required

Start of the time range, inclusive. Use an ISO 8601 timestamp with Z for UTC or an offset such as -07:00. Must be before to.

Example:

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

string<date-time>

required

End of the time range, exclusive. Use an ISO 8601 timestamp with Z for UTC or an offset such as -07:00. Must be after from.

Example:

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

event_name

string

Only include events with this exact name. Omit to include all event names.

Required string length: 1 - 255

Example:

"page_view"

bucket

enum<string>

Split results into time buckets. Hours, days, and Monday-start weeks begin on the clock of timezone, which defaults to UTC. Empty buckets are omitted.

Available options:

hour,

day,

week

timezone

string

IANA time zone name that sets where buckets start. Defaults to UTC. A day is a local calendar day and lasts 23 or 25 hours when the clocks change. In zones offset by 30 or 45 minutes, hours start on the local clock. UTC offsets such as +05:30 are rejected, as are identifiers outside the IANA database such as PST or BST, and names the service's time zone database does not know, which can lag the newest IANA zones; fall back to UTC when the 400 names timezone. Only bucket boundaries change: from, to, filters, and the UTC format of each row's bucket stay the same. Has no effect without bucket.

Required string length: 1 - 64

Examples:

"America/Los_Angeles"

"Asia/Kolkata"

"UTC"

group_by

string

Group results by one event property. Missing values and null share a group.

Required string length: 1 - 128

Pattern: ^[^\u0000]*$

Example:

"pathname"

filters

object[]

Property filters combined with AND. An event must match every filter.

Maximum array length: 10

Show child attributes

limit

integer

default:100

Maximum number of result rows, including rows created by time buckets and property groups.

Required range: 1 <= x <= 1000

Response

Success

metric

enum<string>

required

Available options:

count,

unique_visitors

rows

object[]

required

Show child attributes

⌘I

Overview

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

Authorizations

Path Parameters

Body

Response