Metrics

Metrics compute a value for each bucket.

This page lists every accepted type. See Using metrics for how name shows up in the response.

Object types#

type is required on every object. name is optional. It defaults to type.

Field	Required	Description
`type`	yes	Which metric to compute. See the catalog.
`name`	no	Key in the response `values`. Defaults to `type`.

Names below match the Computation column in the catalog.

Computation	Bucket value
Count	Number of mentions or fragments in the bucket
Distinct count	Number of distinct values
Sum	Sum of one field on the mentions in the bucket
Average	Average of one field
Minimum	Lowest value of one field
Maximum	Highest value of one field
Latest	Value on the most recent mention in the bucket
Score	Formula in Sentiment and scoring

Catalog#

Unknown type values are rejected (HTTP 400). Open Example on a row for a metrics snippet.

Counts

Metric	Computation	Description	Example
`volume`	Count	Mentions in the bucket	`{"type": "volume"}`
`volume_fragment`	Count	Fragments in the bucket. Fragment filters on the request restrict which fragments are counted.	`{"type": "volume_fragment"}`
`unique_author_count`	Distinct count	Distinct authors	`{"type": "unique_author_count"}`
`source`	Distinct count	Distinct sources	`{"type": "source"}`

Interactions

Metric	Computation	Description	Example
`interactions_total`	Sum	Total interactions	`{"type": "interactions_total"}`
`interactions_avg`	Average	Total interactions per mention	`{"type": "interactions_avg"}`
`interactions_total_active`	Sum	Active interactions	`{"type": "interactions_total_active"}`
`interactions_total_passive`	Sum	Passive interactions	`{"type": "interactions_total_passive"}`
`interactions_total_owned`	Sum	Owned interaction totals	`{"type": "interactions_total_owned"}`
`interactions_avg_owned`	Average	Owned interaction total per mention	`{"type": "interactions_avg_owned"}`
`interactions_total_active_owned`	Sum	Owned active interactions	`{"type": "interactions_total_active_owned"}`
`interactions_total_passive_owned`	Sum	Owned passive interactions	`{"type": "interactions_total_passive_owned"}`
`media_value`	Sum	Earned media value	`{"type": "media_value"}`

Engagement and audience

Metric	Computation	Description	Example
`engagement_rate_total`	Sum	Engagement rate stored on each mention	`{"type": "engagement_rate_total"}`
`engagement_rate_avg`	Average	Engagement rate per mention	`{"type": "engagement_rate_avg"}`
`engagement_rate_min`	Minimum	Lowest engagement rate in the bucket	`{"type": "engagement_rate_min"}`
`engagement_rate_max`	Maximum	Highest engagement rate in the bucket	`{"type": "engagement_rate_max"}`
`engagement_rate_owned_total`	Sum	Owned engagement rate stored on each mention	`{"type": "engagement_rate_owned_total"}`
`engagement_rate_owned_avg`	Average	Owned engagement rate per mention	`{"type": "engagement_rate_owned_avg"}`
`engagement_rate_owned_min`	Minimum	Lowest owned engagement rate in the bucket	`{"type": "engagement_rate_owned_min"}`
`engagement_rate_owned_max`	Maximum	Highest owned engagement rate in the bucket	`{"type": "engagement_rate_owned_max"}`
`influence_total`	Sum	Influence scores	`{"type": "influence_total"}`
`influence_avg`	Average	Influence score	`{"type": "influence_avg"}`
`followers_count`	Latest	Follower count on the most recent mention, or 0 when missing	`{"type": "followers_count"}`

Bluesky

Metric	Computation	Description	Example
`bluesky_likes`	Sum	Bluesky likes	`{"type": "bluesky_likes"}`
`bluesky_replies`	Sum	Bluesky replies	`{"type": "bluesky_replies"}`
`bluesky_reposts`	Sum	Bluesky reposts	`{"type": "bluesky_reposts"}`

Douyin

Metric	Computation	Description	Example
`douyin_likes`	Sum	Douyin likes	`{"type": "douyin_likes"}`
`douyin_favorites`	Sum	Douyin favorites	`{"type": "douyin_favorites"}`
`douyin_reposts`	Sum	Douyin reposts	`{"type": "douyin_reposts"}`
`douyin_reviews`	Sum	Douyin reviews	`{"type": "douyin_reviews"}`
`douyin_views`	Sum	Douyin views	`{"type": "douyin_views"}`

Facebook

Metric	Computation	Description	Example
`facebook_likes`	Sum	Facebook likes	`{"type": "facebook_likes"}`
`facebook_comments`	Sum	Facebook comments	`{"type": "facebook_comments"}`
`facebook_shares`	Sum	Facebook shares	`{"type": "facebook_shares"}`
`facebook_clicks`	Sum	Facebook clicks	`{"type": "facebook_clicks"}`
`facebook_views`	Sum	Facebook views	`{"type": "facebook_views"}`
`facebook_reach`	Sum	Facebook reach	`{"type": "facebook_reach"}`
`facebook_love_reactions`	Sum	Facebook love reactions	`{"type": "facebook_love_reactions"}`
`facebook_haha_reactions`	Sum	Facebook haha reactions	`{"type": "facebook_haha_reactions"}`
`facebook_wow_reactions`	Sum	Facebook wow reactions	`{"type": "facebook_wow_reactions"}`
`facebook_sad_reactions`	Sum	Facebook sad reactions	`{"type": "facebook_sad_reactions"}`
`facebook_angry_reactions`	Sum	Facebook angry reactions	`{"type": "facebook_angry_reactions"}`

Instagram

