PostBloomer — Publish everywhere.
One API. 11 platforms.
One request fans your content out to Instagram, X, Reddit, Facebook, Telegram, Bluesky, Mastodon, Threads, Pinterest, TikTok and more. Bring your own accounts. Post from any app, agent or script.
Platform Matrix
Every platform in one contract: POST /v1/publish/<platform>. Official APIs where they exist, community APIs where they don't — with risk flagged honestly.
API Endpoints
Every publish endpoint accepts content, optional mediaUrl, optional credentialLabel (defaults to your latest credential) and platform-specific extras.
| Method | Path | Description |
|---|---|---|
| POST | /v1/auth/register | Create an account (email + password) → returns your pb_… API key |
| POST | /v1/auth/key | Login with email + password → returns (regenerates) your API key |
| POST | /v1/credentials/{platform} | Store a platform credential (JSON, label optional) |
| GET | /v1/credentials | List credential labels + platforms — secret data is never returned |
| DELETE | /v1/credentials/{id} | Delete a stored credential |
| POST | /v1/publish/{platform} | Publish to one platform: instagram · x · reddit · facebook · telegram · bluesky · mastodon · threads · pinterest · tiktok |
| POST | /v1/publish/omni | The Buffer-killer. Fan out to up to 11 platforms in one call — per-platform results array |
| GET | /v1/posts | Your post history with status filter (pending|posted|failed) |
| GET | /v1/platforms | Capability matrix: official vs community, media types, risk level, experimental flags |
| GET | /health | Service health + platform count |
Quick Start
Register, store one credential, publish everywhere. Three curls, done.
1 — Register & get your API key
curl -X POST http://your-vps:8400/v1/auth/register \
-H 'Content-Type: application/json' \
-d '{"email":"you@mail.com","password":"supersecret1"}'
# → {"success":true,"api_key":"pb_1a2b3c…"}
2 — Store a credential (Bluesky example)
curl -X POST http://your-vps:8400/v1/credentials/bluesky \
-H 'Authorization: Bearer pb_1a2b3c…' \
-H 'Content-Type: application/json' \
-d '{"data":{"handle":"@me.bsky.social","appPassword":"xxxx-xxxx"}}'
3 — Publish everywhere at once
curl -X POST http://your-vps:8400/v1/publish/omni \
-H 'Authorization: Bearer pb_1a2b3c…' \
-H 'Content-Type: application/json' \
-d '{
"platforms":["bluesky","reddit","telegram"],
"content":"PostBloomer just went live 🌸",
"extras":{
"reddit":{"subreddit":"SaaS"},
"telegram":{"target":"@mychannel"}
}
}'
# → {"success":true,"posted":3,"failed":0,
# "results":[{"platform":"bluesky",…},…]}
Marketplace gateway (RapidAPI) traffic
curl -X POST http://your-vps:8400/v1/publish/bluesky \
-H 'X-RapidAPI-Proxy-Secret: YOUR_SECRET' \
-H 'Content-Type: application/json' \
-d '{"content":"via marketplace","userKey":"pb_…"}'
Pricing
Start free. Scale when your audience does.
- 1,000 posts / month
- 5 platforms
- Post history & status tracking
- Email support
- 10,000 posts / month
- All 11 platforms
- Omni fan-out
- Unlimited credentials
- Priority support
- Unlimited volume
- Self-host / VPS deployment
- Custom platform requests
- Dedicated support channel
FAQ
How does authentication work?
Register with email + password and receive a pb_… API key. Send it as Authorization: Bearer pb_…. Re-logging in with /v1/auth/key rotates the key. Marketplace (RapidAPI) traffic authenticates with the X-RapidAPI-Proxy-Secret header instead, optionally combined with a userKey to scope to a specific account.
Where do my platform accounts live?
You store credentials per platform via the credentials endpoints. They are kept private to your account and are never returned by any listing endpoint — only labels and platform names.
What happens if one platform fails during an Omni fan-out?
Omni continues fanning out to the remaining platforms and returns a per-platform results array — each item carries its own success flag, external post id or error. Partial success is a valid outcome, and every attempt (posted or failed) is recorded in your post history.
Why is LinkedIn disabled?
Unofficial posting to LinkedIn violates their terms of service and puts your account at risk, so this build returns 501 with an honest message instead of pretending it's safe. Company Intelligence use-cases are served by our companion API, DataCore.
Which platforms are riskier than others?
Platforms with official APIs (Reddit, Facebook, Telegram, Bluesky, Mastodon) are low risk. Community-API platforms (Instagram, X, Threads, Pinterest, TikTok) are unofficial and carry account risk — flagged clearly in GET /v1/platforms. TikTok is additionally marked experimental.
Does every platform support media?
Instagram requires a photo URL, TikTok requires a video URL, and Mastodon is text-only in this build. Check mediaTypes in the platform matrix before posting.