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.events.search(id="<id>", from_=parse_datetime("2026-09-17T07:00:00Z"), to=parse_datetime("2026-09-17T08:00:00Z"), event_name="page_view", filters=[
        {
            "property": "plan",
            "op": "eq",
            "value": "pro",
        },
    ], distinct_id="visitor-123", limit=50)

    # 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.events.search({
    id: "<id>",
    analyticsEventSearchRequest: {
      from: new Date("2026-09-17T07:00:00Z"),
      to: new Date("2026-09-17T08:00:00Z"),
      eventName: "page_view",
      filters: [
        {
          property: "plan",
          op: "eq",
          value: "pro",
        },
      ],
      distinctId: "visitor-123",
    },
  });

  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.Events.SearchAsync(
    id: "<id>",
    body: new AnalyticsEventSearchRequest() {
        From = System.DateTime.Parse("2026-09-17T07:00:00Z").ToUniversalTime(),
        To = System.DateTime.Parse("2026-09-17T08:00:00Z").ToUniversalTime(),
        EventName = "page_view",
        Filters = new List<AnalyticsEventSearchRequestFilter>() {
            new AnalyticsEventSearchRequestFilter() {
                Property = "plan",
                Op = AnalyticsEventSearchRequestOp.Eq,
                Value = AnalyticsEventSearchRequestValue.CreateStr(
                    "pro"
                ),
            },
        },
        DistinctId = "visitor-123",
    }
);

// handle response

curl --request POST \
  --url https://apigw.mka1.com/api/v1/analytics/projects/{id}/events/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "2026-09-17T07:00:00Z",
  "to": "2026-09-17T08:00:00Z",
  "event_name": "page_view",
  "filters": [
    {
      "property": "plan",
      "op": "eq",
      "value": "pro"
    }
  ],
  "distinct_id": "visitor-123",
  "limit": 50
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    from: '2026-09-17T07:00:00Z',
    to: '2026-09-17T08:00:00Z',
    event_name: 'page_view',
    filters: [{property: 'plan', op: 'eq', value: 'pro'}],
    distinct_id: 'visitor-123',
    limit: 50
  })
};

