Python SDK Getting Started

pip install socialrails

from socialrails import SocialRails
 
client = SocialRails(api_key="sr_live_...")
 
post = client.posts.create(
    content="Launching our new feature today!",
    platform="twitter",
    scheduled_for="2026-03-15T14:30:00Z",
)
print(post["id"])
 
client.close()

import asyncio
from socialrails import AsyncSocialRails
 
async def main():
    async with AsyncSocialRails(api_key="sr_live_...") as client:
        post = await client.posts.create(
            content="Hello from async Python!",
            platform="linkedin",
        )
        print(post["id"])
 
asyncio.run(main())

import os
os.environ["SOCIALRAILS_API_KEY"] = "sr_live_..."
 
client = SocialRails()  # picks up the env var

# Sync
with SocialRails(api_key="sr_live_...") as client:
    posts = client.posts.list()
 
# Async
async with AsyncSocialRails(api_key="sr_live_...") as client:
    posts = await client.posts.list()

from socialrails import SocialRails, SocialRailsError
 
client = SocialRails(api_key="sr_live_...")
 
try:
    client.posts.create(content="", platform="twitter")
except SocialRailsError as e:
    print(f"Error {e.status}: [{e.code}] {e.message}")