Posts History for a Platform
History of Sent Posts for a Platform, even post that did not originate via via Ayrshare.
Get Facebook, Instagram, LinkedIn, Pinterest, TikTok, X/Twitter, or YouTube posts and analytics, even post that did not originate via via Ayrshare.
The ID returned is the low-level post ID directly from the social network and not the Ayrshare Post ID. For example, you can retrieve a post that was manually shared on facebook.com and use the low-level Facebook ID to get comments or analytics.
If you do not need posts that originated outside of Ayrshare, simply use the top-level id returned in a post on comment, analytics, or history.
:platform
= facebook
, instagram
, linkedin
, pinterest
, tiktok
, twitter
, youtube
.
Example: https://api.ayrshare.com/api/history/instagram
mediaUrl
field is omitted from response if the media contains copyrighted material or has been flagged for a copyright violation. Examples of copyrighted material can include audio on reels. You can check in the Instagram app under Settings -> Account Status.Header Parameters
Authorization: Bearer API_KEY
. See API overview for more information.Path Parameters
The platform of the posts to retrieve. Values: facebook
, instagram
, linkedin
, pinterest
, tiktok
, twitter
, youtube
Query Parameters
Number of history records to return. Max: 300.
Skip gathering full analytics for Facebook Pages and Instagram. Returns only the social ID. Should be used if analytics aren’t needed, for a faster return, or errors occur when limit > 100.
Facebook only. By default the posts returned are from the Facebook Page feed. You may also choose to only return posts published by the page.
Use feed (default) when you want a more comprehensive view of all content associated with the page, including interactions from other users. Use pagePublished
when you only want to retrieve posts made by the page itself.