Search statistics API

Authorization: Bearer ss_9f2c1a7e…

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

{ "error": "forbidden", "message": "Kľúč nemá prístup k niektorému z požadovaných obchodov." }

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

{
  "shops": [
    { "id": "demo-shop", "name": "Demo Shop", "domains": ["www.demo-shop.example", "demo-shop.example"] }
  ]
}

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

{
  "shops": ["demo-shop"],
  "from": "2026-10-01",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "totals": {
    "searches": 10638,
    "searchers": 6489,
    "zero": 457,
    "not_confident": 638,
    "serp": 5851,
    "with_click": 4681,
    "clicks": 7215,
    "carts": 655,
    "latency_p50": 412,
    "orders": 465,
    "orders_search": 186,
    "revenue_search": 34782.4,
    "currency": "EUR",
    "revenue_by_currency": [{ "currency": "EUR", "value": 34782.4 }]
  },
  "previous": { "searches": 9574, "…": "…" },
  "daily": [
    { "day": "2026-10-01", "searches": 712, "clicks": 486, "carts": 41 },
    { "day": "2026-10-02", "searches": 698, "clicks": 471, "carts": 44 }
  ],
  "flow": {
    "zero":     { "total": 457,  "ordered": 4 },
    "no_click": { "total": 5500, "ordered": 15 },
    "click":    { "total": 4026, "ordered": 65 },
    "cart":     { "total": 655,  "ordered": 102 }
  },
  "devices": { "desktop": 4468, "mobile": 6170 },
  "recommendations": {
    "current": {
      "views": 18420, "clicks": 1104, "carts": 196, "orders": 61, "revenue": 11240, "currency": "EUR",
      "blocks": [
        { "block": "picks", "views": 9120, "clicks": 471, "carts": 72, "orders": 24, "revenue": 4310 },
        { "block": "similar", "views": 5410, "clicks": 402, "carts": 68, "orders": 21, "revenue": 3980 }
      ]
    },
    "previous": { "views": 16900, "clicks": 980, "carts": 171, "orders": 52, "revenue": 9870, "currency": "EUR", "blocks": [] }
  }
}

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

{
  "shops": null,
  "from": "2026-10-01",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "top": [
    { "query": "vrtacka", "searches": 1912, "zero": 0, "with_click": 1190, "carts": 64 }
  ],
  "zero_results": [
    { "query": "vrtackaa", "searches": 64 }
  ],
  "no_click": [
    { "query": "nahradny diel 1234", "searches": 38 }
  ]
}

curl "https://search.ragnetiq.com/api/stats/v1/products?shop=demo-shop" \
  -H "Authorization: Bearer ss_YOUR_KEY"

{
  "shops": ["demo-shop"],
  "from": "2026-09-16",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "products": [
    { "id": "demo-shop:a1b2c3d4-…", "shop": "demo-shop", "product_id": "a1b2c3d4-…", "name": "Aku vŕtačka 18 V", "clicks": 412, "carts": 61 }
  ]
}

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

{
  "shops": null,
  "from": "2026-10-01",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "type": null,
  "items": [
    {
      "id": 48213,
      "shop": "demo-shop",
      "occurred_at": "2026-10-14T08:21:36.412Z",
      "type": "search",
      "surface": "autocomplete",
      "visitor_id": "6f1c2d5e-…",
      "session_id": "9a7b3e10-…",
      "search_id": "c2a4f8d1-…",
      "query": "aku vŕtačka",
      "query_norm": "aku vrtacka",
      "result_count": 42,
      "confident": true,
      "corrected": null,
      "filters": null,
      "product_id": null,
      "product_name": null,
      "position": null,
      "server_ms": 184,
      "client_ms": 412,
      "device": "desktop",
      "extra": null
    },
    {
      "id": 48214,
      "shop": "demo-shop",
      "occurred_at": "2026-10-14T08:21:41.907Z",
      "type": "click",
      "surface": "autocomplete",
      "visitor_id": "6f1c2d5e-…",
      "session_id": "9a7b3e10-…",
      "search_id": "c2a4f8d1-…",
      "query": "aku vŕtačka",
      "query_norm": "aku vrtacka",
      "result_count": null,
      "confident": null,
      "corrected": null,
      "filters": null,
      "product_id": "a1b2c3d4-…",
      "product_name": "Aku vŕtačka 18 V",
      "position": 1,
      "server_ms": null,
      "client_ms": null,
      "device": "desktop",
      "extra": null
    }
  ],
  "next": null
}

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

{
  "shops": null,
  "from": "2026-10-01",
  "to": "2026-10-15",
  "timezone": "Europe/Bratislava",
  "items": [
    {
      "id": 931,
      "shop": "demo-shop",
      "occurred_at": "2026-10-14T09:02:11.055Z",
      "order_hash": "7d2dd5fa939d8b5a…",
      "visitor_id": "6f1c2d5e-…",
      "session_id": "9a7b3e10-…",
      "value": 606.32,
      "currency": "EUR",
      "items": [{ "id": "a1b2c3d4-…", "quantity": 1, "price": 606.32 }],
      "extra": null,
      "after_search": true
    }
  ],
  "next": null
}

const BASE = "https://search.ragnetiq.com/api/stats/v1";
const headers = { Authorization: `Bearer ${process.env.SMARTSEARCH_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();
}

// September summary
const summary = await get("/summary", { from: "2026-09-01", to: "2026-09-30" });
console.log(summary.totals.searches, summary.totals.orders_search);

// all events, 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://search.ragnetiq.com/api/stats/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SMARTSEARCH_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"})
print(summary["totals"]["searches"])

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