Analytics API

Every social media metric you can pull from Ayrshare API

Ayrshare's Analytics API returns 715 distinct fields across 12 social networks through one integration, covering four scopes: per-post engagement, account and profile level, per-comment engagement, and reviews

715

Documented fields

12

Networks with analytics

4

Scopes: post, account, comments, reviews

Field reference

Every analytics field, by network

715 documented fields across 12 networks and four scopes — per-post, account, comments, and reviews. Use the coverage matrix for a quick answer, or open any network to see every field it returns.

Coverage by network

NetworkPer-postPer-accountCommentsReviewsFields
FacebookYesYesYesYes127
X (formerly Twitter)YesYesYes86
SnapchatYesYes84
LinkedInYesYes (company + personal)Yes75
PinterestYesYes67
TikTokYesYesYes58
YouTubeYesYesYes54
InstagramYesYesYes51
RedditYesYesYes38
BlueskyYesYesYes33
Google Business ProfileYesYes22
ThreadsYesYesYes20
Telegram0

Explore every field by network

Pick a network. See every field it returns.

Facebook

127documented fields across all scopes
Platform note: Meta retired the unique-reach and totalVideoImpressions families on June 15, 2026. mediaView is the reach successor.

Post-level54 fields

blueReelsPlayCountReels plays after impression
commentsCountComments on the post
likeCountLikes on the post
likedByUsers who liked (id, name)
mediaUrlsAttached media objects
mediaViewPlays or displays, all formats
mediaViewIsFromAdsMedia views from ads
mediaViewIsFromFollowersMedia views from followers
postVideoAvgTimeWatchedReels avg time watched (ms)
postVideoSocialActionsReels comments, shares, reactions
postVideoViewTimeReels total time watched (ms)
reactions.likeLike reactions (incl. care)
reactions.loveLove reactions
reactions.angerAnger reactions
reactions.hahaHaha reactions
reactions.wowWow reactions
reactions.sorrySorry reactions
reactions.totalTotal reactions
reactionsByTypeReaction type count
sharesCountTimes shared
videoViewsPlays ≥3s, excl. replays
totalVideo10SViewsVideo metric
totalVideo10SViewsAutoPlayedVideo metric
totalVideo10SViewsClickedToPlayVideo metric
totalVideo10SViewsOrganicVideo metric
totalVideo10SViewsPaidVideo metric
totalVideo10SViewsSoundOnVideo metric
totalVideo10SViewsUniqueVideo metric
totalVideo15SViewsVideo metric
totalVideo60SExcludesShorterViewsVideo metric
totalVideoAvgTimeWatchedVideo metric
totalVideoCompleteViewsVideo metric
totalVideoCompleteViewsAutoPlayedVideo metric
totalVideoCompleteViewsClickedToPlayVideo metric
totalVideoCompleteViewsOrganicVideo metric
totalVideoCompleteViewsOrganicUniqueVideo metric
totalVideoCompleteViewsPaidVideo metric
totalVideoCompleteViewsPaidUniqueVideo metric
totalVideoCompleteViewsUniqueVideo metric
totalVideoReactionsByTypeTotalVideo metric
totalVideoStoriesByActionTypeVideo metric
totalVideoViewTimeByAgeBucketAndGenderVideo metric
totalVideoViewTimeByDistributionTypeVideo metric
totalVideoViewTimeByRegionIdVideo metric
totalVideoViewTotalTimeVideo metric
totalVideoViewTotalTimeOrganicVideo metric
totalVideoViewTotalTimePaidVideo metric
totalVideoViewsVideo metric
totalVideoViewsAutoplayedVideo metric
totalVideoViewsByDistributionTypeVideo metric
totalVideoViewsClickedToPlayVideo metric
totalVideoViewsOrganicVideo metric
totalVideoViewsPaidVideo metric
totalVideoViewsSoundOnVideo metric

Account-level58 fields

