Everything the dashboard does, from your code
A REST API with SDKs for TypeScript, Python and PHP, and webhooks and a WebSocket that tell you what happened. AI agents get an MCP server.
import { Crumbcast } from "crumbcast"; const crumbcast = new Crumbcast({ token: process.env.CRUMBCAST_TOKEN, baseUrl: "https://your-crumbcast",}); // file: a browser File, or fs.openAsBlob(path) in Node// In parts, straight to storage; then encoding startsconst video = await crumbcast.uploadVideo(projectId, file, { title: "Launch day",}, { onProgress: (part) => show(part.uploaded / part.total),}); // Or have Crumbcast fetch it from a linkawait crumbcast.videos.importVideo({ project_id: projectId, importVideoRequest: { url: "https://example.com/launch.mp4", title: "Launch day", },});import os from crumbcast import Crumbcast crumbcast = Crumbcast( token=os.environ["CRUMBCAST_TOKEN"], base_url="https://your-crumbcast",) # file: a path, an open file, or its bytes# In parts, straight to storage; then encoding startsvideo = crumbcast.upload_video( project_id, "launch.mp4", {"title": "Launch day"}, on_progress=lambda part: show(part.uploaded / part.total),) # Or have Crumbcast fetch it from a linkcrumbcast.videos.import_video( project_id, body={ "url": "https://example.com/launch.mp4", "title": "Launch day", },)use Crumbcast\Crumbcast; $crumbcast = new Crumbcast( token: getenv('CRUMBCAST_TOKEN'), baseUrl: 'https://your-crumbcast',); // $file: a path, an SplFileInfo, or an open stream// In parts, straight to storage; then encoding starts$video = $crumbcast->uploadVideo( $projectId, 'launch.mp4', ['title' => 'Launch day'], onProgress: fn ($part) => show($part->uploaded / $part->total),); // Or have Crumbcast fetch it from a link$crumbcast->videos->importVideo($projectId, [ 'url' => 'https://example.com/launch.mp4', 'title' => 'Launch day',]);curl https://your-crumbcast/api/v1/projects/$PROJECT_ID/videos/import/ \ -H "Authorization: Bearer $CRUMBCAST_TOKEN" \ -H "Content-Type: application/json" \ -d '{"url": "https://example.com/launch.mp4", "title": "Launch day"}'One package for TypeScript, Python and PHP
crumbcast has everything an API token reaches, typed: on npm for Node 20+, Deno, Bun, edge runtimes and browsers, on PyPI for Python 3.11+, sync and async, and on Packagist for PHP 8.1+.
- JavaScript and TypeScript, SDK docs
npm install crumbcast - Python, SDK docs
pip install crumbcast - PHP, SDK docs
composer require crumbcast/crumbcast
- Every call, typedGrouped as the API reference is, each method named after its operation.
- Uploads in one callParts go straight to storage four at a time, each one retried on its own.
- Webhooks checkedOne call checks the signature and turns away deliveries older than 5 minutes.
- Refusals that say whyA CrumbcastError carries the API's reason and status, after 429 and 503 are tried again.
Build with it
Everything Crumbcast does is yours to call: from your backend, from your pages, and back to you when something happens.
From your backend
Videos, uploads, live streams and their numbers, called with a project's API token.
REST API
Everything the dashboard does, from your own code: videos, live streams, captions, players and more, described by an OpenAPI spec.Uploads
Files go from your code straight to storage in parts, side by side, or Crumbcast fetches them from a link.Live streaming
Create a live stream from your code, push to it over RTMP, SRT or WHIP, and play it anywhere.Analytics API
Views, watch time, retention and how it played, for a project, a video or a live broadcast.
Who may watch
Signed links, encrypted files and marked copies, decided by your code.
Signed playback
Your backend decides who may watch: it signs a short-lived token with its own key, and Crumbcast checks it.Encryption
Encrypt a video's files with AES-128 or DRM, their keys handed only to who may watch.Watermarks
Burn your logo into every rendition, and mark each viewer's copy so a leak leads back to them.
On your pages
The player and its progress, in your product's own pages.
Back to you
Your backend hears what happened, and agents do the work through the same rules.