Quickstart
Submit your first video analysis in under a minute.
Your API key (sk_live_...) is a secret. Store it in environment variables — never commit it to version control.
1. Get an API key
Sign up at netraflow.com, create a workspace, and generate an API key from the dashboard.
2. Submit a video
curl -X POST https://api.netraflow.com/v1/jobs \
-H "Content-Type: application/json" \
-H "X-Api-Key: sk_live_your_key_here" \
-d '{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"capabilities": ["transcription", "summary"]
}'{
"data": {
"job_id": "job_abc123",
"status": "pending",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"platform": "youtube",
"capabilities": ["transcription", "summary"],
"credits_estimated": 5,
"return_proof": false,
"created_at": "2026-04-03T12:00:00.000Z"
},
"meta": { "request_id": "req_xyz789" }
}3. Retrieve results
Poll the job until status is "completed", or use webhooks for async delivery.
curl https://api.netraflow.com/v1/jobs/job_abc123 \
-H "X-Api-Key: sk_live_your_key_here"{
"data": {
"job_id": "job_abc123",
"status": "completed",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"platform": "youtube",
"capabilities": ["transcription", "summary"],
"credits_estimated": 5,
"credits_charged": 3,
"results": {
"transcription": {
"text": "We're no strangers to love, you know the rules...",
"segments": [
{ "start": 0.0, "end": 4.8, "text": "We're no strangers to love" },
{ "start": 4.8, "end": 8.2, "text": "You know the rules and so do I" }
],
"language": "en",
"duration_seconds": 212.0,
"word_count": 423
},
"summary": {
"text": "A music video for Rick Astley's 1987 hit 'Never Gonna Give You Up', featuring Astley performing the song with choreographed dance sequences in various urban locations.",
"key_topics": ["music video", "Rick Astley", "pop music"]
}
},
"return_proof": false,
"created_at": "2026-04-03T12:00:00.000Z",
"completed_at": "2026-04-03T12:00:38.000Z"
},
"meta": { "request_id": "req_abc456" }
}Next steps
- API Reference — Full endpoint documentation
- Capabilities — Detailed capability schemas
- Webhooks — Receive results without polling