aboutPage about text
birthdayPage birthday
categoryPage category
emailsContact emails
fanCountPage fans
followersCountPage followers
idPage ID
instagramBusinessAccount.idLinked IG business ID
isPublishedPage published flag
linkPage URL
location.streetStreet
location.zipZIP
location.cityCity
location.countryCountry
location.latitudeLatitude
location.longitudeLongitude
namePage name
overallStarRatingOverall rating
unreadMessageCountUnread messages
usernameHandle
verifiedVerification flag
websiteWebsite
engagement.countEngagement count
engagement.socialSentenceEngagement summary
pageFollowsPage follows
pageMediaViewPage media views
pageMediaViewIsFromAdsMedia views from ads
pageMediaViewIsFromFollowersMedia views from followers
pagePostEngagementsPost engagements
reactions.likeLikes, 180-day
reactions.loveLoves, 180-day
reactions.angerAnger, 180-day
reactions.hahaHaha, 180-day
reactions.wowWow, 180-day
reactions.sorrySorry, 180-day
reactions.totalTotal, 180-day
pageVideoViewsPage video views
pageVideoViewsAutoplayedAutoplayed views
pageVideoViewsOrganicOrganic views
pageVideoViewsPaidPaid views
pageVideoViewsClickToPlayClick-to-play views
pageVideoCompleteViews30s30s complete views
pageVideoCompleteViews30sAutoplayed30s autoplayed
pageVideoCompleteViews30sClickToPlay30s click-to-play
pageVideoCompleteViews30sOrganic30s organic
pageVideoCompleteViews30sPaid30s paid
pageVideoCompleteViews30sRepeatViews30s repeat views
pageVideoCompleteViews30sUnique30s unique
pageVideoRepeatViewsRepeat views
pageVideoViewsByPaidNonPaid.totalViews total
pageVideoViewsByPaidNonPaid.unpaidUnpaid views
pageVideoViewsByPaidNonPaid.paidPaid views
pageVideoViewsByUploadedHosted.pageUploadedUploaded views
pageVideoViewsByUploadedHosted.pageUploadedFromCrosspostsCrosspost views
pageVideoViewsByUploadedHosted.pageUploadedFromSharesShare views
pageVideoViewsByUploadedHosted.pageHostedCrosspostHosted crosspost
pageVideoViewsByUploadedHosted.pageHostedShareHosted share
pageVideoViewsByUploadedHosted.pageOwnedOwned views

Comments-level3 fields

likeCountLikes on the comment
commentCountReplies to the comment
userLikesAuthed user liked it

Reviews-level12 fields

averageRatingPositive/neutral/negative aggregate
totalReviewCountTotal reviews
lastUpdatedData timestamp
nextUpdateNext refresh
ratingPer-review rating
reviewReview text
createdCreated time
updatedUpdated time
idReview ID
reviewer.nameReviewer name
reviewer.idReviewer ID
reviewReply.replyOwner reply

How many analytics metrics does the Ayrshare API return?

715 distinct analytics fields across 12 networks. Facebook exposes the most at 127 fields, followed by X (formerly Twitter) at 86, Snapchat at 84, and LinkedIn at 75.

The count is field names returned by the analytics endpoints: nested objects expand to their named leaves, dynamic breakdowns (like audience-country maps or daily time series) count once, and the shared response envelope is excluded. The methodology is documented so the number is reproducible, and you can audit it against the full field reference in the docs before you build.

Which social networks return analytics?

Twelve: Facebook, Instagram, X (formerly Twitter), LinkedIn, TikTok, YouTube, Pinterest, Reddit, Threads, Bluesky, Snapchat, and Google Business Profile.

Telegram is supported for publishing; its API exposes no analytics, so none exist to return. The coverage matrix above shows which scopes each network exposes.

Does the API return video retention curves and watch time?

Yes, where the platform exposes them.

TikTok returns a per-video retention curve (videoViewRetention) plus average time watched, total time watched, and full-video-watched rate. YouTube returns average view duration, average view percentage, and estimated minutes watched at both video and channel level. Pinterest returns video watch time, 95%-quartile views, and 10-second views. Facebook returns an extensive video family including complete views, view time by distribution type, and sound-on views.

Does it return reaction breakdowns by type, or just a like count?

Breakdowns.

