0.2.2 • Published 6d ago

n8n-nodes-vidiq

Licence

MIT

Version

0.2.2

Deps

Size

374 kB

Vulns

Weekly

399

Summary Dependency Versions

n8n-nodes-vidiq

An n8n community node for vidIQ — bring YouTube & Instagram intelligence and vidIQ's AI content tools into your workflows: keyword research, video outliers, channel/video analytics, competitor discovery, trend analysis, plus AI title & thumbnail scoring/generation, voiceover, and video generation.

Unofficial. This is a community-built node and is not affiliated with, endorsed by, or supported by vidIQ. "vidIQ" is a trademark of its respective owner.

How it works

vidIQ does not expose a traditional REST API. Its supported, API-key-authenticated programmatic surface is its MCP server (https://mcp.vidiq.com/mcp). This node speaks that protocol for you and presents clean, typed n8n operations — you never see MCP.

Requires a vidIQ "Max" plan. The API/MCP surface is only available on vidIQ's Max plan.

Generative operations consume vidIQ credits. Anything under the Studio & AI resource (title/thumbnail generation, video, clips, voiceover, b-roll) spends credits. Check your balance with Account → Get Credit Balance before running them at scale.

npm install n8n-nodes-vidiq

Credentials

On a vidIQ Max plan, generate an API key (vidIQ → MCP / API access). It looks like vidiq_xxxxxxxxxxxxxxxxxxxxxxxxx.
In n8n, create a VidIQ API credential and paste the key. The credential test calls vidiq_balance; an invalid key returns 401 and the test fails.

The node sends the key as Authorization: Bearer <key>.

Resources & operations (40 operations)

Resource	Operations
Keyword	Research
Trend	Trending Videos · Video Outliers · Categories
Channel	Get Stats · Search · Get Many by IDs · Get Videos · Get Performance Trends · Analytics · Find Similar · Find Breakout · Get My Channels
Video	Get Many by IDs · Search YouTube · Stats History · Transcript · Comments · Analyze
Studio & AI	Score Title · Score Thumbnail · Generate Titles · Generate Thumbnail · Refine Thumbnail · Generate Video · Generate Clips · Compose · Find B-Roll · List Voices · Generate Voiceover · Clone Voice (Upload) · Clone Voice From YouTube
Instagram	Get Profile · Profile Reels · Find Outlier Reels · Accounts From Outliers · Analyze Reel
Account	Get Credit Balance
Job	Get Job Status · List Jobs

Notes & patterns

IDs over URLs. Video ID, Reel, and channel IDs accept a bare ID/shortcode (a full URL also works — vidIQ normalizes it), so you won't get errors from a missing www. or a trailing slash.
Channel Analytics. The Channel field is a dropdown of your vidIQ-linked channels (analytics are only available for channels you own). Dates use YYYY-MM-DD; metrics is a multi-select.
Async renders (Studio & AI). Generate Video, Generate Clips, Compose, the thumbnail generators and Clone Voice From YouTube run asynchronously and return a job object containing an mcpJobId. Poll it with Job → Get Job Status. For long renders, loop with n8n's Wait node
- an IF node until the status is completed (or failed/expired). (n8n Cloud does not allow nodes to block while waiting, so the node does not poll internally.)
Binary I/O. Image/audio inputs (thumbnail scoring/generation, voice cloning, video frames) accept a URL or an n8n Binary Property via each field's Input Type selector. Generate Voiceover with output URL and Audio returns the MP3 as a downloadable binary attachment.
Timeout. Every operation has an Options → Timeout (ms) setting so a stalled request fails fast instead of hanging.
Credits. Read/analytics operations are cheap; generative Studio & AI operations cost more (each is labelled "Consumes vidIQ credits"). Watch Account → Get Credit Balance.
Use as an AI tool. The node is exposed as an n8n AI tool (usableAsTool), so an AI Agent can call vidIQ operations directly.

Compatibility

Built with @n8n/node-cli in strict mode (verified-node ruleset), zero runtime dependencies.
Requires n8n with n8nNodesApiVersion: 1.

Development

npm install
npm run build      # compile to dist/
npm run lint       # n8n strict verification lint
npm test           # offline unit tests (vitest)
VIDIQ_API_KEY=vidiq_... npm run smoke   # optional live read-only smoke test