> For the complete documentation index, see [llms.txt](https://oodlz-ai-studio.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oodlz-ai-studio.gitbook.io/docs/reporting-agents/growth/social-metrics.md).

# Social Metrics

7 metrics across 5 social platforms every month — null-safe per platform, with deltas computed and engagement rate derived.

> **5 social platforms, 7 metrics each, monthly — with deltas and per-platform availability handled cleanly.**

Each connected social platform runs its own monthly metrics workflow. 5 platforms supported — Instagram, Facebook, LinkedIn, TikTok, X. 7 metrics tracked per platform: followers, impressions, reach, engagements, engagement rate, posts published, link clicks. Not every platform exposes every metric, so the workflow is null-safe by design — fields the platform doesn't expose write null and render as `—` in the dashboard.

## How It Works

Each platform has a dedicated workflow that runs on the same monthly cron — 06:00 UTC on the 2nd of each month. The workflow checks the platform's connection status in the workspace before any API call, exits cleanly with a logged warning if the platform is disconnected, then calls the relevant platform API for the current and prior period.

Followers is fetched as the end-of-period count (point-in-time, not summed). Impressions, reach, engagements, posts published, and link clicks are aggregated across the period. Engagement rate is calculated as engagements ÷ reach (4 decimal places) when both are available; null otherwise. Deltas compute against the prior period for every metric.

## What You Get

* 7 metrics tracked per platform per month — followers, impressions, reach, engagements, engagement rate, posts published, link clicks.
* Per-platform availability handled — fields not exposed by a given platform render as `—` instead of misleading `0`.
* Engagement rate derived consistently — engagements ÷ reach, rounded to 4 decimal places.
* 5 platforms supported — Instagram, Facebook, LinkedIn, TikTok, X.
* Disconnected platforms exit cleanly — clear log entry, no broken-token errors mid-run.
* Same dashboard layout per platform — different numbers, identical reading experience.

## Platform Availability Notes

| Platform  | Fields with limited availability                                                                           |
| --------- | ---------------------------------------------------------------------------------------------------------- |
| Instagram | Link Clicks not exposed via standard Insights API                                                          |
| TikTok    | Link Clicks not exposed in Business Analytics; Reach available only on certain account tiers               |
| X         | Impressions, Reach, and Link Clicks require Elevated API access — Free/Basic tiers see only public metrics |

Where a metric is unavailable, the dashboard renders `—` and the run log notes the limitation. Switching to a higher API tier unlocks the full metric set on the next run.