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
const API_KEY = "Your API KEY"; fetch("https://app.ayrshare.com/api/analytics/post", { method: "POST", headers: { "Content-Type": "application/json", Authorization: `Bearer ${API_KEY}`, }, body: JSON.stringify({ id: "Post ID", platforms: [ "facebook", "instagram", "x", "linkedin", "tiktok", "youtube", ], }),}).then((res) => res.json());
715
Documented fields
12
Networks with analytics
4
Scopes: post, account, comments, reviews
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
| Network | Per-post | Per-account | Comments | Reviews | Fields |
|---|---|---|---|---|---|
| Yes | Yes | Yes | Yes | 127 | |
| X (formerly Twitter) | Yes | Yes | Yes | – | 86 |
| Snapchat | Yes | Yes | – | – | 84 |
| Yes | Yes (company + personal) | Yes | – | 75 | |
| Yes | Yes | – | – | 67 | |
| TikTok | Yes | Yes | Yes | – | 58 |
| YouTube | Yes | Yes | Yes | – | 54 |
| Yes | Yes | Yes | – | 51 | |
| Yes | Yes | Yes | – | 38 | |
| Bluesky | Yes | Yes | Yes | – | 33 |
| Google Business Profile | – | Yes | – | Yes | 22 |
| Threads | Yes | Yes | Yes | – | 20 |
| Telegram | – | – | – | – | 0 |
Explore every field by network
Pick a network. See every field it returns.
Post-level54 fields
blueReelsPlayCountReels plays after impressioncommentsCountComments on the postlikeCountLikes on the postlikedByUsers who liked (id, name)mediaUrlsAttached media objectsmediaViewPlays or displays, all formatsmediaViewIsFromAdsMedia views from adsmediaViewIsFromFollowersMedia views from followerspostVideoAvgTimeWatchedReels avg time watched (ms)postVideoSocialActionsReels comments, shares, reactionspostVideoViewTimeReels total time watched (ms)reactions.likeLike reactions (incl. care)reactions.loveLove reactionsreactions.angerAnger reactionsreactions.hahaHaha reactionsreactions.wowWow reactionsreactions.sorrySorry reactionsreactions.totalTotal reactionsreactionsByTypeReaction type countsharesCountTimes sharedvideoViewsPlays ≥3s, excl. replaystotalVideo10SViewsVideo metrictotalVideo10SViewsAutoPlayedVideo metrictotalVideo10SViewsClickedToPlayVideo metrictotalVideo10SViewsOrganicVideo metrictotalVideo10SViewsPaidVideo metrictotalVideo10SViewsSoundOnVideo metrictotalVideo10SViewsUniqueVideo metrictotalVideo15SViewsVideo metrictotalVideo60SExcludesShorterViewsVideo metrictotalVideoAvgTimeWatchedVideo metrictotalVideoCompleteViewsVideo metrictotalVideoCompleteViewsAutoPlayedVideo metrictotalVideoCompleteViewsClickedToPlayVideo metrictotalVideoCompleteViewsOrganicVideo metrictotalVideoCompleteViewsOrganicUniqueVideo metrictotalVideoCompleteViewsPaidVideo metrictotalVideoCompleteViewsPaidUniqueVideo metrictotalVideoCompleteViewsUniqueVideo metrictotalVideoReactionsByTypeTotalVideo metrictotalVideoStoriesByActionTypeVideo metrictotalVideoViewTimeByAgeBucketAndGenderVideo metrictotalVideoViewTimeByDistributionTypeVideo metrictotalVideoViewTimeByRegionIdVideo metrictotalVideoViewTotalTimeVideo metrictotalVideoViewTotalTimeOrganicVideo metrictotalVideoViewTotalTimePaidVideo metrictotalVideoViewsVideo metrictotalVideoViewsAutoplayedVideo metrictotalVideoViewsByDistributionTypeVideo metrictotalVideoViewsClickedToPlayVideo metrictotalVideoViewsOrganicVideo metrictotalVideoViewsPaidVideo metrictotalVideoViewsSoundOnVideo metricAccount-level58 fields
aboutPage about textbirthdayPage birthdaycategoryPage categoryemailsContact emailsfanCountPage fansfollowersCountPage followersidPage IDinstagramBusinessAccount.idLinked IG business IDisPublishedPage published flaglinkPage URLlocation.streetStreetlocation.zipZIPlocation.cityCitylocation.countryCountrylocation.latitudeLatitudelocation.longitudeLongitudenamePage nameoverallStarRatingOverall ratingunreadMessageCountUnread messagesusernameHandleverifiedVerification flagwebsiteWebsiteengagement.countEngagement countengagement.socialSentenceEngagement summarypageFollowsPage followspageMediaViewPage media viewspageMediaViewIsFromAdsMedia views from adspageMediaViewIsFromFollowersMedia views from followerspagePostEngagementsPost engagementsreactions.likeLikes, 180-dayreactions.loveLoves, 180-dayreactions.angerAnger, 180-dayreactions.hahaHaha, 180-dayreactions.wowWow, 180-dayreactions.sorrySorry, 180-dayreactions.totalTotal, 180-daypageVideoViewsPage video viewspageVideoViewsAutoplayedAutoplayed viewspageVideoViewsOrganicOrganic viewspageVideoViewsPaidPaid viewspageVideoViewsClickToPlayClick-to-play viewspageVideoCompleteViews30s30s complete viewspageVideoCompleteViews30sAutoplayed30s autoplayedpageVideoCompleteViews30sClickToPlay30s click-to-playpageVideoCompleteViews30sOrganic30s organicpageVideoCompleteViews30sPaid30s paidpageVideoCompleteViews30sRepeatViews30s repeat viewspageVideoCompleteViews30sUnique30s uniquepageVideoRepeatViewsRepeat viewspageVideoViewsByPaidNonPaid.totalViews totalpageVideoViewsByPaidNonPaid.unpaidUnpaid viewspageVideoViewsByPaidNonPaid.paidPaid viewspageVideoViewsByUploadedHosted.pageUploadedUploaded viewspageVideoViewsByUploadedHosted.pageUploadedFromCrosspostsCrosspost viewspageVideoViewsByUploadedHosted.pageUploadedFromSharesShare viewspageVideoViewsByUploadedHosted.pageHostedCrosspostHosted crosspostpageVideoViewsByUploadedHosted.pageHostedShareHosted sharepageVideoViewsByUploadedHosted.pageOwnedOwned viewsComments-level3 fields
likeCountLikes on the commentcommentCountReplies to the commentuserLikesAuthed user liked itReviews-level12 fields
averageRatingPositive/neutral/negative aggregatetotalReviewCountTotal reviewslastUpdatedData timestampnextUpdateNext refreshratingPer-review ratingreviewReview textcreatedCreated timeupdatedUpdated timeidReview IDreviewer.nameReviewer namereviewer.idReviewer IDreviewReply.replyOwner replyHow 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.
Can I track link clicks?
Yes, with Ayrshare short links on the Business Plan with the Max Pack.
Total clicks with breakdowns by browser, referrer, and social network source, filterable by date.
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.
