Agent API

Built for AI Agents

Full REST API. MCP server. Webhooks. Let your AI assistants manage social media autonomously.

Get your API keyView examples

How it works

One API call. Every platform.

AI AgentClaude, GPT, etc.
socialAF APIREST + MCP
X
LinkedIn
Bluesky
Threads
Your agent sends a request
socialAF routes to platforms
Webhooks confirm delivery

Quick start

Ship in minutes

One POST request to publish across every platform. Pick your language.

curl -X POST https://socialaf.ai/api/v1/posts \
  -H "Authorization: Bearer saf_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Exciting product launch!",
    "platforms": ["twitter", "linkedin"],
    "scheduledAt": "2026-03-20T14:00:00Z"
  }'

Capabilities

Everything your agent needs

Create & schedule posts

Publish immediately or schedule for later. Supports per-platform content customization and media attachments.

POST /api/v1/posts
1 credit

Generate AI content

Generate platform-optimized posts with AI. Supports brand voice profiles and tone customization.

POST /api/v1/ai/generate
2 credits

Remix content

Transform one post into platform-native versions that respect each channel's culture and limits.

POST /api/v1/ai/remix
2 credits

Transform URLs to posts

Paste any link and get optimized social posts. Articles, videos, and tweets all supported.

POST /api/v1/ai/from-url
3 credits

Generate images

Create AI-generated images for your posts. Perfect for thumbnails, banners, and social graphics.

POST /api/v1/ai/image

Manage API keys & webhooks

Create, list, and revoke API keys. Register webhook endpoints for real-time event delivery.

GET /api/v1/keys
Webhooks

Real-time event delivery.

Get notified instantly when posts are published, fail, or get scheduled. HMAC-signed payloads ensure authenticity.

post.published
post.failed
post.scheduled
ai.completed
credits.low
Webhook Payload
{
  "event": "post.published",
  "timestamp": "2026-03-20T14:00:12Z",
  "data": {
    "postId": "6602f1a...",
    "platform": "twitter",
    "url": "https://x.com/you/status/..."
  }
}

Signed with X-Webhook-Signature HMAC-SHA256 header

Developer experience

Built for production

API key authentication

saf_live_ prefixed keys with scoped permissions. Create and revoke from the dashboard or API.

Rate limiting

100 requests/min for Pro plans. 10 requests/min on Free. Clearly communicated via response headers.

Dry-run mode

Append ?dry_run=true to any request. Validates everything without side effects.

Credit tracking

Every response includes X-Credits-Remaining header. Know exactly where you stand.

HMAC-signed webhooks

Every webhook payload is signed with your secret. Verify authenticity server-side.

Timezone-aware scheduling

Schedule posts with ISO 8601 timestamps. Supports any timezone for global publishing.

Ready to build something?

Get your API key and start publishing programmatically in minutes. Free tier available.

Get your API key

Free tier includes 10 requests/min · Pro unlocks 100 requests/min