PostZen
Analytics

Get the best times to post

GET
/v1/analytics/best-time

Returns historical engagement slots grouped by UTC day of week and hour, ordered by average engagement descending. Hours are UTC; day_of_week uses 0 = Sunday through 6 = Saturday.

Authorization

bearerAuth
AuthorizationBearer <token>

PostZen API key.

In: header

Query Parameters

platform?string

Filter by platform.

profileId?string

Filter by PostZen profile id.

accountId?string

Filter by connected social account id.

source?string

Filter by PostZen-published or externally imported posts.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/analytics/best-time"
{  "slots": [    {      "day_of_week": 0,      "hour": 0,      "avg_engagement": 0,      "post_count": 0,      "day_name": "Sunday"    }  ],  "timezone": "UTC"}
{  "error": "JSON body is required"}
{  "error": "Unauthorized"}
{  "error": "string",  "type": "string",  "code": "string",  "param": "string"}
{  "error": "API key requires read_write permission"}
{  "error": "Not found"}
{  "error": "rate_limited",  "retryAfter": 30}
{  "error": "Failed to create post"}

Get daily analytics metrics GET

Returns daily aggregate metrics and a per-platform breakdown. Publish attribution assigns lifetime metrics to the post's publish date; received attribution assigns metric deltas to the day they were observed.

Get follower statistics GET

Returns follower history and growth for connected accounts at daily, weekly, or monthly granularity.