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
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
Configure authentication
Add a Header Auth credential with the name X-API-Key and your VidContext API key as the value.
- 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
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