Skip to main content
GET
Returns post analytics from the same summary-posts dataset used in the internal analytics UI, including platform/account context, sortable metrics, and partner-post correlation fields when the analytics post can be matched back to an originating Genviral post.

​
Query Parameters

​
string
default:"30d"
Date preset: 14d, 30d, 90d, 1y, all.
​
string
Custom range start date (YYYY-MM-DD). Must be paired with end.
​
string
Custom range end date (YYYY-MM-DD). Must be paired with start.
​
string
Comma-separated platform filter (for example: tiktok,instagram). You can also use platform.
​
string
Comma-separated analytics target IDs. You can also use account_ids.
​
string
default:"published_at"
Sort field: published_at, views, likes, comments, shares. You can also use sort_by.
​
string
default:"desc"
Sort direction: asc or desc. You can also use sort_order.
​
number
default:"50"
Page size, max 100.
​
number
default:"0"
Offset for pagination. Maximum 10000.

​
Response

​
array
Array of analytics post rows with metrics and account context.
​
number
Total matching rows for the selected filters.
​
boolean
Whether additional rows are available.

​
Notes

  • id is the analytics-row ID for this analytics dataset.
  • analyticsId is the explicit analytics-row ID. id is retained as a legacy alias for backward compatibility.
  • platformPostId is the platform-native post/video ID when available.
  • genviralPostId is the originating Genviral post ID when the analytics row can be correlated back to a created/scheduled post.
  • externalId is the originating Partner API external_id when available.
  • genviralPostId and externalId are null when a row cannot be correlated back to a Partner/Genviral-created post.
  • For BYO TikTok MEDIA_UPLOAD, correlation is best-effort for recent unresolved drafts after the human publishes in TikTok. Older rows can remain uncorrelated until a future async reconciliation/backfill exists.

​
Error Responses

  • 400 - invalid query parameters (range, platforms, sortBy, sortOrder, limit, offset, start/end)
  • 401/403 - authentication failed or key lacks workspace access
  • 500 - unexpected analytics query error
All error responses from analytics endpoints include an error_code field.