Programmatically publish to 15 platforms from a single API call. Built for developers, AI agents, LLMs, and agentic workflows that need reliable social media automation without browser sessions or manual interaction.
from bulkpublish import BulkPublish
bp = BulkPublish("bp_your_key_here")
bp.posts.create(
content="Launching our new product today!",
channels=[{"channelId": 1, "platform": "x"}, {"channelId": 2, "platform": "linkedin"}],
status="scheduled",
scheduled_at="2026-04-10T09:00:00Z",
)
Schedule, cross-post, and analyze social media posts across 15 platforms from AI agents.
1.53.0
API-Schlüssel
BULKPUBLISH_API_KEY, BULKPUBLISH_TOOL_PROFILE
Zuletzt geprüft
2026-11-18
Sterne
—
Tools
—
Uptime
—
Why BulkPublish?
Most social media tools are built for humans clicking buttons. BulkPublish is built for code — whether that code is written by a developer, an AI agent, an LLM with tool use, or an autonomous workflow.
Headless by design — No browser, no UI, no OAuth pop-ups at runtime. Connect accounts once in the dashboard, then automate everything via API.
AI-native — MCP server for Claude, tool definitions for GPT and LangChain, structured JSON responses that LLMs parse reliably.
Agentic-ready — Deterministic API with clear error codes. AI agents can create posts, check status, retry failures, and read analytics autonomously.
15 platforms, one endpoint — Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon, Discord, Telegram, Tumblr, Snapchat.
Use Cases
AI social media managers — Let Claude, GPT, or custom agents schedule and publish posts autonomously
79 tools in the local (stdio) server: create_post, list_channels, upload_media, get_analytics, the interactive compose_post composer (MCP Apps), and more. The hosted server at https://mcp.bulkpublish.com/mcp (OAuth 2.1) serves the 20-tool core profile: channels, posts, media, analytics and the interactive panels. The 27-tool inbox profile adds reading and answering direct messages, reviews and comments. See mcp-server/README.md.
Social Media Content Skills
BulkPublish includes a 24-skill library for AI agents to plan, adapt, review, schedule, and publish social media content: Social Media Content Skills.
LLM Tool Use / Function Calling
Ready-made tool definitions for autonomous AI agents:
All examples are complete, runnable scripts with error handling.
Code Examples
Create a Post
from bulkpublish import BulkPublish
bp = BulkPublish("bp_your_key_here")
post = bp.posts.create(
content="Check out our latest update!",
channels=[
{"channelId": 1, "platform": "facebook"},
{"channelId": 2, "platform": "x"},
{"channelId": 3, "platform": "linkedin"},
],
status="draft",
)
import { BulkPublish } from 'bulkpublish';
const bp = new BulkPublish({ apiKey: 'bp_your_key_here' });
const post = await bp.posts.create({
content: 'Check out our latest update!',
channels: [
{ channelId: 1, platform: 'facebook' },
{ channelId: 2, platform: 'x' },
{ channelId: 3, platform: 'linkedin' },
],
status: 'draft',
});
Schedule a Post
post = bp.posts.create(
content="This will go out tomorrow morning.",
channels=[{"channelId": 1, "platform": "instagram"}],
status="scheduled",
scheduled_at="2026-04-10T09:00:00Z",
timezone="America/New_York",
)
Upload Media and Publish
media = bp.media.upload("./product-photo.jpg")
post = bp.posts.create(
content="Our newest product is here.",
channels=[{"channelId": 1, "platform": "instagram"}],
media_files=[media["file"]["id"]],
status="scheduled",
scheduled_at="2026-04-10T12:00:00Z",
)
Automation Example: Bulk Schedule from CSV
import csv
from bulkpublish import BulkPublish
bp = BulkPublish("bp_your_key_here")
channels = bp.channels.list()["channels"]
with open("content-calendar.csv") as f:
for row in csv.DictReader(f):
bp.posts.create(
content=row["content"],
channels=[{"channelId": ch["id"], "platform": ch["platform"]} for ch in channels],
status="scheduled",
scheduled_at=row["scheduled_at"],
timezone="America/New_York",
)
15 platforms — Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon, Discord, Telegram, Tumblr, Snapchat
Scheduling — Schedule posts for any future time with timezone support, or let queue slots pick optimal times
Media uploads — Images (JPEG, PNG, WebP, GIF) and videos (MP4, MOV, WebM) up to 100 MB
Recurring schedules — Repeat posts daily, weekly, biweekly, or monthly at a set time of day
Analytics — Track impressions, likes, comments, shares, and engagement. Each platform reports a different subset of metrics, and the response says which (supportedMetrics / supportedTotals) so a 0 is never mistaken for a measurement — see Metrics by Platform
Link tracking — Opt in per organization, or per post via linkTrackingOverride, to rewrite links through bulkpubli.sh and count the clicks. Reported as linkClicks / totalLinkClicks and measured by BulkPublish rather than the platform, so it works even where the platform reports nothing — see Character Limits
Labels — Organize posts and media with color-coded labels
Hashtag groups — Save sets of hashtags and drop them into a post in one call
Templates — Save post text and start new posts from it
Review links — Share a read-only page of a post with someone who has no account
Calendar notes — Pin campaigns, holidays and reminders to calendar days
Bulk operations — Delete or retry multiple posts in a single request
Threads — Multi-part thread posts for X, Threads, Bluesky, and Mastodon
Auto first comment — Automatically add a comment after publishing on any platform
All post types — Reels, Stories, Carousels, Threads, Shorts, Video — set per-platform via postTypeOverrides
Per-platform content — Customize text and options per platform in a single post
Platform-specific options — Instagram collaborators, TikTok privacy, YouTube categories, Pinterest boards, and more
List posts (paginated, filterable by status/date/channel/label)
GET
/api/posts/:id
Get a post with platform statuses and metrics
PUT
/api/posts/:id
Update a draft or scheduled post
DELETE
/api/posts/:id
Delete a post
POST
/api/posts/:id/publish
Publish a draft immediately
POST
/api/posts/:id/retry
Retry failed platforms
POST
/api/posts/:id/approve
Approve a post awaiting team approval (roles with post:approve)
POST
/api/posts/:id/reject
Reject a pending post back to draft, with an optional reason
POST
/api/posts/bulk
Bulk delete or retry
GET
/api/channels
List connected social media channels
GET
/api/channels/:id/health
Check channel token health
GET
/api/channels/:id/options
Get platform options (Pinterest boards, YouTube playlists, Tumblr blogs, Discord channels, Threads ?q= place search)
GET
/api/channels/:id/mentions
Search accounts for @mention (X, Bluesky, Mastodon, LinkedIn Pages — LinkedIn results are @[Name](urn:li:organization:ID) tokens plus the vanityName slug they matched on)
GET/POST
/api/templates
Saved post templates (get/update/delete via /api/templates/:id)
GET/POST
/api/calendar-notes
Notes pinned to calendar days, ?from&to range (update/delete via /api/calendar-notes/:id)
POST/DELETE
/api/posts/:id/share
Create or revoke the post's read-only review link (/p/<token>)
GET/POST
/api/hashtag-groups
Saved hashtag groups, 1-30 hashtags each (get/update/delete via /api/hashtag-groups/:id)
GET/POST
/api/channel-sets
Saved channel groups for one-click targeting (update/delete via /api/channel-sets/:id)
GET/POST
/api/rss-feeds
RSS/Atom autopost feeds — new items become posts (update/delete via /api/rss-feeds/:id)
POST
/api/media
Upload a media file (multipart form, up to 100MB)
POST
/api/media/multipart/create
Start a chunked upload for large media (videos up to 1GB, 10MB parts)
POST
/api/media/multipart/complete
Assemble uploaded parts and record the media file
GET
/api/media
List uploaded media
GET
/api/analytics/summary
Analytics summary for a date range
GET
/api/analytics/engagement
Engagement totals, per-day / per-platform / per-channel breakdowns, ranked and full post lists — filterable by channels, platforms, labels, format and media type; compare=1 adds the previous period
GET
/api/analytics/post-history
Every stored metrics snapshot for one post, per platform (trend since publish)
GET
/api/analytics/links
Tracked bulkpubli.sh links with click counts
POST
/api/schedules
Create a recurring schedule
GET
/api/quotas/usage
Check current plan limits and usage
GET
/api/inbox/conversations
Inbox: direct messages, reviews and comment threads, with filters and cursor paging (Pro and Business)
GET/POST
/api/inbox/conversations/:id/messages
Read a conversation, or send a reply to the person on the platform
PATCH
/api/inbox/conversations/:id
Mark read, archive, snooze or assign a conversation
GET
/api/posts/:id/engagement
Comments and reactions on a published post, per channel
POST
/api/posts/:id/comments/reply
Reply to a comment on a published post
POST
/api/posts/:id/comments/moderate
Like, unlike, hide, unhide or delete a comment
See the OpenAPI spec for the complete endpoint list.
Supported Platforms
Platform
Post Types
Media
Facebook
Post, Story
Images, Videos
Instagram
Feed, Reel, Story, Carousel
Images (JPEG), Videos (MP4, MOV)
X / Twitter
Tweet, Thread
Images, Videos, GIFs
TikTok
Video, Photo Slideshow
Videos (MP4, MOV), Images
YouTube
Video, Short
Videos (MP4, MOV, WebM, AVI, WMV, FLV)
Threads
Post, Thread, Quote Post
Images, Videos
Bluesky
Post, Thread
Images
Pinterest
Pin
Images, Videos
Google Business Profile
Post, Event, Offer
Images
LinkedIn
Post, Multi-image, PDF Carousel, Article, Document, Poll, Reshare
Images (JPEG, PNG, GIF), Videos (MP4), Documents (PDF, Word, PowerPoint)
Mastodon
Post, Thread
Images, Videos
Snapchat
Story, Saved Story, Spotlight
Exactly 1 image (JPG, PNG) or video (MP4, MOV, vertical, max 1GB; story video 5–60s, Spotlight 6–60s)
SDKs
Python
pip install bulkpublish
Supports sync and async. Rich docstrings on every method for IDE and LLM consumption.
Node.js / TypeScript
npm install bulkpublish
Full TypeScript types, zero dependencies, native fetch (Node 18+).
Homebrew (macOS/Linux)
brew tap azeemkafridi/bulkpublish && brew install bulkpublish
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Fragen
Wie installiere ich BulkPublish?
Kopieren Sie auf dieser Seite die http-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
Benötigt BulkPublish einen API-Schlüssel?
Der Herausgeber nennt diese Umgebungsvariablen: BULKPUBLISH_API_KEY, BULKPUBLISH_TOOL_PROFILE.
Welchen Transport verwendet BulkPublish?
BulkPublish wird über HTTP erreicht.
Wann wurde BulkPublish zuletzt geprüft?
Zuletzt geprüft: 2026-11-18. Schedule, cross-post, and analyze social media posts across 15 platforms from AI agents.