Social Media Posting API for Developers and AI Agents

Publish, schedule, and analyze posts across 10 platforms through a single social media API. No developer apps, no OAuth setup, no per-platform delays.

Start for FreeView documentation
TypeScript
import PostZen from '@postzen/node'
const postzen = new PostZen()

// 1. Connect any of 10 channels via OAuth
const { authUrl } = await postzen.accounts.connect({ platform: "instagram", profileId });

// 2. Publish everywhere in one call
await postzen.posts.post({
  body: {
    content: 'New feature drop',
    mediaItems: [{ url: 'https://example.com/demo.mp4' }],
    platforms: [
      { platform: 'instagram', accountId: instagramId },
      { platform: 'linkedin', accountId: linkedinId },
      { platform: 'tiktok', accountId: tiktokId },
    ],
  },
})

Key Features

Everything social in one integration

Every capability is available on every account through the same API. No add-ons, no feature tiers.

  • PublishingCreate posts across every connected account with one request, with platform-specific options when you need them.
  • Scheduling & queuesSchedule posts for exact times, or define recurring queue slots per profile and let queued content fill them.
  • Media uploadsUpload images and videos with presigned uploads or a public URL. PostZen validates each asset per platform.
  • Managed OAuthHosted connect flows for every network. No developer apps, no app reviews, no token refresh logic.
  • AnalyticsRead post and account analytics, audience demographics, and engagement trends through one consistent endpoint.
  • WebhooksReceive events when posts publish or fail, accounts connect, or a connection needs reauthorization.

How it Works

From API key to published post in 3 steps

Go from signup to your first cross-platform post in minutes.

  1. 01. Get your API key

    Sign up and grab your key in seconds. No sales call, no demo gate.

  2. 02. Connect social accounts

    Link accounts through one hosted OAuth flow. PostZen handles every platform's approval process.

  3. 03. Send one request

    POST once and your content goes out to every platform you selected.

Why an API

Skip months of platform integrations

Each social network means its own developer app, review process, token lifecycle, and media rules. One PostZen integration replaces all of it.

Building it yourself

  • 10 developer apps, 10 OAuth flows, 10 app reviews
  • Token refresh, rate limits, and retry logic per platform
  • Media specs and API rules that change without warning
  • Months of integration work before your first post
  • App review rejections and delays that block your launch
  • Quota restrictions that limit your users and frustrate your team
PostZen

2.3M+ posts

2,000+ users
  • One API key and one OAuth flow for every platform
  • Tokens, rate limits, and retries handled for you
  • Media validated and transformed per platform automatically
  • First post in production in under an hour

Pricing

How much does a social media API cost?

Building and maintaining 10 platform integrations in-house takes 6+ months of engineering time, and each native platform API means separate auth, rate limits, and media specs. Here's how PostZen compares.

ApproachMonthly costWhat you get
Build in-house (10 APIs)$10,000-$30,000+ in eng timeFull control, full maintenance burden
X API (Basic tier)$100/moX/Twitter only, 3,000 tweets/mo
Meta Graph APIFree (approval required)Instagram + Facebook only
PostZenFree up to 2 accounts, then per-account10 platforms, unlimited posts, full REST API. Pay only for accounts beyond your first 2.

* PostZen Free tier: first 2 social accounts free with unlimited posts and full API access. No credit card required.

Code Examples

Publish and measure in a few lines

Schedule a post with curl, Python, or Node.js, then read its performance back from the same API.

cURL
curl -X POST https://api.postzen.dev/v1/posts \
  -H "Authorization: Bearer $POSTZEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "New feature drop",
    "scheduledFor": "2026-09-01T10:00:00Z",
    "platforms": [
      { "platform": "instagram", "accountId": "acc_instagram" },
      { "platform": "linkedin", "accountId": "acc_linkedin" },
      { "platform": "tiktok", "accountId": "acc_tiktok" }
    ]
  }'
Python
from postzen import PostZen

client = PostZen()  # reads POSTZEN_API_KEY

response = client.posts.create_post(
    content="New feature drop",
    scheduled_for="2026-09-01T10:00:00Z",
    platforms=[
        {"platform": "instagram", "account_id": "acc_instagram"},
        {"platform": "linkedin", "account_id": "acc_linkedin"},
    ],
)

print(response.post.field_id)
TypeScript
import PostZen from '@postzen/node'

const postzen = new PostZen()

const { data } = await postzen.posts.createPost({
  body: {
    content: 'New feature drop',
    scheduledFor: '2026-09-01T10:00:00Z',
    platforms: [
      { platform: 'instagram', accountId: 'acc_instagram' },
      { platform: 'linkedin', accountId: 'acc_linkedin' },
    ],
  },
})

console.log(data.post._id)
cURL
curl "https://api.postzen.dev/v1/analytics/post-timeline?postId=post_123" \
  -H "Authorization: Bearer $POSTZEN_API_KEY"

# Response:
# {
#   "points": [
#     { "date": "2026-09-01", "likes": 42, "comments": 8, "impressions": 1580 },
#     { "date": "2026-09-02", "likes": 67, "comments": 12, "impressions": 3200 }
#   ]
# }

View the full API reference →

Platform Coverage

One API, 10 social networks

Publish through one integration while keeping the options that matter on each platform.

Frequently asked questions

Still have questions?

What is a social media API?

A social media API lets your product or scripts publish posts, schedule content, and read analytics on social networks programmatically. PostZen wraps the official APIs of 10 platforms behind one consistent REST interface.

Which platforms does the PostZen social media API support?

Instagram, X (Twitter), LinkedIn, Facebook, Threads, YouTube, TikTok, Pinterest, Bluesky, and Telegram — all through the same endpoints.

Do I need to create developer apps for each platform?

No. PostZen handles developer apps, approvals, and platform-specific limits for you. You connect accounts through hosted OAuth flows.

How long does it take to integrate?

Most teams publish their first post in under an hour. Authentication is a single bearer token and posting is one endpoint.

What media types can I post?

Images, videos, and GIFs. PostZen validates and transforms each asset to match every platform's requirements automatically.

Can AI agents use the API?

Yes. PostZen offers a hosted MCP server, a CLI, and SDKs, so agents can draft, schedule, and publish posts through natural language or code.

How do I know whether a post succeeded?

Every post has a status you can read from the API or receive through webhooks, so you can trigger retries or alerts in your own system.

Ship social features this week

Grab your API key and publish across every platform with one request.

Start for Free