Post analytics
Returns normalized analytics metrics for one social post. Use it when your UI needs a detailed post-level performance view.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Path Params
post_idstring
Social post ID such as post_abc123.
Response Body
200
post_idstring
Requested social post ID.
metricsobject
Normalized engagement and reach metrics.
metrics.likesnumber
Like count for the post.
metrics.commentsnumber
Comment count (replies on X / Threads).
metrics.sharesnumber
Share count. On X this is retweets + quote tweets combined; the breakdown is in platform_specific.
metrics.savesnumber
Save / bookmark count when the platform exposes it.
metrics.impressionsnumber
Impression count when the platform exposes it.
metrics.reachnumber
Reach value when the platform exposes it.
metrics.video_viewsnumber
Video view count for video posts.
metrics.engagement_ratenumber
Computed engagement rate (0-1) when impressions are available.
metrics.platform_specificobject
Untransformed platform-native fields the normalized shape doesn't capture. On X: retweet_count, quote_count, bookmark_count.
401
error.codestring
Usually "UNAUTHORIZED" or "NOT_FOUND".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "not_found".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
404
error.codestring
Usually "UNAUTHORIZED" or "NOT_FOUND".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "not_found".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Usually "UNAUTHORIZED" or "NOT_FOUND".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "not_found".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.