Facebook returns reactions split into like, love, anger, haha, wow, and sorry, plus a total. LinkedIn returns its native set mapped to the UI: Like, Celebrate, Curious, Love, Insightful, and Support, on both company and personal posts. If your product needs to know how an audience felt rather than just how loudly it clapped, the type-level data is there.

Does it return audience demographics?

Yes, on Instagram and TikTok.

Instagram returns audience city, country, and gender-age splits, including engaged-audience variants, once an account passes the platform's minimum threshold (roughly 100 followers or engagements). TikTok returns audience age, country, and gender percentages at the account level, plus per-video audience countries, cities, genders, and viewer types (follower, new, returning).

Does it return Instagram story metrics like tap-backs and exits?

Yes.

Story insights include taps forward, taps back, exits, swipe-forwards, navigation, replies, reach, and views. Build around Instagram's two rules: story insights are available for 24 hours, and values under 5 return as zero.

What can I pull per post?

It varies by network and media type. Highlights:

Instagram splits by product type: feed, reels, and story each return a distinct field set (reels add plays, replays, average watch time, and total view time).

X (formerly Twitter) returns public metrics (likes, reposts, quotes, replies, bookmarks, impressions) plus non-public and organic metrics including video playback quartiles at 0/25/50/75/100%. X makes non-public and organic metrics available for posts up to 30 days old, so schedule your pulls inside that window.

LinkedIn returns clicks, impressions, unique impressions, engagement ratio, reaction types, and video metrics, for both company pages and personal profiles.

Pinterest returns impressions, saves and save rate, pin clicks, outbound clicks, and the video family per pin.

Snapchat returns views, viewers, view time, completes, screenshots, swipe-ups and swipe-downs, and story-level equivalents.

What can I pull per account?

Profile-level metrics for all 12 networks: follower and engagement counts everywhere, plus network-specific depth like LinkedIn company page views broken down by section (about, careers, jobs, people, products) across desktop and mobile, TikTok button clicks (bio link, email, phone, app download, lead submissions), YouTube subscriber gains and losses, Pinterest 90-day summary metrics with daily time series, and Google Business Profile impressions across desktop and mobile search and maps, plus direction requests, calls, and bookings.

Does it return comment-level engagement?

Yes.

The comments endpoint returns per-comment objects with likes, replies, quotes, reposts, bookmarks, and impressions depending on the platform, refreshed roughly every ten minutes. Facebook and Instagram return up to the most recent 1,000 comments per post, and you roll the objects up whichever way your reporting needs.

Does it return reviews and ratings?

Yes, for Facebook and Google Business Profile on the Premium tier.

Aggregate average rating and total review count, plus per-review rating, text, timestamps, reviewer details, and any reply.

Is there sentiment analysis or social listening?

Yes.

The sentiment endpoint runs AI analysis on supplied text and returns a positive, negative, or neutral classification with opportunities and recommendations. Social listening returns public brand and competitor counts (followers, media counts, subscriber and view counts) across major networks on the Business Plan.

How fresh is the data?

Every analytics response carries lastUpdated and nextUpdate timestamps, so your product always knows the age of a number and when to fetch again. Comment data refreshes roughly every ten minutes.

Raw platform metrics or normalized metrics: which does Ayrshare return?

Raw and platform-native.

Some social media APIs normalize analytics into one compact vocabulary (likes, views, shares) that is identical across networks. That is simpler to consume, and it discards everything that doesn't fit the common denominator: retention curves, reaction types, story navigation, section-level page views. Ayrshare returns each network's own fields under each network's own names, and documents the cases where a platform's API and its native UI count differently, so your reporting is built on what the platform actually said. You consume what you need and ignore the rest; the depth is there when your product grows into it.

Why does this matter for AI agents?

An agent that publishes needs to observe outcomes to improve. The Analytics API is that feedback loop: it returns the measured result of every post so the agent can learn what worked, which is the observe step in the complete content-agent workflow of learn, act, observe, stay safe. Depth matters more for agents than for human reporting, because an agent can act on a retention-curve dip or a reaction-type shift that no human would open a dashboard to find.

Start pulling all 715

Full field tables, endpoints, and code examples live in the analytics documentation. Agencies: see how client reporting scales on this data.