Skip to main content
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 - invalid range, invalid date parameters (start/end), invalid date ordering, or invalid platforms filter values
  • 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.