Skip to main content
The analytics commands use only the public /v1 API. Read commands require posts:read. Refresh commands require posts:write.

​
Read one Post

The response contains the latest stored snapshot. It also contains canonical metric values, freshness, and refresh state. The views metric contains provider-reported displays or plays. It does not count unique people.

​
Read one Post group

The response contains every published Post in the group. It also contains totals and coverage for each metric.

​
Refresh analytics

Refresh one Post:
Refresh one Post group:
The command returns after OpenPMM accepts or combines the request. Add --wait to poll for a bounded time. The command can still return a pending state after that wait. Reuse the same idempotency key when you retry an uncertain request.

​
Read the dashboard report

--from is inclusive. --until is exclusive. Use --bucket day or --bucket week. Omit --channel to include all channels. Use --after with next_cursor to read the next Post page. The report groups Posts by publication time in the Workspace time zone. It does not group the audience events by event time.