SocialCrawl
Unified schema

Cross-platform field equivalence

How every platform's raw metric maps to one unified SocialCrawl field. TikTok play_count, YouTube viewCount, and Twitter views.count all become engagement.views.

Cross-platform field equivalence

Every platform names the same metric differently. TikTok calls it play_count, YouTube calls it viewCount, Twitter calls it views.count. SocialCrawl normalizes all of them to one field: post.engagement.views. This table is the proof: it shows exactly which raw upstream field each platform's data comes from, for the metrics developers compare most.

Write your comparison logic against the unified field on the left, once, and it works across every platform on the right.

Engagement metrics

Unified post.engagement.views (views / plays)

PlatformUpstream 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, video_play_count
Kickclip.view_count
Kwaiview_count
Pinterestfollower_count, viewCount
Redditview_count
RumbleviewCountInt
Spotifyplaycount
Threadspost.view_counts
TikTokaweme_info.statistics.play_count, statistics.play_count
Truth SocialviewCount
Twitch0.data.clip.viewCount, viewCount
Twitter/Xview_count, views.count
YouTubevideoCount, viewCount, viewCountInt

Unified post.engagement.likes (likes / reactions)

PlatformUpstream field
BlueskylikeCount, post.likeCount
Facebookgoing_count, like_count, reactionCount, social_context.going_count
GitHubreactions.total_count, stargazers_count
Hacker Newspoints
Instagramdata.xdt_shortcode_media.edge_media_preview_like.count, items.0.like_count, like_count, media.like_count
Kickclip.likes_count
Kwailike_count
LinkedInactivity.num_likes, data.activity.num_likes
Pinterestpin_count, totalReactionCount
Redditups
RumblelikeCount
Threadslike_count, post.like_count
TikTokaweme_info.statistics.digg_count, statistics.digg_count
TikTok Shopsold_info.sold_count
Truth Socialfavourites_count
Twitch0.data.clip.likeCount
Twitter/Xfavorite_count, legacy.favorite_count
YouTubelikeCount, likeCountInt

Unified post.engagement.comments (comments)

PlatformUpstream field
Blueskypost.replyCount, replyCount
FacebookcommentCount, comment_count
GitHubcomments, open_issues_count
Hacker Newsnum_comments
Instagramcomment_count, data.xdt_shortcode_media.edge_media_to_parent_comment.count, items.0.comment_count, media.comment_count
Kickclip.commentCount
Kwaicomment_count
LinkedInactivity.num_comments, data.activity.num_comments
PinterestaggregatedPinData.commentCount
Redditnum_comments
Threadspost.text_post_app_info.direct_reply_count, text_post_app_info.direct_reply_count
TikTokaweme_info.statistics.comment_count, statistics.comment_count
TikTok Shoprate_info.review_count
Truth Socialreplies_count
Twitch0.data.clip.commentCount
Twitter/Xlegacy.reply_count, reply_count
YouTubecommentCount, commentCountInt

Unified post.engagement.shares (shares / retweets)

PlatformUpstream field
Blueskypost.repostCount, repostCount
Facebookshare_count
GitHubforks_count
Instagramdata.xdt_shortcode_media.share_count, items.0.reshare_count
Kickclip.shareCount
Kwaiforward_count
LinkedInactivity.num_shares, data.activity.num_shares
PinterestshareCount
Redditnum_crossposts
Threadspost.text_post_app_info.repost_count, text_post_app_info.repost_count
TikTokaweme_info.statistics.share_count, statistics.share_count
Truth Socialreblogs_count
Twitch0.data.clip.shareCount
Twitter/Xlegacy.retweet_count, retweet_count

Unified post.engagement.saves (saves / bookmarks)

PlatformUpstream field
Facebooksaves_count
Instagramdata.xdt_shortcode_media.save_count
Kickclip.saveCount
Kwaifavorite_count
PinterestaggregatedPinData.aggregatedStats.saves
Redditsaves
TikTokaweme_info.statistics.collect_count, statistics.collect_count
Truth SocialbookmarkCount
Twitch0.data.clip.clipCount
Twitter/Xbookmark_count, legacy.bookmark_count

Post content

Unified post.content.text (caption / body text)

