InsightSocial API

Computed fields

The computed block (engagement rate, language, category, estimated reach) was removed in schema 2. How to get the same numbers from the fields every response carries.

Responses used to carry a computed block: engagement_rate, language, content_category, estimated_reach and vs_creator. Schema 2, which every key gets from October 4, 2026, removed it on every endpoint. Responses now carry the platform's data only. What changed is on Schema 2.

What to use instead

WasNow
engagement_rateCompute it from post.engagement and the author's follower count. See below.
languagepost.language and comment.language: the language the platform itself states, such as en. null when the platform gives none. We do not detect languages.
content_categoryNo replacement. Classify post.content.text yourself.
estimated_reachNo replacement. Use post.engagement.views where the platform shows views.
vs_creatorCompare a post with the author's other posts yourself, from a page of /profile/posts results.

Engagement rate

Engagement rate is engagement divided by followers. Every post carries the counts in engagement. The follower count comes from the author's profile (data.author.followers on the platform's profile endpoint). On Twitter/X and TikTok post rows it is also in post.ext.author_followers, a snapshot taken with the row.

engagement_rate.py
def engagement_rate(post, followers):
    """(likes + comments + shares) / followers. None when it cannot be computed."""
    e = post["engagement"]
    counts = [e["likes"], e["comments"], e["shares"]]
    if not followers or all(c is None for c in counts):
        return None
    return sum(c for c in counts if c is not None) / followers

A count is null when the platform hides it or does not show it, so leave it out of the sum rather than reading it as zero. Instagram does not show share counts on most endpoints, so an Instagram rate is usually (likes + comments) / followers. Say which counts you used when you compare platforms.

A full worked example is in Creator engagement scoring. Every field of a post is described on Post.

On this page