Getting Started
Quickstart
This guide will help you get started with InsightStream by uploading your first video using our API and embedding the player into your application.
1. Get your API Key
Log in to your InsightStream dashboard and navigate to Settings > API Keys. Create a new secret key for your project.
Terminal
export INSIGHTSTREAM_API_KEY="sk_live_51P..."
2. Upload a Video
Use our upload endpoint to send your video file. We support TUS for resumable uploads, but for this quickstart, we'll use a simple POST request.
cURL
curl -X POST "https://api.is.io/v2/upload" \
-H "Authorization: Bearer $INSIGHTSTREAM_API_KEY" \
-F "file=@my_video.mp4"
3. Wait for Transcoding
Once the upload is complete, we'll start transcoding your video. You can poll the status or set up a webhook to be notified when it's ready.
Response
{
"id": "vid_38402122",
"status": "processing",
"hls_url": "https://cdn.is.io/play/vid_38402122"
}
4. Embed the Player
Use our React component to embed the player in your application.
React
import { InsightPlayer } from '@insightstream/react';
// Usage
<InsightPlayer assetId="vid_38402122" />
Tip: Check out our SDKs section for more advanced integration options including DRM protection and custom analytics.
Updated on Dec 28, 2025
Was this page helpful?