curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/analytics/summary?range=30d&platforms=tiktok,instagram' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Analytics summary retrieved",
"data": {
"range": {
"start": "2026-01-15",
"end": "2026-02-14"
},
"filters": {
"platforms": ["tiktok", "instagram"],
"accountIds": []
},
"kpis": {
"publishedVideos": { "value": 41, "delta": 8 },
"activeAccounts": { "value": 5, "delta": 1 },
"views": { "value": 815422, "delta": 102881 },
"likes": { "value": 51220, "delta": 6412 },
"comments": { "value": 2941, "delta": 318 },
"shares": { "value": 1822, "delta": 205 },
"saves": { "value": 1104, "delta": 121 },
"engagementRate": { "value": 6.86, "delta": 0.42 }
},
"interactionSeries": [],
"engagementSeries": [],
"postingHeatmap": [],
"postingStreak": 3,
"contentMix": []
}
}
Analytics
Get Analytics Summary
Fetch social media analytics for TikTok, Instagram, and YouTube - including views, likes, comments, shares, engagement rates, and posting streaks. Feed performance data back to your OpenClaw agent for strategy optimization.
GET
/
api
/
partner
/
v1
/
analytics
/
summary
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/analytics/summary?range=30d&platforms=tiktok,instagram' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Analytics summary retrieved",
"data": {
"range": {
"start": "2026-01-15",
"end": "2026-02-14"
},
"filters": {
"platforms": ["tiktok", "instagram"],
"accountIds": []
},
"kpis": {
"publishedVideos": { "value": 41, "delta": 8 },
"activeAccounts": { "value": 5, "delta": 1 },
"views": { "value": 815422, "delta": 102881 },
"likes": { "value": 51220, "delta": 6412 },
"comments": { "value": 2941, "delta": 318 },
"shares": { "value": 1822, "delta": 205 },
"saves": { "value": 1104, "delta": 121 },
"engagementRate": { "value": 6.86, "delta": 0.42 }
},
"interactionSeries": [],
"engagementSeries": [],
"postingHeatmap": [],
"postingStreak": 3,
"contentMix": []
}
}
Returns the same summary dataset used by the internal analytics dashboard:
KPI deltas, interaction timeline, engagement series, posting heatmap, posting
streak, and content mix. Use this endpoint to feed real performance data back to your OpenClaw agent or AI automation - enabling data-driven content strategy that adapts based on what actually performs across TikTok, Instagram, and YouTube.
Billing
- This endpoint is read-only and does not consume credits.
- Credits are only consumed by analytics seat billing and paid refreshes (see Refresh Analytics Target).
Query Parameters
string
default:"30d"
Date preset. Supported values:
14d, 30d, 90d, 1y, all.string
Custom range start date (
YYYY-MM-DD). Must be used with end.string
Custom range end date (
YYYY-MM-DD). Must be used 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.Response
object
Selected date range with
start and end.object
Applied platform/account filters.
object
KPI values and deltas for published videos, active accounts, views, likes,
comments, shares, saves, and engagement rate.
array
Per-day interaction totals (
views, likes, comments, shares).array
Per-day engagement rate values.
array
Per-day posting counts used for the calendar heatmap.
number
Current consecutive posting-day streak ending at the selected range end date.
array
Posts split by platform with percentage share.
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/analytics/summary?range=30d&platforms=tiktok,instagram' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Analytics summary retrieved",
"data": {
"range": {
"start": "2026-01-15",
"end": "2026-02-14"
},
"filters": {
"platforms": ["tiktok", "instagram"],
"accountIds": []
},
"kpis": {
"publishedVideos": { "value": 41, "delta": 8 },
"activeAccounts": { "value": 5, "delta": 1 },
"views": { "value": 815422, "delta": 102881 },
"likes": { "value": 51220, "delta": 6412 },
"comments": { "value": 2941, "delta": 318 },
"shares": { "value": 1822, "delta": 205 },
"saves": { "value": 1104, "delta": 121 },
"engagementRate": { "value": 6.86, "delta": 0.42 }
},
"interactionSeries": [],
"engagementSeries": [],
"postingHeatmap": [],
"postingStreak": 3,
"contentMix": []
}
}
Error Responses
400- invalidrange, invalid date parameters (start/end), invalid date ordering, or invalidplatformsfilter values401/403- authentication failed or key lacks workspace access500- unexpected analytics query error
error_code field.