Python SDK

pip install relay

from relay import Relay

client = Relay()  # reads RELAY_API_KEY from environment

client = Relay(api_key="rlay_live_...")

post = client.posts.create(
    content="Hello from the Python SDK!",
    targets=["acc_twitter_123", "acc_linkedin_456"],
    scheduled_at="now",
)
print(f"Post created: {post.id} — status: {post.status}")

post = client.posts.create(
    content="This will go out tomorrow morning",
    targets=["twitter", "linkedin"],
    scheduled_at="2025-01-15T09:00:00Z",
    timezone="America/New_York",
)

post = client.posts.create(
    content="Work in progress...",
    targets=["instagram"],
    scheduled_at="draft",
)

accounts = client.accounts.list()
for acc in accounts.data:
    print(f"{acc.platform}: {acc.display_name} ({acc.id})")

# Get a presigned upload URL
presign = client.media.presign(
    filename="photo.jpg",
    content_type="image/jpeg",
)

# Upload the file directly to the URL
import httpx
with open("photo.jpg", "rb") as f:
    httpx.put(presign.upload_url, content=f.read(), headers={"Content-Type": "image/jpeg"})

# Use the public URL in a post
post = client.posts.create(
    content="Check out this photo!",
    targets=["instagram"],
    media=[{"url": presign.url, "type": "image"}],
    scheduled_at="now",
)

post = client.posts.create(
    content="Default content for all platforms",
    targets=["twitter", "linkedin", "bluesky"],
    target_options={
        "twitter": {"content": "Short version for Twitter"},
        "linkedin": {"content": "Longer professional version for LinkedIn with more context"},
    },
    scheduled_at="now",
)

analytics = client.analytics.retrieve(post_id="post_abc123")
for platform, metrics in analytics.items():
    print(f"{platform}: {metrics.impressions} impressions, {metrics.likes} likes")

health = client.accounts.health()
for acc in health:
    status = "healthy" if acc.healthy else "needs attention"
    print(f"{acc.platform} ({acc.username}): {status}")

from relay import Relay, APIError, AuthenticationError, RateLimitError

client = Relay()

try:
    post = client.posts.create(
        content="Hello!",
        targets=["twitter"],
        scheduled_at="now",
    )
except AuthenticationError:
    print("Invalid API key")
except RateLimitError as e:
    print(f"Rate limited — retry after {e.retry_after}s")
except APIError as e:
    print(f"API error {e.status_code}: {e.message}")

import asyncio
from relay import AsyncRelay

async def main():
    client = AsyncRelay()

    post = await client.posts.create(
        content="Async post!",
        targets=["twitter"],
        scheduled_at="now",
    )
    print(f"Posted: {post.id}")

asyncio.run(main())