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
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.
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.