API & Ingest

OpenAPI 3.0

Interactive documentation and client generation for any language. Explore, test, and integrate directly from the spec.

S3-compatible upload

Presigned multipart uploads with resume capability. Upload files of any size directly from your application.

Event-driven webhooks

Real-time notifications for upload, transcoding, AI processing, and status changes. Build reactive workflows without polling.

Integration workflow

Authenticate

Obtain an OAuth 2.0 token with your client credentials

Upload

Request a presigned URL and upload your media file via S3-compatible PUT

Process

Streamdiver transcodes, transcribes, and extracts metadata automatically

Embed or retrieve

Embed the player widget or query AI results via the REST API

Built for developers

OpenAPI 3.0 specification with interactive documentation

OAuth 2.0 with server and client credentials

S3-compatible multipart upload with resume

Webhooks for all processing lifecycle events

JSON responses for all AI results and metadata

Rate limiting with transparent headers

Pagination and filtering on all list endpoints

Cookie-free embeddable widgets via Web Component

Semantic search and RAG across all media

AI Flows API with SSE streaming

From zero to production

Upload, process, and embed in minutes

Three API calls are all it takes: upload a video, wait for the webhook, and embed the result. Here is the complete flow.

S3-Compatible Upload

Presigned URLs with multipart support and resume capability for files of any size.

REST API

Full control over assets, channels, metadata, AI results, and player configurations.

Webhooks

Real-time notifications for upload, transcoding, AI processing, and status changes.

Full-Text & Semantic Search

Search across transcripts, entities, and metadata by keyword or natural language.

9 Widget Types

Player, media library, slider, and more – embed cookie-free via Web Component.

AI Flows

Parameterised AI workflows via REST – summaries, reports, and content generation streamed via SSE.

# 1. Start upload
curl -X POST https://api.streamdiver.com/v2/uploads \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "video.mp4", "type": "put"}'

# 2. Upload file to presigned URL (S3-compatible)
curl -X PUT "$PRESIGNED_URL" -T video.mp4

# 3. Complete upload and assign to channel
curl -X PUT "https://api.streamdiver.com/v2/uploads/$UPLOAD_ID/complete?channelId=$CHANNEL_ID" \
  -H "Authorization: Bearer $TOKEN"

# 4. Query asset status
curl https://api.streamdiver.com/v2/media/$ASSET_ID \
  -H "Authorization: Bearer $TOKEN"

Integration flow

Get tokenOAuth 2.0

Upload videoS3 presigned URL

Receive webhookProcessing complete

Embed or queryWidget SDK or REST API

Ready to get started?

Schedule Demo Open API Reference