curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/analytics/summary/posts?range=90d&sortBy=views&sortOrder=desc&limit=25&offset=0' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Analytics posts retrieved",
"data": {
"posts": [
{
"id": "88c2011d-c620-4b61-8486-78e8f182e8ec",
"analyticsId": "88c2011d-c620-4b61-8486-78e8f182e8ec",
"platformPostId": "7391929919011",
"genviralPostId": "d0e1d35c-d34c-4503-afe8-3c56e4aa1911",
"externalId": "automation-1e93c16b-4866-43ed-82e9-ea55bae5e1ab",
"publishedAt": "2026-02-12T17:42:02.000Z",
"caption": "How to prep your first week of content",
"permalink": "https://www.tiktok.com/@brand/video/7391929919011",
"thumbnailUrl": "https://cdn.example.com/thumb.jpg",
"durationSeconds": 27,
"metrics": {
"views": 14120,
"likes": 812,
"comments": 67,
"shares": 29,
"saves": 14
},
"engagementRate": 6.42,
"platform": "tiktok",
"accountIdentifier": "@brand",
"accountDisplayName": "Brand HQ",
"accountAvatarUrl": null
}
],
"totalCount": 192,
"hasMore": true
}
}
Analytics
List Analytics Posts
Fetch paginated post-level analytics across tracked accounts
GET
/
api
/
partner
/
v1
/
analytics
/
summary
/
posts
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/analytics/summary/posts?range=90d&sortBy=views&sortOrder=desc&limit=25&offset=0' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Analytics posts retrieved",
"data": {
"posts": [
{
"id": "88c2011d-c620-4b61-8486-78e8f182e8ec",
"analyticsId": "88c2011d-c620-4b61-8486-78e8f182e8ec",
"platformPostId": "7391929919011",
"genviralPostId": "d0e1d35c-d34c-4503-afe8-3c56e4aa1911",
"externalId": "automation-1e93c16b-4866-43ed-82e9-ea55bae5e1ab",
"publishedAt": "2026-02-12T17:42:02.000Z",
"caption": "How to prep your first week of content",
"permalink": "https://www.tiktok.com/@brand/video/7391929919011",
"thumbnailUrl": "https://cdn.example.com/thumb.jpg",
"durationSeconds": 27,
"metrics": {
"views": 14120,
"likes": 812,
"comments": 67,
"shares": 29,
"saves": 14
},
"engagementRate": 6.42,
"platform": "tiktok",
"accountIdentifier": "@brand",
"accountDisplayName": "Brand HQ",
"accountAvatarUrl": null
}
],
"totalCount": 192,
"hasMore": true
}
}
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
Date preset:
14d, 30d, 90d, 1y, all. Pass either range or start
and end, not both.Sort field:
published_at, views, likes, comments, shares. You can
also use sort_by.Response
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/analytics/summary/posts?range=90d&sortBy=views&sortOrder=desc&limit=25&offset=0' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Analytics posts retrieved",
"data": {
"posts": [
{
"id": "88c2011d-c620-4b61-8486-78e8f182e8ec",
"analyticsId": "88c2011d-c620-4b61-8486-78e8f182e8ec",
"platformPostId": "7391929919011",
"genviralPostId": "d0e1d35c-d34c-4503-afe8-3c56e4aa1911",
"externalId": "automation-1e93c16b-4866-43ed-82e9-ea55bae5e1ab",
"publishedAt": "2026-02-12T17:42:02.000Z",
"caption": "How to prep your first week of content",
"permalink": "https://www.tiktok.com/@brand/video/7391929919011",
"thumbnailUrl": "https://cdn.example.com/thumb.jpg",
"durationSeconds": 27,
"metrics": {
"views": 14120,
"likes": 812,
"comments": 67,
"shares": 29,
"saves": 14
},
"engagementRate": 6.42,
"platform": "tiktok",
"accountIdentifier": "@brand",
"accountDisplayName": "Brand HQ",
"accountAvatarUrl": null
}
],
"totalCount": 192,
"hasMore": true
}
}
Notes
idis the analytics-row ID for this analytics dataset.analyticsIdis the explicit analytics-row ID.idis retained as a legacy alias for backward compatibility.platformPostIdis the platform-native post/video ID when available.genviralPostIdis the originating Genviral post ID when the analytics row can be correlated back to a created/scheduled post.externalIdis the originating Partner APIexternal_idwhen available.genviralPostIdandexternalIdarenullwhen 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 access500- unexpected analytics query error
error_code field.