- Post Analytics: Get analytics on a post
- Social Analytics: Get analytics on a social account
- Link Analytics: Get analytics on a shortened link
How fresh the data is
Every successful analytics response carries two timestamps:lastUpdated— when the metrics you are looking at were fetched from the social network.nextUpdate— the earliest time a request will fetch fresh metrics again.
nextUpdate is the useful signal for scheduling your polling.
The interval is not fixed, and you should not hard-code a value for it: it varies by social
network and, on some networks, by how old the post is. Engagement arrives mostly in a post’s first
days, so an older post whose numbers have stopped moving can refresh far less often than a recent
one — on LinkedIn, a post more than about ten days old refreshes at most once a day. Account
analytics use their own interval. nextUpdate always tells you which interval applies to the
response you are holding.
If you need the numbers on a schedule, read nextUpdate from the response rather than polling on
a fixed timer — it tells you when there is something new to fetch.
Error responses may omit both fields, so read them defensively rather than assuming they are
always present.
Post Analytics
Individual post analytics are available. This is great if you want detailed analytics on a particular post, either one sent via Ayrshare or manually published at the social network. Post analytics are available for the following social networks:- Bluesky
- Snapchat
- Threads
- TikTok
- YouTube
- X/Twitter
Social Analytics
You can also get the account level social analytics, such as engagement, follower count and demographics, and account meta data. Use this endpoint if you want to get the analytics for an entire social account, rather than a specific post. Social account level analytics are available for the following social networks:- Google Business Profile
- Snapchat
- Threads
- TikTok
- YouTube
- X/Twitter
Link Analytics
You can also get analytics on a shortened link. This is great if you want to know how many clicks a link has received, either one sent via Ayrshare or manually published at the social network. Link analytics can be found in the /links endpoint.Link Analytics
Get analytics on a shortened link.