Analytics

Access engagement metrics for posts and accounts. Metrics are fetched from each platform and cached by VoxBurst.

Base URL


https://api.voxburst.io/v1/analytics

Get Post Metrics

GET /v1/analytics/posts/:postId

Retrieve engagement metrics for a specific post.

Required scopes: posts:read


curl https://api.voxburst.io/v1/analytics/posts/post_abc123 \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx"

Response


{
  "postId": "post_abc123",
  "platforms": {
    "TWITTER": {
      "impressions": 1250,
      "likes": 42,
      "reposts": 18,
      "replies": 7,
      "clicks": 93,
      "fetchedAt": "2026-02-20T12:00:00Z"
    },
    "LINKEDIN": {
      "impressions": 890,
      "likes": 31,
      "comments": 5,
      "shares": 12,
      "clicks": 67,
      "fetchedAt": "2026-02-20T12:00:00Z"
    }
  }
}

Get Account Metrics

GET /v1/analytics/accounts/:accountId

Retrieve metrics for a connected account over a time period.

Required scopes: accounts:read

Query Parameters

Parameter	Type	Description
`from`	string	Start date (ISO 8601)
`to`	string	End date (ISO 8601)


curl "https://api.voxburst.io/v1/analytics/accounts/acc_123?from=2026-01-01&to=2026-01-31" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx"

Get Aggregate Metrics

GET /v1/analytics/aggregate

Aggregate metrics across all posts for a time period.

Required scopes: posts:read

Query Parameters

Parameter	Type	Description
`from`	string	Start date (ISO 8601)
`to`	string	End date (ISO 8601)
`platform`	string	Filter by platform
`accountId`	string	Filter by account


curl "https://api.voxburst.io/v1/analytics/aggregate?from=2026-01-01&to=2026-01-31" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx"

Get Analytics Overview

GET /v1/analytics/overview

High-level performance overview across all connected accounts and posts.

Required scopes: posts:read


curl https://api.voxburst.io/v1/analytics/overview \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx"

Refresh Post Metrics

POST /v1/analytics/posts/:postId/refresh

Force a fresh fetch of metrics from the platform. Use sparingly — metrics are automatically refreshed on a schedule.

Required scopes: posts:read


curl -X POST https://api.voxburst.io/v1/analytics/posts/post_abc123/refresh \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx"

Refresh Account Metrics

POST /v1/analytics/accounts/:accountId/refresh

Force a refresh of account-level metrics from the platform.

Required scopes: accounts:read


curl -X POST https://api.voxburst.io/v1/analytics/accounts/acc_123/refresh \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx"