---
title: "Compare an explicit current publication period with its immediately preceding equal-length calendar period for the same selected accounts and timezone. Reads both native post reports together and checks population completeness; validated numeric facts withhold incomplete or incompatible totals. Differences compare latest saved snapshots for posts published in each period, not activity measured within those periods or causal performance changes. The baseline dates are derived internally; never calculate or supply them yourself."
method: POST
path: "/api/v1/tools/read_post_period_comparison"
---

# Compare an explicit current publication period with its immediately preceding equal-length calendar period for the same selected accounts and timezone. Reads both native post reports together and checks population completeness; validated numeric facts withhold incomplete or incompatible totals. Differences compare latest saved snapshots for posts published in each period, not activity measured within those periods or causal performance changes. The baseline dates are derived internally; never calculate or supply them yourself.

`POST /api/v1/tools/read_post_period_comparison`

## Request

- Base URL: `https://hivepublish.com`
- URL: `https://hivepublish.com/api/v1/tools/read_post_period_comparison`
- Auth: HTTP bearer

## Request body

- object
  - `channelIds` string[]: Limit both reports to these Hive channel ids.
  - `from` string, required: Inclusive CURRENT publication start date in YYYY-MM-DD, within this chat selection.
  - `to` string, required: Inclusive CURRENT publication end date in YYYY-MM-DD, within this chat selection.
  - `timeZone` string, required: The exact IANA timezone of the current source period. Required; do not guess a timezone.

## Response `200`

Tool result

- ToolResult
  - `data` unknown, required
  - `meta` object, required
    - `tool` string
    - `workspaceId` string, uuid

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid credential
- `403`: Missing workspace scope, role permission, or plan entitlement
- `409`: Idempotency conflict, replay, or request still in progress
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/hivepublish/apis/hive-developer-api.md) · [All operations](https://skmtc.dev/hivepublish/apis/hive-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hivepublish/apis/hive-developer-api/revisions/b440c763583e?raw)