ENUM

PostMetricType

List of possible metrics available for a Post.

Values fall into three groups:

Cross-network normalized (reactions, comments, shares, reposts, reach, impressions, views, clicks, engagementRate): Used wherever a concept maps cleanly across networks. Per-network adapters normalize their native names (e.g., Instagram likes → reactions, Twitter retweets → reposts).
Network-specific (saves, follows, quotes, viewers, totalTimeWatched, likes): Real metrics that don't have a cross-network equivalent. likes is intentionally distinct from reactions on Facebook — Facebook's Graph API surfaces them separately.
Aggregation-only (postCount): Meaningful only on aggregate endpoints; never emitted per-post.

Deprecated values are pre-normalization legacy or tied to features being removed. They're kept in the enum for backwards compatibility until clients migrate.

Values 23

reactions How many people reacted to your post. Unified across networks: Instagram/Twitter `likes`, Mastodon `favorites`, etc. all map to this value.

comments The count of comments and replies on your post. Unified across networks (Threads `replies` maps here).

shares How many times your post was shared or forwarded by others.

reposts How many times your post was reposted by others. Twitter `retweets`, Mastodon `reblogs`, Threads `reposts` all normalize to this value.

reach The number of unique people who saw your post.

impressions How many times your post was shown on screen. May include multiple views by the same person — useful for spotting how often the content gets surfaced.

views How many times your post was viewed. Used for video-style posts and on networks that report views distinctly from impressions.

clicks How many times people clicked on your post.

engagementRate The percentage of people who interacted with your post compared to how many saw it. Unit: percentage.

saves How many times people saved your post (Instagram, Pinterest). A strong signal that the content is worth revisiting.

follows The number of new followers gained from this post (Instagram).

quotes How many times your post was quoted (Threads).

viewers Unique viewer count for video-style posts (LinkedIn).

totalTimeWatched Total time watched, in minutes, for video-style posts (LinkedIn).

likes The Like-reaction subcount on Facebook. Distinct from `reactions` (which is the total of all reaction types — Like, Love, Care, Haha, Wow, Sad, Angry); Facebook's Graph API reports them separately and we mirror that.

postCount The count of posts included in an aggregated response. Only meaningful on aggregate endpoints — never emitted per-post.

replies Deprecated: not emitted by any per-network definition. Use `comments` instead — replies are normalized into `comments` on the networks that distinguish them (Threads). Will be removed on 2026-07-31. Deprecated: Not emitted by any per-network definition; use `comments` instead. Will be removed on 2026-07-31.

favorites Deprecated: not emitted by any per-network definition. Use `reactions` instead — Twitter and Mastodon favorites normalize into `reactions`. Will be removed on 2026-07-31. Deprecated: Not emitted by any per-network definition; use `reactions` instead. Will be removed on 2026-07-31.

reblogs Deprecated: not emitted by any per-network definition. Use `reposts` instead — Mastodon reblogs normalize into `reposts`. Will be removed on 2026-07-31. Deprecated: Not emitted by any per-network definition; use `reposts` instead. Will be removed on 2026-07-31.

retweets Deprecated: not emitted by any per-network definition. Use `reposts` instead — Twitter retweets normalize into `reposts`. Will be removed on 2026-07-31. Deprecated: Not emitted by any per-network definition; use `reposts` instead. Will be removed on 2026-07-31.

repins Deprecated: not emitted by any per-network definition. Pre-normalization legacy from the Pinterest era. Will be removed on 2026-07-31. Deprecated: Not emitted by any per-network definition. Will be removed on 2026-07-31.

link_clicks Deprecated: StartPage link-clicks metric. StartPage is being deprecated as a product. Will be removed on 2026-07-31. Deprecated: StartPage is being deprecated as a product. Will be removed on 2026-07-31.

other Deprecated catch-all from pre-normalization. Never emitted. Will be removed on 2026-07-31. Deprecated: Catch-all from pre-normalization; never emitted. Will be removed on 2026-07-31.