Reports

Two routes make up the agent surface: a free list and a per-handle reports endpoint. They return report data only — never profile, posts, or edges. The base URL is in Environments.

`GET /api/intel/list`

Lists handles that have shared data on the deployment. No parameters, no payment. GET only.

Field	Type
`username`	string
`displayName`	string
`avatarUrl`	string
`followers`	number
`postCount`	number
`reportCount`	number
`gatheredAt`	ISO string
`affiliationLabel`	string \| null

Entries are sorted newest-first by gatheredAt. When the deployment has no KV store, the response is { "configured": false, "entries": [] }.

`GET /api/intel/reports`

GET only. Behavior depends on select.

Param	Required	Notes
`username`	Yes	Handle, with or without a leading `@`
`select`	No	Omit for the free menu; `all` or `range` for paid bodies
`from` / `to`	For `range`	ISO strings compared lexicographically against each report’s `createdAt` (its creation time, not its content date range)
`ids`	For `range`	Comma-separated report ids

Returns { username, reportCount, reports: ReportMenuItem[] }. Each item:

Field	Type
`id`	string
`createdAt`	ISO string
`model`	string
`postCount`	number
`dateRange`	`{ from, to }` \| null

Paid — `select=all`

Returns every report in the handle’s history, after payment.

Paid — `select=range`

Returns a subset. Provide at least one of ids, from, or to; the constraints combine with AND. Missing all three → 400 range_requires_from_to_or_ids. Matching nothing → 404 no_matching_reports.

Paid response

{
  "username": "AskVenice",
  "select": "all",
  "reportCount": 2,
  "chargedUsd": 0.02,
  "reports": [ /* IntelReportSnapshot[] */ ]
}

chargedUsd is the required amount (unit price × N), not the settled amount — overpayment is not reflected here. See Pricing.

The `IntelReportSnapshot`

Each report contains:

Field	Contents
`id`, `createdAt`, `model`	Identity and source model
`synthesisSettings`	`contextCap`, `temperature`, `model`, `includedReportIds`
`meta`	`postCount`, `dateRange`, `postIdsAnalyzed`, `tokenCost`, optional token counts, `includedReportIds`
`analytics`	Computed metrics: `fundamentals`, `composition`, `engagement`, `cadence`, `topics`, `infoDiet`, `network`, `scope`, `styleFeatures`
`narrative`	AI sections: `executiveSummary`, `strategicAssessment`, `themes`, `register`, `narrativeArcs`, `audienceRead`, `contradictions`, `notablePosts`, `engagementHooks`, `analystConclusions`
`changeSummary`	Delta vs the previous report; `null` on the baseline report
`previousReportId`	Id of the prior report, or `null`

The nested shapes track the app and may gain fields over time. Treat unknown fields as forward-compatible.

Not part of this API

GET/PUT /api/intel/bundle returns the full corpus (profile, posts, edges, report history). It is restricted to first-party access and has no payment path — it is not sold to agents.

Overview

Using the app

Agent API

Access models

Reference

`GET /api/intel/list`

`GET /api/intel/reports`

Free menu (no `select`)

Paid — `select=all`

Paid — `select=range`

Paid response

The `IntelReportSnapshot`

Not part of this API

​GET /api/intel/list

​GET /api/intel/reports

​Free menu (no select)

​Paid — select=all

​Paid — select=range

​Paid response

​The IntelReportSnapshot

​Not part of this API

​Related

`GET /api/intel/list`

`GET /api/intel/reports`

Free menu (no `select`)

Paid — `select=all`

Paid — `select=range`

Paid response

The `IntelReportSnapshot`

Not part of this API

Related