VidContext + n8n

Add video intelligence to your n8n workflows. Use the HTTP Request node to send videos to VidContext and get structured analysis back — transcripts, visual breakdowns, brand detection, and more. No code required.

How it works

  1. 1

    Add an HTTP Request node

    Drag an HTTP Request node into your n8n workflow. Set the method to POST and the URL to the VidContext analyze endpoint.

  2. 2

    Configure authentication

    Add a Header Auth credential with the name X-API-Key and your VidContext API key as the value.

  3. 3

    Attach the video

    Set the body to Form-Data. Add a file field pointing to your video file or a source field with a video URL, plus an output_format field for the analysis mode.

  4. 4

    Route the results

    The response arrives as structured JSON. Connect downstream nodes to store results, send notifications, or trigger further automation.

HTTP Request node configuration

Paste this JSON into an n8n HTTP Request node to get a working VidContext analysis step. Replace the API key with your own.

{
  "method": "POST",
  "url": "https://api.vidcontext.com/v1/analyze",
  "authentication": "genericCredentialType",
  "genericAuthType": "httpHeaderAuth",
  "sendHeaders": true,
  "headerParameters": {
    "parameters": [
      { "name": "X-API-Key", "value": "vc_your_key_here" }
    ]
  },
  "sendBody": true,
  "contentType": "multipart-form-data",
  "bodyParameters": {
    "parameters": [
      { "name": "file", "parameterType": "formBinaryData", "inputDataFieldName": "data" },
      { "name": "output_format", "value": "context" }
    ]
  }
}

Workflow ideas

Watch folder and log results

Trigger on new files in Google Drive or S3. Download the video, send it to VidContext, then write the analysis to a Google Sheet or Airtable base. Great for teams that receive video assets regularly.

Webhook to Slack alerts

Set up a webhook that receives a video URL. Download the file, analyze it with VidContext, then post a summary to a Slack channel. Use this for real-time content monitoring.

Scheduled competitor analysis

Run a cron trigger daily. Fetch the latest videos from competitor YouTube channels using the YouTube node, download each video, analyze with the competitor output mode, and store trends over time.

UGC quality scoring

When users upload content, route it through VidContext with the ugc output mode. Auto-approve videos that score above your threshold, and flag low-scoring submissions for manual review.

What VidContext returns

Every analysis returns structured JSON that n8n can parse directly. No custom code needed to extract fields.

  • Metadata — duration, resolution, format
  • Transcript — timestamped speech with speaker context
  • Visual scenes — frame-by-frame descriptions of what appears on screen
  • On-screen text — every title, caption, URL, and overlay extracted
  • Brands detected — logos and product mentions identified
  • Audio analysis — music, sound effects, and ambient audio classified

Frequently asked questions

Do I need to write code to use VidContext with n8n?

No. You configure the HTTP Request node visually in n8n. Set the URL, add your API key as a header, attach the video file, and n8n handles the rest. The response comes back as JSON that you can route to any downstream node.

How do I get a VidContext API key?

Sign up at vidcontext.com/app, then go to the Developer page in your dashboard. You get one free API key immediately. Paid plans allow up to 5 keys.

What is the maximum video size I can send?

Authenticated users can send videos up to 500 MB and 15 minutes long. A typical 3-minute video processes in about 50 seconds.

Can I process videos from URLs instead of file uploads?

Yes. Instead of uploading a file, pass a source field with a direct URL to the video. VidContext downloads and processes it the same way.

How much does each analysis cost?

VidContext charges $0.20 per minute of video. All analysis features are included in every request — no per-feature billing. You get 20 free credits when you sign up.

Start building

Get your API key and connect VidContext to n8n in under 5 minutes. 20 free credits on signup.

Get API key