clipsilo
Sign up
clipsilo
Start free trial →
Distribution

Distribute approved assets anywhere.

Pull via REST API. Push via webhook. Retrieve via MCP. Approved content flows to every platform in your stack — and never an unapproved byte.

Start free trial See the API docs →

How distribution works

Two patterns. Pick both.

Some systems want to poll. Others want to be notified. clipsilo does both, natively — no queue infrastructure to run.

Pull — REST API

Query approved assets on your schedule. Filter by status, tag, category, date range, or platform. Paginated, idempotent, and safe to call from any cron, n8n flow, or downstream worker. Perfect when your CMS or publishing tool owns the schedule.

Push — Webhooks

Subscribe to events like asset.approved and batch.completed. clipsilo posts a signed JSON payload to your endpoint within seconds of the state change. Perfect for reactive, event-driven pipelines.

Platforms

Platform-aware metadata, out of the box

Every batch item can carry platform-specific variants — captions, hooks, thumbnails, aspect ratios. Your distribution pipeline never has to guess which caption goes where.

TikTok

9:16 vertical, hook-first captions, trend-aware hashtag slots. Pull approved vertical cuts with one filter.

Instagram

Feed, Reels, and Stories — separate platform_asset records per variant, each with its own caption and metadata.

YouTube

Long-form and Shorts. Attach title, description, chapter markers, and tags alongside the approved master file.

Twitter / X

Short-form video and image posts with character-budgeted copy. Track post IDs back to assets for threaded analytics.

LinkedIn

Company page and personal posts — separate captions, targeting, and pinned-comment copy per variant.

Anything else

Custom platform names are first-class — store any string. Use it for newsletters, podcasts, SMS campaigns, paid ads.

Code examples

Pull a batch. Handle a webhook.

GET an approved batch

GET /api/v1/batches/:id 
# Pull one approved batch with every platform variant
curl https://clipsilo.io/api/v1/batches/btc_01j9x8k3pqrs \
  -H "Authorization: Bearer $CS_API_KEY"

# Response
{
  "id": "btc_01j9x8k3pqrs",
  "batch_ref": "campaign-q3-hero-001",
  "status": "approved",
  "approved_at": "2025-07-14T10:22:00Z",
  "items": [
    {
      "item_ref": "hero-video-16x9",
      "category": "brand",
      "platform_assets": [
        {
          "platform": "youtube",
          "caption": "Q3 Brand Campaign",
          "download_url": "https://your-bucket.s3..."
        },
        {
          "platform": "tiktok",
          "caption": "summer is here ⚡",
          "download_url": "https://your-bucket.s3..."
        }
      ]
    }
  ]
}

Webhook payload — asset.approved

POST {your-webhook-url} 
{
  "event": "asset.approved",
  "event_id": "evt_01j9x8k3...",
  "delivered_at": "2025-07-14T10:22:01Z",
  "data": {
    "asset_id": "ast_01j9x8k3pqrs",
    "batch_id": "btc_01j9x8k3pqrs",
    "platform": "youtube",
    "title": "Q3 Brand Campaign — Hero",
    "approved_by": "sarah@agency.com",
    "approved_at": "2025-07-14T10:22:00Z",
    "download_url": "https://your-bucket.s3..."
  }
}

Every webhook is signed with HMAC-SHA256. Verify the signature, enqueue the job, respond 200. clipsilo retries with exponential backoff on non-2xx responses.

Related features

API Ingestion →

Upload assets with rich metadata via REST.

Client Approvals →

Gate the distribution queue with one-link reviews.

MCP Server →

Let AI agents retrieve approved assets directly.

Ready to organize your content pipeline?

Start your 7-day free trial. No credit card required. Cancel anytime.

Start free trial See pricing

7-day free trial · No credit card · Cancel anytime