---
title: "Get Tool Insights"
method: GET
path: "/api/tools/{tool_id}/insights"
tags: ["tools"]
---

# Get Tool Insights

`GET /api/tools/{tool_id}/insights`

## Request

- Base URL: `https://bizclaw.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://bizclaw.xyz/api/tools/{tool_id}/insights`
- Auth: OAuth 2 (password, token URL `/api/auth/login`)

Get aggregated Audience Insights (Unanswered Queries) for a specific tool.
Only the owner or an admin can access this.
Uses SQL GROUP BY instead of loading all rows into Python.

## Path parameters

- `tool_id` string, required

## Query parameters

- `limit` integer: Max insight categories

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bizclaw/apis/bizclaw-api.md) · [All operations](https://skmtc.dev/bizclaw/apis/bizclaw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bizclaw/apis/bizclaw-api/revisions/565357676bfe?raw)