PostZen
Analytics

Get daily analytics metrics

GET
/v1/analytics/daily-metrics

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.

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.

fromDate?|

Inclusive range start. Defaults to 180 days before toDate.

toDate?|

Inclusive range end. Defaults to the current time.

source?string

Filter by PostZen-published or externally imported posts.

attribution?string

Controls whether lifetime metrics are assigned to publish dates or daily deltas to receipt dates.

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/daily-metrics"
{  "dailyData": [    {      "date": "2019-08-24",      "postCount": 0,      "platforms": {        "property1": 0,        "property2": 0      },      "metrics": {        "impressions": 0,        "reach": 0,        "likes": 0,        "comments": 0,        "shares": 0,        "saves": 0,        "clicks": 0,        "views": 0      }    }  ],  "platformBreakdown": [    {      "impressions": 0,      "reach": 0,      "likes": 0,      "comments": 0,      "shares": 0,      "saves": 0,      "clicks": 0,      "views": 0,      "platform": "x",      "postCount": 0    }  ]}
{  "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 a post analytics timeline GET

Returns one daily row per platform for a PostZen post, imported external post, or platform post id.

Get the best times to post GET

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.