NetraFlow

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

On this page