fetch('https://apigw.mka1.com/api/v1/analytics/projects/{id}/events/search', 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}/events/search",
  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([
    'from' => '2026-09-17T07:00:00Z',
    'to' => '2026-09-17T08:00:00Z',
    'event_name' => 'page_view',
    'filters' => [
        [
                'property' => 'plan',
                'op' => 'eq',
                'value' => 'pro'
        ]
    ],
    'distinct_id' => 'visitor-123',
    'limit' => 50
  ]),
  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}/events/search"

	payload := strings.NewReader("{\n  \"from\": \"2026-09-17T07:00:00Z\",\n  \"to\": \"2026-09-17T08:00:00Z\",\n  \"event_name\": \"page_view\",\n  \"filters\": [\n    {\n      \"property\": \"plan\",\n      \"op\": \"eq\",\n      \"value\": \"pro\"\n    }\n  ],\n  \"distinct_id\": \"visitor-123\",\n  \"limit\": 50\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}/events/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"from\": \"2026-09-17T07:00:00Z\",\n  \"to\": \"2026-09-17T08:00:00Z\",\n  \"event_name\": \"page_view\",\n  \"filters\": [\n    {\n      \"property\": \"plan\",\n      \"op\": \"eq\",\n      \"value\": \"pro\"\n    }\n  ],\n  \"distinct_id\": \"visitor-123\",\n  \"limit\": 50\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"from\": \"2026-09-17T07:00:00Z\",\n  \"to\": \"2026-09-17T08:00:00Z\",\n  \"event_name\": \"page_view\",\n  \"filters\": [\n    {\n      \"property\": \"plan\",\n      \"op\": \"eq\",\n      \"value\": \"pro\"\n    }\n  ],\n  \"distinct_id\": \"visitor-123\",\n  \"limit\": 50\n}"

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

{
  "events": [
    {
      "event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "event_name": "page_view",
      "timestamp": "2026-09-01T12:30:00Z",
      "distinct_id": "<string>",
      "properties": {}
    }
  ],
  "next_cursor": "<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>"
}

analytics.events

Search events

Liste eventos individuais em um intervalo de tempo, do mais recente para o mais antigo, com suas propriedades. Opcionalmente, filtre por nome do evento, propriedades do evento ou pelo distinct_id de um visitante. O intervalo inclui o valor inicial e exclui o final, e IDs de eventos duplicados são retornados uma única vez, de modo que uma busca no intervalo de um bucket de gráfico com os mesmos filtros lista exatamente os eventos que esse bucket contabilizou. Uma página comporta até 100 eventos; passe next_cursor como cursor para a página seguinte até que ele seja nulo. A primeira página captura um instantâneo do relógio do ClickHouse antes de ler suas linhas, e seu cursor o carrega, então cada página da sequência, incluindo a primeira, lê apenas entregas recebidas em ou antes desse instantâneo e expira eventos de retenção conforme ele: nenhum evento se repete ou é ignorado, e eventos recebidos após o instantâneo, incluindo uma redelivery que revise um evento listado, aparecem somente quando a paginação recomeça sem um cursor. Há uma janela que desfoca essa fronteira: o ClickHouse marca o recebimento com segundos inteiros quando uma inserção começa e confirma suas linhas quando ela termina, então uma entrega marcada no segundo do instantâneo ou antes dele, mas que é confirmada após a leitura da primeira página, está dentro da sequência, mas ausente da primeira página; ela entra a partir da próxima página, na qual um evento não listado que ela adiciona ou move à frente do cursor é ignorado e um evento listado que uma redelivery com hash menor move para trás do cursor se repete em sua posição revisada. Um cursor que não decodifica, ou um de outra lista, retorna 400. Uma página cujos eventos excedem o limite de tamanho da resposta retorna 413; solicite um limite menor.

POST

api

analytics

projects

{id}

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.events.search(id="<id>", from_=parse_datetime("2026-09-17T07:00:00Z"), to=parse_datetime("2026-09-17T08:00:00Z"), event_name="page_view", filters=[
        {
            "property": "plan",
            "op": "eq",
            "value": "pro",
        },
    ], distinct_id="visitor-123", limit=50)

    # 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.events.search({
    id: "<id>",
    analyticsEventSearchRequest: {
      from: new Date("2026-09-17T07:00:00Z"),
      to: new Date("2026-09-17T08:00:00Z"),
      eventName: "page_view",
      filters: [
        {
          property: "plan",
          op: "eq",
          value: "pro",
        },
      ],
      distinctId: "visitor-123",
    },
  });

  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.Events.SearchAsync(
    id: "<id>",
    body: new AnalyticsEventSearchRequest() {
        From = System.DateTime.Parse("2026-09-17T07:00:00Z").ToUniversalTime(),
        To = System.DateTime.Parse("2026-09-17T08:00:00Z").ToUniversalTime(),
        EventName = "page_view",
        Filters = new List<AnalyticsEventSearchRequestFilter>() {
            new AnalyticsEventSearchRequestFilter() {
                Property = "plan",
                Op = AnalyticsEventSearchRequestOp.Eq,
                Value = AnalyticsEventSearchRequestValue.CreateStr(
                    "pro"
                ),
            },
        },
        DistinctId = "visitor-123",
    }
);

// handle response

curl --request POST \
  --url https://apigw.mka1.com/api/v1/analytics/projects/{id}/events/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "2026-09-17T07:00:00Z",
  "to": "2026-09-17T08:00:00Z",
  "event_name": "page_view",
  "filters": [
    {
      "property": "plan",
      "op": "eq",
      "value": "pro"
    }
  ],
  "distinct_id": "visitor-123",
  "limit": 50
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    from: '2026-09-17T07:00:00Z',
    to: '2026-09-17T08:00:00Z',
    event_name: 'page_view',
    filters: [{property: 'plan', op: 'eq', value: 'pro'}],
    distinct_id: 'visitor-123',
    limit: 50
  })
};

