> ## Documentation Index
> Fetch the complete documentation index at: https://docs.genviral.io/llms.txt
> Use this file to discover all available pages before exploring further.

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

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](/api-reference/refresh-analytics-target)).

## Query Parameters

<ParamField query="range" type="string" default="30d">
  Date preset. Supported values: `14d`, `30d`, `90d`, `1y`, `all`.
</ParamField>

<ParamField query="start" type="string">
  Custom range start date (`YYYY-MM-DD`). Must be used with `end`.
</ParamField>

<ParamField query="end" type="string">
  Custom range end date (`YYYY-MM-DD`). Must be used with `start`.
</ParamField>

<ParamField query="platforms" type="string">
  Comma-separated platform filter (for example: `tiktok,instagram`). You can
  also use `platform`.
</ParamField>

<ParamField query="accounts" type="string">
  Comma-separated analytics target IDs. You can also use `account_ids`.
</ParamField>

## Response

<ResponseField name="range" type="object">
  Selected date range with `start` and `end`.
</ResponseField>

<ResponseField name="filters" type="object">
  Applied platform/account filters.
</ResponseField>

<ResponseField name="kpis" type="object">
  KPI values and deltas for published videos, active accounts, views, likes,
  comments, shares, saves, and engagement rate.
</ResponseField>

<ResponseField name="interactionSeries" type="array">
  Per-day interaction totals (`views`, `likes`, `comments`, `shares`).
</ResponseField>

<ResponseField name="engagementSeries" type="array">
  Per-day engagement rate values.
</ResponseField>

<ResponseField name="postingHeatmap" type="array">
  Per-day posting counts used for the calendar heatmap.
</ResponseField>

<ResponseField name="postingStreak" type="number">
  Current consecutive posting-day streak ending at the selected range end date.
</ResponseField>

<ResponseField name="contentMix" type="array">
  Posts split by platform with percentage share.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://www.genviral.io/api/partner/v1/analytics/summary?range=30d&platforms=tiktok,instagram' \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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": []
    }
  }
  ```
</ResponseExample>

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