SmartBox statistics API

Authorization: Bearer sb_9f2c1a7e…

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

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

curl "https://smartbox.ragnetiq.com/api/stats/v1/shops" \
  -H "Authorization: Bearer sb_YOUR_KEY"

{
  "shops": [
    {
      "id": "demo-shop",
      "name": "Demo Shop",
      "platform": "upgates",
      "access": "shop",
      "markets": [
        { "website": "demo-shop.sk", "language": "sk", "currency": "EUR" },
        { "website": "demo-shop.cz", "language": "cs", "currency": "CZK" }
      ]
    }
  ]
}

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

{
  "shops": ["demo-shop"],
  "markets": null,
  "from": "2026-10-01",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "totals": {
    "users": 805,
    "interactions": 1714,
    "chip_clicks": 1623,
    "custom_inputs": 91,
    "answers": 1702,
    "products": 383,
    "returning_users": 412,
    "custom_users": 74,
    "orders": 139,
    "direct_orders": 100,
    "assisted_orders": 39,
    "converted_users": 137,
    "user_conversion_rate": 0.1702,
    "direct_conversion_rate": 0.1242,
    "revenue": [
      { "currency": "EUR", "total": 5314.2, "direct": 4102.9, "orders": 112, "avg_order": 47.45 },
      { "currency": "CZK", "total": 27838, "direct": 21390, "orders": 27, "avg_order": 1031.04 }
    ]
  },
  "previous": { "from": "2026-09-16", "to": "2026-09-30", "users": 731, "…": "…" },
  "daily": [
    { "day": "2026-10-01", "users": 54, "interactions": 117, "direct_orders": 7, "assisted_orders": 2 },
    { "day": "2026-10-02", "users": 49, "interactions": 98, "direct_orders": 5, "assisted_orders": 3 }
  ],
  "funnel": { "users": 805, "answered": 798, "ordered": 136, "direct": 99 },
  "markets": [
    { "market": "demo-shop.cz", "users": 160, "interactions": 331, "custom_inputs": 17, "orders": 27, "direct_orders": 19,
      "conversion_rate": 0.1625, "currency": "CZK", "revenue": 27838, "avg_order": 1031.04 },
    { "market": "demo-shop.sk", "users": 645, "interactions": 1383, "custom_inputs": 74, "orders": 112, "direct_orders": 81,
      "conversion_rate": 0.1721, "currency": "EUR", "revenue": 5314.2, "avg_order": 47.45 }
  ],
  "top_questions": [
    { "question": "Ako sa používa?", "clicks": 412 },
    { "question": "Je vhodný pre deti?", "clicks": 198 }
  ]
}

curl "https://smartbox.ragnetiq.com/api/stats/v1/products?market=demo-shop.sk" \
  -H "Authorization: Bearer sb_YOUR_KEY"

{
  "shops": null,
  "markets": ["demo-shop.sk"],
  "from": "2026-09-16",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "products": [
    { "product_id": "1042", "market": "demo-shop.sk", "name": "Bylinný čaj 100 g", "interactions": 96, "chip_clicks": 90,
      "custom_inputs": 6, "users": 51, "ordered_users": 11, "conversion_rate": 0.2157 }
  ]
}

curl "https://smartbox.ragnetiq.com/api/stats/v1/events?from=2026-10-01&to=2026-10-15&kind=custom&limit=500" \
  -H "Authorization: Bearer sb_YOUR_KEY"

{
  "shops": null,
  "markets": null,
  "from": "2026-10-01",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "kind": null,
  "items": [
    {
      "id": 48213,
      "shop": "demo-shop",
      "market": "demo-shop.sk",
      "occurred_at": "2026-10-14T08:21:36.412Z",
      "kind": "chip",
      "visitor_id": "6f1c2d5e-…",
      "session_id": "9a7b3e10-…",
      "product_id": "1042",
      "product_code": "CAJ-100",
      "product_name": "Bylinný čaj 100 g",
      "product_url": "https://demo-shop.sk/bylinny-caj-100-g",
      "question": "Ako sa pripravuje?",
      "answer": null,
      "language": "sk",
      "integration": "standalone_script"
    },
    {
      "id": 48214,
      "shop": "demo-shop",
      "market": "demo-shop.sk",
      "occurred_at": "2026-10-14T08:21:39.907Z",
      "kind": "answer",
      "visitor_id": "6f1c2d5e-…",
      "session_id": "9a7b3e10-…",
      "product_id": "1042",
      "product_code": "CAJ-100",
      "product_name": "Bylinný čaj 100 g",
      "product_url": "https://demo-shop.sk/bylinny-caj-100-g",
      "question": "Ako sa pripravuje?",
      "answer": "Jednu lyžičku zalejte 250 ml vody s teplotou 95 °C a nechajte lúhovať 5 až 7 minút.",
      "language": "sk",
      "integration": "standalone_script"
    }
  ],
  "next": null
}

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

{
  "shops": null,
  "markets": null,
  "from": "2026-10-01",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "items": [
    {
      "id": 931,
      "shop": "demo-shop",
      "market": "demo-shop.sk",
      "occurred_at": "2026-10-14T09:02:11.055Z",
      "order_id": "2026001234",
      "attribution": "direct",
      "value": 42.9,
      "currency": "EUR",
      "items": [{ "sku": "1042", "name": "Bylinný čaj 100 g", "quantity": 2 }],
      "matched_count": 1,
      "ordered_items_count": 3,
      "interactions_count": 4,
      "attribution_window_days": 30,
      "visitor_id": "6f1c2d5e-…",
      "session_id": "9a7b3e10-…",
      "integration": "standalone_script"
    }
  ],
  "next": null
}

const BASE = "https://smartbox.ragnetiq.com/api/stats/v1";
const headers = { Authorization: `Bearer ${process.env.SMARTBOX_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.users, summary.totals.orders);

// all questions and answers, page by page
let after = 0;
do {
  const page = await get("/events", { from: "2026-09-01", to: "2026-09-30", after, limit: 1000 });
  for (const e of page.items) store(e); // your logic
  after = page.next;
} while (after);

import os, requests

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

def get(path, **params):
    r = requests.get(BASE + path, headers=HEADERS, params=params, timeout=30)
    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"]["users"])

after = 0
while after is not None:
    page = get("/orders", **{"from": "2026-09-01", "to": "2026-09-30", "after": after})
    for order in page["items"]:
        ...  # your logic
    after = page["next"]