InsightSocial API
Unified schema

Field equivalence

Which native platform field feeds each unified field, for the metrics people compare most across platforms.

Each platform names the same number its own way: TikTok says play_count, YouTube says viewCount, Twitter/X says views.count. In a response, all three arrive as post.engagement.views. The tables below show, per platform, which native fields a unified field is filled from.

Build comparisons on the unified field once and they work across every platform listed. Several native names per platform means different endpoints on that platform expose the value under different names.

The paths on this page are schema 2, which every key gets from October 4, 2026.

Fields that moved in schema 2

Some values used to sit in ext on a few platforms. Schema 2 gives them one place on every platform:

ValuePrevious placeSchema 2
Author ID on a postext.author_id (Facebook, Instagram lists, LinkedIn, TikTok), ext.channel_id (YouTube)post.author.id
Author ID on a commentext.author_id, ext.author_channel_id (YouTube), Reddit's t2_ ID in author.display_name, Facebook's pfbid… ID in author.usernamecomment.author.id. Reddit's stays t2_…, prefix kept.
Reddit account ID on a post or profileauthor.display_name (posts), display_name (profiles)post.author.id and the profile's id, as t2_… with the prefix kept, so posts, comments and profiles join on one value. display_name is then null.
Language of a post or commentext.content_language, ext.default_languagepost.language, comment.language
Rounded follower countext.followers_approximateauthor.followers_approximate (profiles)
Bio linkext.bio_link (TikTok, X), url (Instagram)author.external_url. author.url is always the profile.
Original Unix timestampext.published_at_epochRemoved. published_at is always ISO 8601 UTC.
Post formatext.media_type, ext.content_type, ext.post_typepost.kind. The ext keys stay where the platform sends them.
YouTube ext keyscamelCasesnake_case, such as made_for_kids, category_id, default_audio_language

author.id is null where the source gives no ID (usually Threads, Twitter/X and Pinterest posts), and the response lists it in unavailable.

Engagement

post.engagement.views

PlatformNative field
Facebookinterested_count, reachEstimate, reach_estimate, social_context.interested_count, videoViewCount, view_count
Instagramdata.xdt_shortcode_media.video_play_count, items.0.play_count, media.play_count, play_count
Threadspost.view_counts, view_counts
TikTokaweme_info.statistics.play_count, ch_info.view_count, impression, lifetime_views, statistics.play_count, stats.playCount, userCount, vv_count
Twitter/Xview_count, views.count
YouTubeviewCount, viewCountInt

The Facebook interested_count entries are events, where views carries the interested count; see Metric substitutions.

post.engagement.likes

PlatformNative field
Facebookgoing_count, like_count, reactionCount, reactions_count, social_context.going_count
Instagramdata.xdt_shortcode_media.edge_media_preview_like.count, items.0.like_count, like_count, media.like_count
LinkedInactivity.num_likes, data.activity.num_likes, stats.total_reactions
Pinterestpin_count, reaction_counts.1, totalReactionCount
Redditscore, ups (a score below zero gives null here and ext.score)
Threadslike_count, post.like_count
TikTokaweme_info.statistics.digg_count, like, likes, statistics.digg_count, stats.diggCount
Twitter/Xfavorite_count, legacy.favorite_count
YouTubelikeCount, likeCountInt

post.engagement.comments

PlatformNative field
FacebookcommentCount, comment_count, comments_count
Instagramcomment_count, data.xdt_shortcode_media.edge_media_to_parent_comment.count, items.0.comment_count, media.comment_count
LinkedInactivity.num_comments, data.activity.num_comments, stats.comments
PinterestaggregatedPinData.commentCount, aggregated_pin_data.did_it_data.responses_count
Redditcomments, num_comments
Threadspost.text_post_app_info.direct_reply_count, text_post_app_info.direct_reply_count
TikTokaweme_info.statistics.comment_count, comment, statistics.comment_count, stats.commentCount
Twitter/Xlegacy.reply_count, reply_count
YouTubecommentCount, commentCountInt

post.engagement.shares