PlatformUpstream field
Amazondata.description
Blueskypost.record.text, record.text
Facebookaccessibility_caption, description, name, snapshot.body, snapshot.body.text, text, title
GitHubdescription, name, title
GoogleadvertiserName, post_text
Hacker Newstitle
Instagramcaption, caption.text, data.xdt_shortcode_media.edge_media_to_caption.edges.0.node.text, items.0.caption.text, media.caption.text, title
Kickclip.title
Kwaicaption
LinkedIndata.text, text
Naverdescription, title
Pinterestdescription, name, title
Reddittitle
Rumbletitle
Spotifyname
Threadscaption.text, post.caption.text
TikTokaweme_info.desc, desc
TikTok Shoptitle
Truth Socialtext
Twitch0.data.clip.title, title
Twitter/Xfull_text, legacy.full_text
YouTubecontent, title

Unified post.published_at (publish time)

PlatformUpstream field
BlueskyindexedAt, post.indexedAt
Facebookcreation_time, publishTime, startDateString, start_date_string, start_timestamp
GitHubcreated_at, published_at
GooglefirstShown, timestamp
Hacker Newscreated_at
Instagramdata.xdt_shortcode_media.taken_at_timestamp, items.0.taken_at, media.taken_at, taken_at
Kickclip.created_at
Kwaicreated_at
LinkedIncreated_at, data.created_at
Naverpostdate, pubDate
Pinterestcreated_at
Redditcreated_utc
RumblepublishedAt
SpotifyalbumOfTrack.date.isoString, date.isoString, releaseDate.isoString
Threadspost.taken_at, taken_at
TikTokaweme_info.create_time, create_time
Truth Socialcreated_at
Twitch0.data.clip.createdAt, publishedAt
Twitter/Xcreated_at, legacy.created_at
YouTubepublishDate, publishedAt, publishedTime

Author / creator

Unified author.followers (follower count)

PlatformUpstream field
BlueskyfollowersCount
FacebookfollowerCount, likes
GitHubfollowers, stargazers_count
Instagramdata.user.edge_followed_by.count, follower_count
Kwaifollower_count
LinkedIndata.follower_and_connection.follower_count, data.follower_count, follower_count, follower_count_display
LinkMeprofile.totalFollowers
Redditsubscribers
SnapchatuserProfile.subscriberCount
Spotifystats.followers
Threadsfollower_count
TikTokfollower_count, stats.followerCount, user_info.follower_count
Truth Socialfollowers_count
Twitchfollowers
Twitter/Xlegacy.followers_count
YouTubesubscriberCount

Unified author.following (following count)

PlatformUpstream field
BlueskyfollowsCount
FacebookfriendsCount
GitHubfollowing, forks_count
Instagramdata.user.edge_follow.count, following_count
Kwaifollowing_count
LinkedIndata.follower_and_connection.connection_count
Redditfollowing_count
SnapchatuserProfile.followingCount
Threadsfollowing_count
TikTokfollowing_count, stats.followingCount, user_info.following_count
Truth Socialfollowing_count
TwitchfollowingCount
Twitter/Xlegacy.friends_count

Unified author.posts_count (post count)

PlatformUpstream field
BlueskypostsCount
FacebookpostsCount
GitHubopen_issues_count, public_repos
Instagramdata.user.edge_owner_to_timeline_media.count, media_count
Kwaipublic_post_count
LinkMeprofile.totalLinks
Redditsubmission_count
SnapchatuserProfile.storyCount
Spotifystats.monthlyListeners
Threadstext_post_app_media_count
TikTokaweme_count, stats.videoCount, user_info.aweme_count
Trustpilotreviews_count
Truth Socialstatuses_count
TwitchvideoCount
Twitter/Xlegacy.statuses_count
YouTubevideoCount

Unified author.likes_count (total likes)

PlatformUpstream field
FacebooklikeCount
GitHubpublic_gists, subscribers_count
Hacker Newskarma
Instagramdata.user.total_likes
Kwailike_count
Reddittotal_karma
SnapchatuserProfile.totalViews
Threadslike_count
TikTokstats.heartCount, total_favorited, user_info.total_favorited
Truth Socialfavourites_count
TwitchtotalLikes
Twitter/Xlegacy.favourites_count
YouTubeviewCount

For the full field list, nullability, and per-platform availability of each shape, see the schema reference.

Cross-platform field equivalence | SocialCrawl