Get analytics

Read engagement counts for published posts.

Last checked against the API October 10, 2026 · View as Markdown

GEThttps://studio.postprism.app/api/v1/analytics

Returns analytics records for posts in the workspace, most recent first. Each record holds views, likes, comments and shares for one post on one platform.

Parameters

NameInTypeDescription
post_idqueryuuidOnly records for this post.
platformquerystringOnly records for this platform key.
limitqueryintegerHow many records to return. Default 50, maximum 100.
workspace_idqueryuuidAct on another workspace you belong to. Defaults to the workspace your API key was created in.

Example

Analytics for one post
curl "https://studio.postprism.app/api/v1/analytics?post_id=3f1c2a9e-0000-4000-8000-00000000a001" \
  -H "Authorization: Bearer pp_live_your_api_key"

Response

200. data is an array of AnalyticsRecord. Engagement counts for one post on one platform.

iduuid

The record ID.

post_iduuid

The post it belongs to.

platformstring

The platform key the counts are for.

viewsinteger

Views or impressions.

likesinteger

Likes or reactions.

commentsinteger

Comments.

sharesinteger

Shares or reposts.

recorded_atdate-time

When these counts were recorded.

200 response
{
  "data": [
    {
      "id": "5c6d7e8f-0000-4000-8000-00000000e001",
      "post_id": "3f1c2a9e-0000-4000-8000-00000000a001",
      "platform": "linkedin",
      "views": 2410,
      "likes": 86,
      "comments": 12,
      "shares": 7,
      "recorded_at": "2026-10-17T09:00:00Z"
    }
  ],
  "error": null
}

Errors

StatusMessageWhen
401Invalid or revoked API keyThe Authorization header is missing, malformed, or the key was revoked.
404Workspace not found, or you are not a member of it.The workspace_id you passed (or your key’s default workspace) is not one you belong to.
429Too many requestsYou went over the hourly limit. See Rate limits.
PreviousUpload mediaNextList connected platforms