NetraFlow

Introduction

NetraFlow is a video analysis API. Submit a URL, get structured data back.

NetraFlow extracts structured intelligence from video. Send a YouTube, TikTok, or Instagram URL — or upload your own file — and receive transcriptions, summaries, brand detections, and video metadata, all returned as clean JSON.

How it works

Client                    NetraFlow API              Worker Pipeline
  │                            │                           │
  ├─POST /v1/jobs─────────────►│                           │
  │  { url, capabilities }     │                           │
  │◄──── 202 Accepted ─────────┤                           │
  │  { job_id, status:"pending"}│                           │
  │                            ├──Queue job───────────────►│
  │                            │                           │
  │                            │    Ingest → Transcribe    │
  │                            │    → Analyze → Merge      │
  │                            │                           │
  ├─GET /v1/jobs/:id──────────►│                           │
  │◄──── 200 OK ───────────────┤                           │
  │  { status:"completed",     │                           │
  │    results: {...} }        │                           │

You can also receive results via webhooks instead of polling.

Base URL

https://api.netraflow.com

All API requests require an API key passed via the X-Api-Key header. Keys start with sk_live_ — never commit them to public repositories.

Supported platforms

PropTypeDescription
youtubestringYouTube videos and shorts
tiktokstringTikTok videos
instagramstringInstagram reels and video posts
uploadstringYour own video files, uploaded directly

Capabilities

PropTypeDescription
transcriptionSpeech-to-text. Returns full text, timed segments, and word-level timings.
summaryAI-generated summary with key topics extracted from the video.
brandsDetect brand appearances on screen, in speech, and in video metadata, with timestamps.
metadataThe video's own title, description, tags, and engagement counts.

You can also ask free-form questions about a video with queries, alongside any capability.

On this page