Skip to main content
Connect Valyu to an n8n workflow: receive a query, retrieve sources or run research, then send the result to your next node.

​
Getting Started

​
Step 1: Get Your Valyu API Key

Before you can use the Valyu node, you need an API key:
  1. Go to platform.valyu.ai and create a free account
  2. Navigate to API Keys in the dashboard
  3. Click Create API Key and copy your new key

​
Step 2: Install the Valyu Node in n8n

These installation steps are for self-hosted n8n. Community-node availability on n8n Cloud depends on verification and workspace policy; check n8n’s current supported nodes before choosing that route.
To install the node:
  1. In your n8n instance, go to Settings (gear icon in the bottom left)
  2. Click on Community Nodes
  3. Click Install
  4. Enter the package name: n8n-nodes-valyu
  5. Check the box to accept the risks of installing community nodes
  6. Click Install
That’s it! The Valyu node will now appear when you search for “Valyu” in the nodes panel.

​
Step 3: Set Up Your Credentials

Before using the Valyu node, you need to add your API key:
  1. Drag a Valyu node onto your canvas
  2. Click on the node to open it
  3. Next to Credential to connect with, click the dropdown and select Create New Credential
  4. In the popup:
    • API Key: Paste your Valyu API key from Step 1
    • API URL: Leave as the default (https://api.valyu.ai/v1)
  5. Click Save
Your credentials are now saved and will be available for all Valyu nodes in your workflows.

​
Using the Valyu Node

Use Search when you need to find information from across the web and premium data sources. Basic usage:
  1. Select Search as the operation
  2. Enter your search query (e.g., “latest developments in quantum computing”)
  3. Run the node
Optional settings (click “Add Option” to see these):
  • Search Type: Choose between All, Web only, Proprietary (academic/financial), or News
  • Max Results: How many results to return (1-20; higher limits require account access)
  • Response Length: How much content per result (Short, Medium, Large, Max)
  • Date filters: Only get results from a specific time period

​
Extraction

Use Extraction when you have specific URLs and want to pull out their content. Basic usage:
  1. Select Extraction as the operation
  2. Enter one or more URLs (comma-separated)
  3. Choose a Summary Mode:
    • No AI Processing: Just get the raw text content
    • Auto Summary: Get an AI-generated summary
    • Custom Prompt: Tell the AI exactly what to extract
    • Structured Output: Extract data into a specific JSON format

​
Deep Research

Use Deep Research for thorough, comprehensive research that might take several minutes but produces detailed reports. Basic usage:
  1. Select Deep Research as the operation
  2. Enter your research query
  3. Choose a Mode:
    • Standard: For balanced research questions
    • Heavy: For complex, multi-faceted topics
The node will wait for the research to complete and return the full report.

​
Example Workflows

​
Automated News Digest

Create a daily digest of news on topics you care about:
  1. Schedule Trigger → Runs every morning at 8am
  2. Valyu (Search) → Search for “AI news” with News search type
  3. Send Email → Email yourself the top stories

​
Website Content Monitor

Track changes to competitor websites:
  1. Schedule Trigger → Runs weekly
  2. Valyu (Extraction) → Extract content from competitor URLs
  3. Compare → Check against previous extraction
  4. Slack → Notify if changes detected

​
Research Assistant

Build a research pipeline for market analysis:
  1. Webhook Trigger → Receive research requests
  2. Valyu (Deep Research) → Run comprehensive research
  3. Google Sheets → Save report to a spreadsheet
  4. Slack → Notify when complete with link to report

​
Troubleshooting

Try restarting your n8n instance. If using Docker, restart the container.
Double-check your API key is correct. Make sure there are no extra spaces when you paste it.
Check the selected mode’s expected duration and configure the workflow timeout accordingly. A workflow timeout does not necessarily cancel the remote research task. Retain the task ID so you can check its status before submitting another task.
If you’re hitting rate limits, add a small delay between Valyu node executions using the Wait node.

​
Resources

npm Package

View the package on npm

GitHub Repository

Source code and issues

n8n Community Nodes Docs

Official n8n documentation on installing community nodes

Valyu Discord

Get help from the community