AAttentionPilot
← All notes
Automation & AI5 min read

Choosing a social media scheduling API

What to check before building on one: which networks, what happens on partial failure, and how you find out.

Image to add
Header image for "Choosing a social media scheduling API"

Optional — the post reads fine without one.

If you are building posting into your own product, the differences between scheduling APIs are not really about network coverage. They are about what happens when something goes wrong.

Questions worth asking

  • Does one request post to several networks, or do you fan out yourself?
  • If three of five networks succeed, what does the response say?
  • Do you get the specific platform error, or a generic failure?
  • Are limits checked before scheduling, or discovered at publish time?
  • How do you learn a token died — a webhook, a status field, or silence?
  • Can you retry one failed network, or must you resend the whole post?

Why partial failure is the whole question

Any API can post to one network on a good day. The design that matters is what a partly-successful fan-out looks like, because that is the normal case once you are posting at volume across ten networks with independently expiring credentials.

An API that returns a single success boolean for a nine-network post is hiding the thing you most need to know.

{
  "status": "partial",
  "targets": [
    { "platform": "bluesky", "status": "posted", "url": "https://…" },
    { "platform": "x", "status": "failed",
      "error": "312 chars — X allows 280." }
  ]
}

And the boring things

Rate limits you can live with, a sandbox that does not require connecting real accounts, and revocation that takes effect immediately rather than when a cached token expires.

Related

Stop writing the same post four times.

Start free5 posts a month, no card.