Analytics

Get advanced analytics insights

Surface conversation-driven insights for the project: top recurring questions (faqs) and content gaps where users asked something the assistant could not answer (content_gaps). Each item includes the related chats so you can drill into the original conversations.

Plan-gated: requires a plan that includes advanced analytics. When your team does not have access, the endpoint returns 200 with { "has_access": false } and no payload. Treat that as a successful response rather than an error, and prompt the user to upgrade.

Required permission: analytics_read

get/api/v2/projects/{slug}/analytics/insights/

Request

  • Base URL: https://app.biel.ai
  • URL: https://app.biel.ai/api/v2/projects/{slug}/analytics/insights/
  • Auth: API key in header Authorization

Path parameters

slugstring required

Project slug identifier.

Query parameters

fromstring date

Start date (inclusive, ISO-8601, YYYY-MM-DD). Defaults to 30 days ago.

tostring date

End date (inclusive, ISO-8601, YYYY-MM-DD). Defaults to today.

Response

Insights retrieved successfully (or has_access: false if the team is on a plan without advanced analytics)

has_accessboolean required

true when the team has advanced analytics access; false otherwise.

Changes

No recorded changes to this operation across all 1 revision of this API.