UniPost
Dashboard

List analytics posts

Returns normalized post-level analytics rows across UniPost-published content. Use it for reporting tables, top-post lists, exports, and custom dashboards.
https://api.unipost.dev
GET/v1/analytics/posts?{from}&{to}&{platform}&{profile_id}&{account_id}&{post_id}&{status}&{sort}&{limit}&{cursor}
Authorization
In header · Bearer <token>
Query

Authorization

AuthorizationBearer <token>In header
Workspace API key.

Query Params

fromOptionalstring
Start date as YYYY-MM-DD. Defaults to the last 30 days.
toOptionalstring
End date as YYYY-MM-DD. Inclusive by day.
platformOptionalstring
Destination platform filter.
Valuesinstagram | threads | pinterest | tiktok
profile_idOptionalstring
Limit results to one UniPost profile.
account_idOptionalstring
Limit results to one connected social account.
post_idOptionalstring
Limit results to one UniPost post.
statusOptionalstring
Delivery result status.
Valuespublished | failed | partial
sortOptionalstring
Sort key.
Valuespublished_at | published_at_asc | impressions | likes | engagement_rate
limitOptionalnumber
Page size. Defaults to 50 and caps at 100.
cursorOptionalstring
Cursor from meta.next_cursor.

Response Body

200
data[]array
One row per social platform delivery result.
data[].post_idstring
UniPost post ID.
data[].social_post_result_idstring
Platform delivery result ID.
data[].platformstring
Destination platform.
data[].impressionsnumber
Normalized impressions.
data[].likesnumber
Normalized likes.
data[].savesnumber
Normalized saves / bookmarks.
data[].clicksnumber
Normalized link or outbound clicks.
data[].engagement_ratenumber
Computed engagement rate from normalized metrics.
data[].platform_specificobject
Native fields preserved from the source platform.
meta.next_cursorstring
Cursor for the next page when has_more is true.
401
error.codestring
Usually "UNAUTHORIZED", "PLAN_FEATURE_NOT_AVAILABLE", or "VALIDATION_ERROR".
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
402
error.codestring
Usually "UNAUTHORIZED", "PLAN_FEATURE_NOT_AVAILABLE", or "VALIDATION_ERROR".
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
422
error.codestring
Usually "UNAUTHORIZED", "PLAN_FEATURE_NOT_AVAILABLE", or "VALIDATION_ERROR".
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.