PlatformNative field
Facebookshare_count
Instagramitems.0.reshare_count
LinkedInactivity.num_shares, data.activity.num_shares, stats.reposts
Pinterestrepin_count, shareCount
Threadspost.text_post_app_info.repost_count, text_post_app_info.repost_count
TikTokaweme_info.statistics.share_count, share, statistics.share_count, stats.shareCount
Twitter/Xlegacy.retweet_count, retweet_count

post.engagement.saves

PlatformNative field
Instagramitems.0.save_count
PinterestaggregatedPinData.aggregatedStats.saves, aggregated_pin_data.aggregated_stats.saves
TikTokaweme_info.statistics.collect_count, statistics.collect_count, stats.collectCount
Twitter/Xbookmark_count, legacy.bookmark_count

A platform listed here may still return null on most surfaces; Metric substitutions says where. A platform missing from a table never fills that field: see Never shown publicly.

Never shown publicly

These post counts are not shown publicly on most of the platform. They are null on most endpoints, and a response never lists them in unavailable:

PlatformPost fields
Instagramengagement.shares, engagement.saves (Sends and saves come only from the stats endpoints named on Post)
Facebookengagement.saves, author.username
Threadsengagement.saves
YouTubeengagement.shares, engagement.saves
Redditengagement.views, engagement.shares, engagement.saves, author.display_name
LinkedInengagement.views, engagement.saves
Pinterestengagement.views

Post content

post.content.text

PlatformNative field
Facebookaccessibility_caption, description, message, name, snapshot.body, snapshot.body.text, text, title
Instagramcaption, caption.text, data.xdt_shortcode_media.edge_media_to_caption.edges.0.node.text, items.0.caption.text, media.caption.text, title
LinkedIndata.text, description, text, title
Pinterestdescription, name, title
Reddittitle
Threadscaption.text, post.caption.text
TikTokadTitle, ad_title, aweme_info.desc, ch_info.cha_name, desc, hashtag, name, title
Twitter/Xnote_tweet.note_tweet_results.result.text
YouTubecontent, title

post.published_at

PlatformNative field
Facebookcreation_time, publishTime, startDateString, start_date_string, start_timestamp, timestamp
Instagramdata.xdt_shortcode_media.taken_at_timestamp, items.0.taken_at, media.taken_at, taken_at
LinkedIncreated_at, data.created_at, posted_at.timestamp, startDate
PinterestcreatedAt, created_at
Redditcreated_utc, creationDate
Threadspost.taken_at, taken_at
TikTokaweme_info.create_time, createTime, create_time, created_at, first_shown_date, publish_time
Twitter/Xcreated_at, legacy.created_at
YouTubepublishDate, publishedAt, publishedTime, videoPublishedAt

Whatever the native format (ISO string, Unix seconds or milliseconds, X's own date text), published_at is ISO 8601 in UTC, ending in Z.

Author

author.followers

PlatformNative field
FacebookfollowerCount, likes, member_count
Instagramdata.user.edge_followed_by.count, follower_count, user.follower_count
LinkedIndata.follower_and_connection.follower_count, data.follower_count, follower_count, follower_count_display
Redditsubscribers
Threadsfollower_count
TikTokfollower_count, user.follower_count, user_info.follower_count
Twitter/Xlegacy.followers_count, member_count
YouTubeSubscriberCount, subscriberCount

author.following

PlatformNative field
Instagramdata.user.edge_follow.count, following_count, user.following_count
LinkedIndata.follower_and_connection.connection_count
TikTokfollowing_count, user.following_count, user_info.following_count
Twitter/Xlegacy.friends_count

author.posts_count

PlatformNative field
Instagramdata.user.edge_owner_to_timeline_media.count, media_count, user.media_count
TikTokaweme_count, user.aweme_count, user_info.aweme_count
Twitter/Xlegacy.statuses_count
YouTubeTotalVideosCount, videoCount

author.likes_count

PlatformNative field
FacebooklikeCount
TikToktotal_favorited, user.total_favorited, user_info.total_favorited

Reddit and Threads profiles never carry following, posts_count or likes_count; Reddit karma is in ext.post_karma and ext.comment_karma. For every field, its nullability and per-platform coverage, see the Post, Author and Comment pages.

On this page