Metric	Computation	Description	Example
`instagram_likes`	Sum	Instagram likes	`{"type": "instagram_likes"}`
`instagram_comments`	Sum	Instagram comments	`{"type": "instagram_comments"}`
`instagram_shares`	Sum	Instagram shares	`{"type": "instagram_shares"}`
`instagram_saved`	Sum	Instagram saves	`{"type": "instagram_saved"}`
`instagram_views`	Sum	Instagram views	`{"type": "instagram_views"}`
`instagram_reach`	Sum	Instagram reach	`{"type": "instagram_reach"}`
`instagram_follower_count`	Sum	Instagram follower count stored on each mention	`{"type": "instagram_follower_count"}`

Metric	Computation	Description	Example
`linkedin_likes`	Sum	LinkedIn likes	`{"type": "linkedin_likes"}`
`linkedin_comments`	Sum	LinkedIn comments	`{"type": "linkedin_comments"}`

Metric	Computation	Description	Example
`pinterest_likes`	Sum	Pinterest likes	`{"type": "pinterest_likes"}`
`pinterest_comments`	Sum	Pinterest comments	`{"type": "pinterest_comments"}`
`pinterest_repins`	Sum	Pinterest repins	`{"type": "pinterest_repins"}`
`pinterest_shares`	Sum	Pinterest shares on mainstream mentions	`{"type": "pinterest_shares"}`

Redbook

Metric	Computation	Description	Example
`redbook_likes`	Sum	Redbook likes	`{"type": "redbook_likes"}`
`redbook_favorites`	Sum	Redbook favorites	`{"type": "redbook_favorites"}`
`redbook_reposts`	Sum	Redbook reposts	`{"type": "redbook_reposts"}`
`redbook_reviews`	Sum	Redbook reviews	`{"type": "redbook_reviews"}`

X / Twitter

Metric	Computation	Description	Example
`twitter_favorites`	Sum	X / Twitter favorites	`{"type": "twitter_favorites"}`
`twitter_replies`	Sum	X / Twitter replies	`{"type": "twitter_replies"}`
`twitter_retweets`	Sum	X / Twitter retweets	`{"type": "twitter_retweets"}`
`twitter_quotes`	Sum	X / Twitter quotes	`{"type": "twitter_quotes"}`
`twitter_bookmarks`	Sum	X / Twitter bookmarks	`{"type": "twitter_bookmarks"}`
`twitter_views`	Sum	X / Twitter views	`{"type": "twitter_views"}`

WeChat

Metric	Computation	Description	Example
`wechat_likes`	Sum	WeChat likes	`{"type": "wechat_likes"}`
`wechat_like_shares`	Sum	WeChat like shares	`{"type": "wechat_like_shares"}`
`wechat_views`	Sum	WeChat views	`{"type": "wechat_views"}`

Weibo

Metric	Computation	Description	Example
`weibo_likes`	Sum	Weibo likes	`{"type": "weibo_likes"}`
`weibo_favorites`	Sum	Weibo favorites	`{"type": "weibo_favorites"}`
`weibo_reposts`	Sum	Weibo reposts	`{"type": "weibo_reposts"}`
`weibo_reviews`	Sum	Weibo reviews	`{"type": "weibo_reviews"}`
`weibo_video_views`	Sum	Weibo video views	`{"type": "weibo_video_views"}`

YouTube

Metric	Computation	Description	Example
`youtube_likes`	Sum	YouTube likes	`{"type": "youtube_likes"}`
`youtube_dislikes`	Sum	YouTube dislikes	`{"type": "youtube_dislikes"}`
`youtube_comments`	Sum	YouTube comments	`{"type": "youtube_comments"}`
`youtube_views`	Sum	YouTube views	`{"type": "youtube_views"}`

Search and surveys

Metric	Computation	Description	Example
`search_volume`	Sum	Search volumes	`{"type": "search_volume"}`
`unique_search_related_search`	Distinct count	Distinct related searches	`{"type": "unique_search_related_search"}`
`unique_search_related_search_english`	Distinct count	Distinct related searches in English	`{"type": "unique_search_related_search_english"}`
`multiwave_survey_score`	Sum	Multiwave survey scores	`{"type": "multiwave_survey_score"}`

Sentiment and scoring

ratings_avg is the average normalized rating in the bucket.

SRS stands for Synthesio Reputation Score. srs_volume and srs_sentiment are scores from 0 to 100, built from the sentiment counts in that same bucket. srs_volume uses positive, neutral, and negative mentions. srs_sentiment uses positive and negative mentions. Unassigned mentions are in neither score. Neutral mentions are only in srs_volume.

The denominator is the count those mentions add up to: positive + neutral + negative for srs_volume, positive + negative for srs_sentiment. When that count is 0, there is nothing to divide by, and the score is 0. A bucket of only unassigned mentions is the usual case.

In the January bucket from Complete example, the counts are positive 8278, neutral 4875, negative 2023, unassigned 4355. srs_volume divides by 8278 + 4875 + 2023. srs_sentiment divides by 8278 + 2023. The 4355 unassigned mentions are left out of both.

Metric	Computation	Description	Example
`ratings_avg`	Average	Normalized rating	`{"type": "ratings_avg"}`
`srs_volume`	Score	`100 * (positive + 0.5 * neutral) / (positive + neutral + negative)`	`{"type": "srs_volume"}`
`srs_sentiment`	Score	`100 * (0.5 + 0.5 * (positive - negative) / (positive + negative))`	`{"type": "srs_sentiment"}`

When the positive and negative counts are equal, srs_sentiment is 50. When there are positive mentions and no negative mentions, it is 100.