---
title: "Content"
method: GET
path: "/projects/{project_id}/agent/analytics/content"
tags: ["Agent"]
---

# Content

`GET /projects/{project_id}/agent/analytics/content`

## Request

- Base URL: `https://api.beyondwords.io/v1`
- URL: `https://api.beyondwords.io/v1/projects/{project_id}/agent/analytics/content`
- Auth: API key in header `X-Api-Key`

Retrieves per-content usage aggregates for the AI assistant

## Query parameters

- `agent_type` 'conversational_agent' | 'ai_assistant', required
- `time_range[start]` string
- `time_range[end]` string
- `pagination[limit]` integer
- `pagination[offset]` integer
- `order[by]` 'title' | 'published_at' | 'total_uses' | 'fetches' | 'read_requests' | 'audio_requests' | 'last_used_at'
- `order[dir]` 'asc' | 'desc'
- `access_tiers[]` string[]
- `filter[query]` string

## Response `200`

OK

- object[]
  - `id` string, uuid: Content identifier (Podcast uuid)
  - `title` string, nullable: Content title
  - `source_url` string, nullable: Canonical source URL for this content item
  - `published_at` string, date-time, nullable: Content publication timestamp (ISO 8601, UTC)
  - `fetches` integer: Number of get_article calls
  - `read_requests` integer: Number of read_article calls (repeated pagination calls each count separately)
  - `audio_requests` integer: Number of get_audio calls
  - `segments_returned` integer: Sum of segments_returned across calls
  - `total_uses` integer: Total number of tool calls referencing this content
  - `last_used_at` string, date-time, nullable: Time of the most recent tool call referencing this content (ISO 8601, UTC)

## Other responses

- `404`: Agent beta not enabled for this organization
- `422`: missing time_range

## Changes

- **2026-11-03** `994b9853e685`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/changes/projects/:project_id/agent/analytics/content/get.md)

---

[API](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api.md) - [All operations](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/revisions/994b9853e685?raw)