fetch('https://apigw.mka1.com/api/v1/analytics/projects/{id}/events/search', 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}/events/search",
  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([
    'from' => '2026-09-17T07:00:00Z',
    'to' => '2026-09-17T08:00:00Z',
    'event_name' => 'page_view',
    'filters' => [
        [
                'property' => 'plan',
                'op' => 'eq',
                'value' => 'pro'
        ]
    ],
    'distinct_id' => 'visitor-123',
    'limit' => 50
  ]),
  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}/events/search"

	payload := strings.NewReader("{\n  \"from\": \"2026-09-17T07:00:00Z\",\n  \"to\": \"2026-09-17T08:00:00Z\",\n  \"event_name\": \"page_view\",\n  \"filters\": [\n    {\n      \"property\": \"plan\",\n      \"op\": \"eq\",\n      \"value\": \"pro\"\n    }\n  ],\n  \"distinct_id\": \"visitor-123\",\n  \"limit\": 50\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}/events/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"from\": \"2026-09-17T07:00:00Z\",\n  \"to\": \"2026-09-17T08:00:00Z\",\n  \"event_name\": \"page_view\",\n  \"filters\": [\n    {\n      \"property\": \"plan\",\n      \"op\": \"eq\",\n      \"value\": \"pro\"\n    }\n  ],\n  \"distinct_id\": \"visitor-123\",\n  \"limit\": 50\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"from\": \"2026-09-17T07:00:00Z\",\n  \"to\": \"2026-09-17T08:00:00Z\",\n  \"event_name\": \"page_view\",\n  \"filters\": [\n    {\n      \"property\": \"plan\",\n      \"op\": \"eq\",\n      \"value\": \"pro\"\n    }\n  ],\n  \"distinct_id\": \"visitor-123\",\n  \"limit\": 50\n}"

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

{
  "events": [
    {
      "event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "event_name": "page_view",
      "timestamp": "2026-09-01T12:30:00Z",
      "distinct_id": "<string>",
      "properties": {}
    }
  ],
  "next_cursor": "<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

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"

filters

object[]

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

Maximum array length: 10

Show child attributes

distinct_id

string

Inclua apenas eventos enviados com este exact distinct_id.

Required string length: 1 - 255

Pattern: ^[^\u0000]*$

limit

integer

padrão:50

Número máximo de linhas nesta página.

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

cursor

string

Cursor opaco de no máximo 4096 caracteres, copiado de next_cursor da página anterior. Omitir na primeira página, que captura o snapshot da sequência completa na qual as leituras ocorrem. Os cursores pertencem a uma lista e a uma ordem de classificação; um cursor que não decodifica, ou um de outra lista, retorna 400. Um cursor é uma posição, não uma capacidade: um que decodifica apenas move o chamador dentro do mesmo projeto.

Required string length: 1 - 4096

Resposta

Sucesso

events

object[]

obrigatório

Eventos correspondentes, mais recentes primeiro. Eventos com o mesmo carimbo de data e hora são ordenados por event_id, em ordem decrescente.

Show child attributes

next_cursor

string | null

obrigatório

Cursor para a próxima página, ou null quando não houver mais linhas. Ele continua a sequência no snapshot da primeira página.

⌘I

Responses and conversations

Models and routing

Images and audio

Files and retrieval

Agents

Tools and sandbox

Evals and feedback

Compute

Repositories and datasets

Organizations and access

Usage and budgets

Application utilities

Analytics

Legacy APIs

Additional APIs

Search events

Autorizações

Parâmetros de caminho

Corpo

Resposta