Posts History
History of Sent and Scheduled Posts
Get a history of all posts sent via Ayrshare, in descending order (most recent to oldest). Only the past 30 days of history is returned unless the lastDays parameter is set.
History status fields values:
awaiting approval: Posts are awaiting to be approved via the Approval Workflow.deleted: Post has been deleted. Note: deleted posts are only returned with the status query filter. Please see below.error: An error occurred with one or more social networks.pending: The posts has not yet been processed. Typically a scheduled post.success: The post was successfully sent to all social networks.
Header Parameters
Authorization: Bearer API_KEY. See API overview for more information.Query Parameters
Filter by current status of post. Valid values: “success”, “error”, “processing”, “pending”, “deleted”, and “awaiting approval”. Processing indicated the post is currently being sent. Pending indicates the post is scheduled to be posted at a future date.
Returns the last n days of posts by the publish date (scheduleDate if a scheduled posts). Default 30 days.
If the value is zero 0 will return the entire history of posts. E.g. lastDays=5 returns the last 5 days of posts and lastDays=0 returns all posts determined by the limit.
Returns the last n number of posts. For example, if you only want the most recent post, set limit=1. If not present will return all records contained within lastDays (see above).
Default 25 posts. Max value 500. Additional history available upon request.
Type values: immediate or scheduled.
Filter by social network platforms. Platform values: facebook, twitter, linkedin, instagram, youtube, reddit, telegram, gmb, pinterest, or tiktok.
Note, uses OR logic: [“facebook”, “instagram”] returns posts from either.
Response as Object. Default: true. Defaults to true starting Nov 1, 2024.