Official TypeScript/Node.js SDK for the BulkPublish social media API. Automate publishing to 15 platforms — built for developers, scripts, AI agents, LLMs, and agentic workflows.

Installation

npm install bulkpublish

Requires Node.js 18+. Zero dependencies — uses native fetch.

Quick Start

import { BulkPublish } from 'bulkpublish';

const bp = new BulkPublish({ apiKey: 'bp_your_key_here' });

// List connected social media channels
const { channels } = await bp.channels.list();

// Upload media
const { file } = await bp.media.upload('./photo.jpg');

// Schedule a post to multiple platforms
const post = await bp.posts.create({
  content: 'Hello from the BulkPublish API!',
  channels: [
    { channelId: channels[0].id, platform: channels[0].platform },
    { channelId: channels[1].id, platform: channels[1].platform },
  ],
  mediaFiles: [file.id],
  scheduledAt: '2026-04-10T09:00:00Z',
  timezone: 'America/New_York',
  status: 'scheduled',
});

Post Type Overrides

// Post a reel to Instagram
const post = await bp.posts.create({
  content: 'Check this out!',
  channels: [{ channelId: 1, platform: 'instagram' }],
  mediaFiles: [mediaId],
  postTypeOverrides: { instagram: 'reel' },
});

Built for Automation

BulkPublish is designed for programmatic social media management — no browser sessions, no UI, no OAuth flows at runtime. Connect your accounts once in the dashboard, then automate everything:

AI agents — Use with Claude (MCP server), GPT (function calling), LangChain, or any LLM with tool use
Server-side scripts — Cron jobs, CI/CD pipelines, content syndication
Bulk operations — Iterate over data and schedule hundreds of posts programmatically
Analytics pipelines — Pull engagement data into your own dashboards or AI analysis (check supportedMetrics before treating a 0 as a measurement — platforms report different subsets)

Full TypeScript Types

Every request and response is fully typed. Works great with IDE autocomplete and LLM code generation:

import type { Post, Channel, CreatePostParams } from 'bulkpublish';

Available Resources

Resource	Methods
`bp.posts`	`create`, `list`, `get`, `update`, `delete`, `publish`, `retry`, `approve`, `reject`, `bulk`, `queueSlot`, `metrics`, `story`
`bp.channels`	`list`, `get`, `delete`, `health`
`bp.media`	`upload`, `list`, `get`, `delete`, `getLabels`, `setLabels`, `createMultipart`, `completeMultipart`, `abortMultipart`
`bp.analytics`	`summary`, `engagement`, `refresh`, `account`
`bp.labels`	`list`, `create`, `update`, `delete`
`bp.schedules`	`list`, `create`, `update`, `delete`
`bp.channelSets`	`list`, `create`, `update`, `delete` — saved channel groups for one-click targeting
`bp.rssFeeds`	`list`, `create`, `update`, `delete` — RSS/Atom autopost feeds (new items become posts; optional `fieldMapping` controls caption template, media, truncation, per-channel overrides)

Platform Requirements

Platform	Post Types	Media	Required Fields	Char Limit
Facebook	`post`, `reel`, `story`	Optional (reel/story need media)	—	63,206
Instagram	`feed_photo`, `feed_video`, `reel`, `story`, `carousel`	Required (type-specific)	—	2,200
X / Twitter	`tweet`	Optional (max 4 images or 1 video)	—	280
YouTube	`video`, `short`	Video required	`platformSpecific.youtube.title`	5,000
TikTok	`video`, `photo_slideshow`	Video or images required	—	2,200
LinkedIn	`post`, `multi_image`, `pdf_carousel`, `article`	Varies by type	`url` for article	3,000
Pinterest	`pin`, `video_pin`, `carousel`	Required	`platformSpecific.pinterest.title`	500
Threads	`text`, `image`, `video`, `carousel`	Optional	—	500
Bluesky	`post`	Optional (max 4 images or 1 video)	—	300
GMB	`standard`, `event`, `offer`	Optional (image only)	dates for event	1,500
Mastodon	`post`	Optional (max 4 images or 1 video)	—	500

Important:

YouTube and TikTok only accept video — do not include them for image-only posts
Instagram defaults to feed_photo — set postTypeOverrides for video content
Use platformContent for shorter text on low-limit platforms (Bluesky 300, Pinterest 500)