Blastopus for developers

One API for content, listings, and AI agents.

Create, adapt, schedule, and export through a workspace-scoped REST API—or give your agent the same capabilities through MCP.

Start building Connect MCP

Workspace-scoped keys

Generate up to five keys in Settings. The full secret is shown once; only its SHA-256 hash is stored.

Durable rate limits

Every API key receives 120 requests per minute, enforced by atomic Postgres minute buckets.

Graceful integrations

AI, email, SMS, and publishing adapters retain deterministic no-key or mock paths.

Authentication

Bearer keys, isolated by workspace.

Create a key under Settings → Developer API keys, save it once, and send it on every request. Revocation takes effect immediately.

Authorization: Bearer blst_••••••••••••••••••••••••••••••••••••••••

REST API v1

Method	Endpoint	Purpose
GET	/api/v1/posts	List posts with optional status and channelId filters.
POST	/api/v1/posts	Create a draft or scheduled post with channel variants.
POST	/api/v1/posts/:id/schedule	Schedule or reschedule a workspace post.
POST	/api/v1/adapt	Draft or adapt content into platform variants.
POST	/api/v1/autopilot	Generate a review-ready seven-day plan.
GET	/api/v1/channels	List safe connected-channel metadata.
GET	/api/v1/listings	List eBay listing drafts.
POST	/api/v1/listings	Generate an eBay listing from notes and photos.
GET	/api/v1/listings/export.csv	Download Seller Hub-compatible CSV.

Curl cookbook

Every endpoint, ready to paste.

List posts

curl -H "Authorization: Bearer $BLASTOPUS_API_KEY" \
+  "https://blastopus.com/api/v1/posts?status=SCHEDULED"

Create post

curl -X POST https://blastopus.com/api/v1/posts \
+  -H "Authorization: Bearer $BLASTOPUS_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"sourceText":"A useful idea","status":"DRAFT","variants":[{"channelId":"CHANNEL_ID","body":"A useful idea"}]}'

Schedule post

curl -X POST https://blastopus.com/api/v1/posts/POST_ID/schedule \
+  -H "Authorization: Bearer $BLASTOPUS_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"scheduledAt":"2026-07-15T15:00:00.000Z"}'

Adapt content

curl -X POST https://blastopus.com/api/v1/adapt \
+  -H "Authorization: Bearer $BLASTOPUS_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"topic":"Calmer content systems","platforms":["X","LINKEDIN","BLUESKY"]}'

Plan a week

curl -X POST https://blastopus.com/api/v1/autopilot \
+  -H "Authorization: Bearer $BLASTOPUS_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"goal":"Teach practical AI workflows","frequency":5,"channelIds":["CHANNEL_ID"]}'

List channels

curl -H "Authorization: Bearer $BLASTOPUS_API_KEY" \
+  https://blastopus.com/api/v1/channels

List listings

curl -H "Authorization: Bearer $BLASTOPUS_API_KEY" \
+  https://blastopus.com/api/v1/listings

Create listing

curl -X POST https://blastopus.com/api/v1/listings \
+  -H "Authorization: Bearer $BLASTOPUS_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"notes":"Vintage blue ceramic bowl in excellent condition","quantity":1}'

Export listings

curl -H "Authorization: Bearer $BLASTOPUS_API_KEY" \
+  -o blastopus-ebay.csv https://blastopus.com/api/v1/listings/export.csv

Model Context Protocol

Give an agent the Blastopus toolkit.

The streamable HTTP server exposes adapt_content, create_post, plan_week, list_channels, and create_listing. Configure your MCP client with the same API key as a Bearer authorization header.

{
  "blastopus": {
    "url": "https://blastopus.com/api/mcp/mcp",
    "headers": {
      "Authorization": "Bearer ${BLASTOPUS_API_KEY}"
    }
  }
}