Analytics

Analytics give you your workspace's evaluation volume by day and result, across every benefit. Use them to watch trends, size alerts in your own monitoring, and confirm that a policy change moved results the way you expected. For a broader monitoring setup, see Monitor your integration.

The daily summary objectCopy Anchor Link

{
  "object": "daily_summary",
  "day": "2026-10-28",
  "result": "deny",
  "count": 37
}

Read analyticsCopy Anchor Link

Returns one summary for each day and result that had evaluations, newest day first. Days without evaluations don't appear. Today's counts are refreshed through the day and can briefly trail live traffic.

Also available as abusezero analytics get in the AbuseZero CLI, abusezero_get_analytics on the AbuseZero MCP server and analytics() in the AbuseZero Node.js SDK.

Query parametersCopy Anchor Link

ExampleCopy Anchor Link

import { AbuseZero } from "abusezero/server";

const abusezero = new AbuseZero({ key: process.env.ABUSEZERO_SECRET_KEY!, outage: "throw" });

const summaries = await abusezero.analytics(7);

ResponseCopy Anchor Link

Returns 200. The whole range comes back in one response, so next_cursor is always null.

{
  "object": "list",
  "data": [
    { "object": "daily_summary", "day": "2026-10-29", "result": "allow", "count": 412 },
    { "object": "daily_summary", "day": "2026-10-29", "result": "deny", "count": 21 },
    { "object": "daily_summary", "day": "2026-10-28", "result": "allow", "count": 958 },
    { "object": "daily_summary", "day": "2026-10-28", "result": "deny", "count": 37 }
  ],
  "next_cursor": null
}

ErrorsCopy Anchor Link

For every other code, see REST API errors.

RelatedCopy Anchor Link