get_post_history
Get Post History
Retrieve the history and status of posts sent via Ayrshare. Filter by platform, date range, status, or type. Returns detailed metadata for each post including content, platforms, status, and engagement URLs.
get_post_history
Retrieve the history and status of posts sent via Ayrshare. Filter by platform, date range, status, or type. Returns detailed metadata for each post including content, platforms, status, and engagement URLs.
delete_feed
Remove an RSS feed subscription to stop auto-publishing from that feed.
get_messages
Retrieve direct message conversations from Facebook, Instagram, or X/Twitter. Can list all conversations or fetch messages from a specific conversation.
get_feeds
List all RSS feed subscriptions configured for the account.
post_comment
Post a comment or reply on a social media post. Supports posting to multiple platforms simultaneously and optionally includes an image attachment.
send_message
Send a direct message on Facebook, Instagram, or X/Twitter. Supports text messages and media attachments (images, videos, voice files).
create_post
Publish or schedule a post to one or multiple social networks simultaneously. Supports text, images, and video content. Posts can be sent immediately or scheduled for a future date. Supports platform-specific options, auto-hashtag generation, link shortening, and auto-reposting.
get_profiles
List user profiles with optional filtering by title, reference ID, or active social accounts. Supports pagination for large profile lists. Requires Business plan.
upload_media
Upload an image or video file to Ayrshare's media hosting. Returns a publicly accessible URL that can be used in post creation. Accepts Base64 Data URI encoded files.
add_feed
Subscribe to an RSS feed to automatically post new items to social networks. New feed items are detected and published to the specified platforms.
delete_post
Delete one or more posts from social networks. Supports deleting a single post by ID, bulk deletion of multiple posts, or clearing all scheduled posts.
get_comments
Retrieve comments on a post. Supports looking up by Ayrshare Post ID, Social Post ID, or Social Comment ID. Returns comment text, author, timestamps, like counts, and replies.
create_profile
Create a new user profile for managing social media accounts on behalf of a client. Returns a profile key that must be stored securely — it cannot be retrieved again via API. Requires Business plan.
get_post_analytics
Retrieve engagement analytics for a specific post across platforms. Returns metrics such as likes, comments, shares, impressions, reach, and platform-specific engagement data.
delete_profile
Permanently delete a user profile and all associated posts. This action is irreversible. Requires Business plan.
get_reviews
Retrieve reviews from Facebook Pages or Google Business Profile. Returns review text, ratings, reviewer info, and reply data.
delete_comment
Delete a comment from social media posts across specified platforms.
update_post
Update a scheduled or pending post. Can approve posts that require approval, update the schedule date, or pause/unpause scheduled posts.
generate_hashtags
Automatically generate and add relevant hashtags to post text using AI. Takes into account real-time hashtag popularity. Returns the post text with hashtags added.
get_social_analytics
Retrieve account-level analytics for linked social media accounts. Returns metrics like follower counts, impressions, engagement rates, and demographic breakdowns. Supports daily time-series data and quarterly aggregation.
validate_post
Validate post content before publishing. Runs technical and content checks and returns detailed error messages on how to correct any issues. Use this to verify content, character limits, and media compatibility before creating a post.
Publish, schedule, and manage social media posts across 13 platforms (Facebook, X/Twitter, Instagram, LinkedIn, TikTok, YouTube, Reddit, Telegram, Pinterest, Snapchat, Google Business Profile, Threads, and Bluesky) through a single unified API. Retrieve post and account-level analytics including likes, clicks, and engagement. Manage comments by retrieving, posting, replying to, and deleting them. Send and receive direct messages on Facebook and Instagram. Get, respond to, and delete reviews on Facebook Pages and Google Business Profile. Upload and host media files for use in posts. Auto-generate hashtags, shorten links, and validate content before publishing. Create Facebook ads by boosting posts. Monitor brand presence across platforms. Subscribe to RSS feeds for automatic posting. Manage multiple user profiles and their linked social accounts.
Common questions about connecting Ayrshare to AI agents with Metorial.