GET
/
history
/
:platform
Available on Business, Enterprise plans.

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

The 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
string
required
Format: Authorization: Bearer API_KEY. See API overview for more information.
Profile-Key
string
Profile Key of a user profile.

Path Parameters

platform
string
required

The platform of the posts to retrieve. Values: facebook, instagram, linkedin, pinterest, tiktok, twitter, youtube

Query Parameters

limit
number
default: 10

Number of history records to return. Max: 300.

skipAnalytics
boolean
default: false

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.

pagePublished
boolean
default: 10

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.