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.

Installation

n8n Cloud / Desktop (Community Nodes)

Settings → Community Nodes → Install, then enter n8n-nodes-vidiq.

Self-hosted (npm)

npm install n8n-nodes-vidiq

Credentials

1. On a vidIQ Max plan, generate an API key (vidIQ → MCP / API access). It looks like
   vidiq_xxxxxxxxxxxxxxxxxxxxxxxxx.
2. 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)

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

Design notes: docs/superpowers/specs/2026-06-19-n8n-nodes-vidiq-design.md.

License

MIT