Skip to main content

​
Overview

Ayrshare’s Social-Post-API PyPI Package allows you to integrate the Ayrshare API into your Python app.

​
Installation

Install the Social-Post-API PyPI Package if you use Python on the server-side. The package simplifies the calls by wrapping the RESTful calls. Start by getting your secret API Key in Ayrshare Dashboard. Next, install the Python package: 
pip install social-post-api

​
General Usage

Examples of Post, History, and Delete. Please see the PyPI Package for more information.
Posting to X/Twitter? Starting March 31, 2026, X requires your own API credentials. Add 4 BYO headers to your request. See the setup guide for details.
from ayrshare import SocialPost
social = SocialPost('8jKj782Aw8910dCN') # get an API Key at ayrshare.com

# Post to Platforms Twitter, Facebook, and LinkedIn
postResult = social.post({'post': 'Nice Posting 2', 'platforms': ['twitter', 'facebook', 'linkedin'], 'profileKey': 'JKSDJI-JKKJKKJ'})
print(postResult)

# Delete
deleteResult = social.delete({'id': postResult['id']})
print(deleteResult)

# History
print(social.history())

​
Profile Key

You may specify the Profile Key for User Profile in the body of a POST or query of a GET with the profileKey field.

​
More Information and Documentation