AI assistant statistics API

Authorization: Bearer as_9f2c1a7e…

HTTP/1.1 403 Forbidden
Content-Type: application/json; charset=utf-8

{ "error": "forbidden", "message": "Kľúč nemá prístup k mutácii demo-shop.cz." }

curl "https://asistent.ragnetiq.com/api/stats/v1/client" \
  -H "Authorization: Bearer as_YOUR_KEY"

{
  "client": "Demo Shop",
  "access": "client",
  "markets": [
    { "market": "demo-shop.sk", "country": "Slovensko" },
    { "market": "demo-shop.cz", "country": "Česko" }
  ],
  "modules": { "orders": true, "carts": true }
}

curl "https://asistent.ragnetiq.com/api/stats/v1/summary?from=2026-10-01&to=2026-10-15" \
  -H "Authorization: Bearer as_YOUR_KEY"

{
  "client": "Demo Shop",
  "markets": null,
  "from": "2026-10-01",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "totals": {
    "sessions": 1028,
    "users": 846,
    "returning_users": 131,
    "messages": 3410,
    "recommendation_sessions": 612,
    "click_sessions": 247,
    "click_rate": 0.2403,
    "emails": 58,
    "email_rate": 0.0564,
    "avg_duration_seconds": 214,
    "total_duration_seconds": 198732,
    "support_savings_eur": 6063
  },
  "previous": { "from": "2026-09-16", "to": "2026-09-30", "sessions": 964, "…": "…" },
  "funnel": { "sessions": 1028, "recommendation_sessions": 612, "click_sessions": 247, "carts": 91, "orders": 52 },
  "orders": { "count": 52, "revenue": 3184.6, "currency": "EUR", "previous": { "count": 47, "revenue": 2911.2, "currency": "EUR" } },
  "carts": { "count": 91, "revenue": 0, "currency": "EUR", "previous": { "count": 85, "revenue": 0, "currency": "EUR" } },
  "daily": [
    { "day": "2026-10-01", "sessions": 71, "click_sessions": 17, "emails": 4 },
    { "day": "2026-10-02", "sessions": 64, "click_sessions": 15, "emails": 3 }
  ],
  "markets": [
    { "market": "demo-shop.sk", "country": "Slovensko", "sessions": 804, "users": 661, "messages": 2671,
      "click_sessions": 196, "click_rate": 0.2438, "emails": 47 },
    { "market": "demo-shop.cz", "country": "Česko", "sessions": 224, "users": 185, "messages": 739,
      "click_sessions": 51, "click_rate": 0.2277, "emails": 11 }
  ]
}

curl "https://asistent.ragnetiq.com/api/stats/v1/conversations?market=demo-shop.cz&from=2026-10-01&to=2026-10-15&limit=200" \
  -H "Authorization: Bearer as_YOUR_KEY"

{
  "client": "Demo Shop",
  "markets": ["demo-shop.cz"],
  "from": "2026-10-01",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "items": [
    {
      "id": "3f0c5a92-6b1e-4c7d-9a10-2e8f4b6d1c55",
      "market": "demo-shop.cz",
      "started_at": "2026-10-14T08:21:36.412+00:00",
      "visitor_id": "k2v9x1m4p7q8r3s6",
      "user_messages": 3,
      "had_recommendation": true,
      "had_click": true,
      "email_submitted": false,
      "city": "Brno",
      "duration_seconds": 184,
      "feedback": "positive",
      "messages": [
        { "role": "user", "content": "Jaký čaj doporučujete na spaní?", "at": "2026-10-14T08:21:36.412Z" },
        { "role": "assistant", "content": "Na klidný spánek vyzkoušejte **Bylinný čaj 100 g** …", "at": "2026-10-14T08:21:39.907Z" }
      ]
    }
  ],
  "next": "MjAyNi0xMC0xNFQwODoyMTozNi40MTIrMDA6MDB8M2YwYzVhOTI…"
}

curl "https://asistent.ragnetiq.com/api/stats/v1/products?from=2026-09-16&to=2026-10-15" \
  -H "Authorization: Bearer as_YOUR_KEY"

{
  "client": "Demo Shop",
  "markets": null,
  "from": "2026-09-16",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "items": [
    { "product_id": "1042", "name": "Bylinný čaj 100 g", "url": "https://demo-shop.sk/bylinny-caj-100-g",
      "recommendations": 214, "clicks": 61, "click_rate": 0.285, "avg_position": 1.4 }
  ]
}

curl "https://asistent.ragnetiq.com/api/stats/v1/orders?from=2026-10-01&to=2026-10-15" \
  -H "Authorization: Bearer as_YOUR_KEY"

{
  "client": "Demo Shop",
  "markets": null,
  "from": "2026-10-01",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "count": 52,
  "revenue": 3184.6,
  "currency": "EUR",
  "items": [
    {
      "id": "2026001234",
      "code": "2026001234",
      "created_at": "2026-10-14T09:02:11.055Z",
      "attribution": "direct",
      "confidence": 0.92,
      "revenue": 42.9,
      "currency": "EUR",
      "recommendation_query": "čaj na spanie",
      "recommended_product": "Bylinný čaj 100 g",
      "clicked_url": "https://demo-shop.sk/bylinny-caj-100-g",
      "minutes_from_click": 18,
      "conversation": [
        { "role": "user", "content": "Aký čaj odporúčate na spanie?", "at": "2026-10-14T08:41:02.118Z" }
      ]
    }
  ]
}

curl "https://asistent.ragnetiq.com/api/stats/v1/carts?market=demo-shop.sk&from=2026-10-01&to=2026-10-15" \
  -H "Authorization: Bearer as_YOUR_KEY"

const BASE = "https://asistent.ragnetiq.com/api/stats/v1";
const headers = { Authorization: `Bearer ${process.env.ASSISTANT_API_KEY}` };

async function get(path, params = {}) {
  const url = new URL(BASE + path);
  for (const [k, v] of Object.entries(params)) if (v != null) url.searchParams.set(k, String(v));
  const res = await fetch(url, { headers });
  if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
  return res.json();
}

// summary for September
const summary = await get("/summary", { from: "2026-09-01", to: "2026-09-30" });
console.log(summary.totals.sessions, summary.orders?.count);

// all conversations, page by page
let after = null;
do {
  const page = await get("/conversations", { from: "2026-09-01", to: "2026-09-30", after, limit: 200 });
  for (const c of page.items) store(c); // your logic
  after = page.next;
} while (after);

import os, requests

BASE = "https://asistent.ragnetiq.com/api/stats/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['ASSISTANT_API_KEY']}"}

def get(path, **params):
    r = requests.get(BASE + path, headers=HEADERS, params=params, timeout=60)
    r.raise_for_status()
    return r.json()

summary = get("/summary", **{"from": "2026-09-01", "to": "2026-09-30", "market": "demo-shop.cz"})
print(summary["totals"]["sessions"])

orders = get("/orders", **{"from": "2026-09-01", "to": "2026-09-30"})
for order in orders["items"]:
    ...  # your logic