n8n Integration
Build powerful, self-hosted automation workflows with Venym Search and n8n. Create custom nodes, deploy on your own infrastructure, and maintain full control over your data.
Custom Venym Search Nodes
Pre-built nodes for all Venym Search APIs
Drag-and-drop interface
Built-in error handling
Parameter validation
Self-hosted Freedom
Full control over your automation infrastructure
Deploy on your own servers
Complete data privacy
Custom modifications
No vendor lock-in
Developer Community
Open-source community and extensibility
Active community support
Custom node development
Regular updates
Free forever
What you'll build
Self-hosted automation workflows that search the web, scrape content, conduct research, and integrate with your existing tools - all with complete control over your data and infrastructure.
Setup Instructions
01
Install n8n with Docker
Deploy n8n with Docker for easy setup and scalability. This configuration includes custom node support.
docker-compose.ymlYAML
version: '3.8'
services:
n8n:
image: docker.n8n.io/n8nio/n8n
restart: always
ports:
- "5678:5678"
environment:
- N8N_BASIC_AUTH_ACTIVE=true
- N8N_BASIC_AUTH_USER=admin
- N8N_BASIC_AUTH_PASSWORD=your_password_here
- N8N_HOST=localhost
- N8N_PORT=5678
- N8N_PROTOCOL=http
- WEBHOOK_URL=http://localhost:5678/
# Custom nodes path
- N8N_CUSTOM_EXTENSIONS=/home/node/custom-nodes
volumes:
- n8n_data:/home/node/.n8n
# Mount custom Venym Search nodes
- ./custom-nodes:/home/node/custom-nodes
networks:
- n8n-network
# Optional: PostgreSQL for production
postgres:
image: postgres:13
restart: always
environment:
- POSTGRES_USER=n8n
- POSTGRES_PASSWORD=n8n_password
- POSTGRES_DB=n8n
volumes:
- postgres_data:/var/lib/postgresql/data
networks:
- n8n-network
volumes:
n8n_data:
postgres_data:
networks:
n8n-network:
driver: bridgeQuick Start Commands:
docker-compose up -dopen http://localhost:567802
Install Venym Search Nodes
Install the custom Venym Search nodes for seamless integration with all APIs.
Option A: Community Package
Install from n8n community package registry.
npm install n8n-nodes-VENYM_SEARCHOption B: Manual Installation
Clone and build the nodes yourself.
WARNING
Custom nodes require n8n restart after installation. Make sure to restart your n8n instance to load the new Venym Search nodes.
03
Configure Venym Search Credentials
Set up your Venym Search API credentials in n8n for secure authentication.
Credentials Setup:
- Go to n8n Settings → Credentials
- Click "Create New" → "Venym Search API"
- Enter your Venym Search API key
- Test the connection
- Save for use across all workflows
Custom Node Development
Learn how to create and customize Venym Search nodes for n8n to fit your specific use cases.
Venym Search Node Structure
Venym Search Search Node ImplementationTypeScript
// Venym Search Search Node Structure
export class VenymSearchSearch implements INodeType {
description: INodeTypeDescription = {
displayName: 'Venym Search Search',
name: 'searchHiveSearch',
icon: 'file:VENYM_SEARCH.svg',
group: ['input'],
version: 1,
subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
description: 'Interact with Venym Search Search API',
defaults: {
name: 'Venym Search Search',
},
inputs: ['main'],
outputs: ['main'],
credentials: [
{
name: 'searchHiveApi',
required: true,
},
],
properties: [
{
displayName: 'Query',
name: 'query',
type: 'string',
default: '',
placeholder: 'Enter search query',
description: 'The search query to execute',
required: true,
},
{
displayName: 'Max Results',
name: 'maxResults',
type: 'number',
default: 10,
description: 'Maximum number of results to return',
},
{
displayName: 'Auto Scrape',
name: 'autoScrape',
type: 'boolean',
default: false,
description: 'Whether to automatically scrape result pages',
},
{
displayName: 'Extract Contacts',
name: 'extractContacts',
type: 'boolean',
default: false,
description: 'Whether to extract contact information',
}
],
};
async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
const items = this.getInputData();
const returnData: INodeExecutionData[] = [];
for (let i = 0; i < items.length; i++) {
try {
const query = this.getNodeParameter('query', i) as string;
const maxResults = this.getNodeParameter('maxResults', i) as number;
const autoScrape = this.getNodeParameter('autoScrape', i) as boolean;
const extractContacts = this.getNodeParameter('extractContacts', i) as boolean;
const credentials = await this.getCredentials('searchHiveApi');
const options: OptionsWithUri = {
method: 'POST',
uri: 'https://www.search.venym.io/api/v1/search',
headers: {
'Authorization': 'Bearer ' + credentials.apiKey,
'Content-Type': 'application/json',
},
body: {
query,
max_results: maxResults,
auto_scrape: autoScrape,
extract_contacts: extractContacts,
},
json: true,
};
const response = await this.helpers.request(options);
returnData.push({
json: response,
pairedItem: { item: i },
});
} catch (error) {
if (this.continueOnFail()) {
returnData.push({
json: { error: error.message },
pairedItem: { item: i },
});
} else {
throw error;
}
}
}
return [returnData];
}
}Credentials Configuration
Venym Search API CredentialsTypeScript
// Venym Search API Credentials
export class VenymSearchApi implements ICredentialType {
name = 'searchHiveApi';
displayName = 'Venym Search API';
documentationUrl = 'https://docs.VENYM_SEARCH.com';
properties: INodeProperties[] = [
{
displayName: 'API Key',
name: 'apiKey',
type: 'string',
typeOptions: { password: true },
default: '',
description: 'Your Venym Search API key',
required: true,
},
{
displayName: 'Base URL',
name: 'baseUrl',
type: 'string',
default: 'https://www.search.venym.io/api',
description: 'Base URL for Venym Search API',
},
];
authenticate: IAuthenticateGeneric = {
type: 'generic',
properties: {
headers: {
'Authorization': 'Bearer {{$credentials.apiKey}}',
},
},
};
test: ICredentialTestRequest = {
request: {
baseURL: '={{$credentials.baseUrl}}',
url: '/v1/search',
method: 'POST',
body: {
query: 'test',
max_results: 1,
},
},
};
}Node Development Resources
Download the complete Venym Search node package
Follow n8n's node development documentation
Join the n8n community for support and collaboration
Contribute improvements back to the community
Available Venym Search Nodes
Search Node
Enhanced web search with real-time results.
Real-time search results
Auto-scraping options
Contact extraction
Social discovery
Scrape Node
Extract content from any webpage or document.
Text and metadata extraction
Image and link discovery
JavaScript rendering
Custom selectors
Research Node
AI-powered research and analysis automation.
Multi-source research
Trend analysis
Content summarization
Sentiment analysis
Complete Workflow Example
Here's a complete n8n workflow that demonstrates automated lead generation using Venym Search nodes.
Lead Generation WorkflowJSON
{
"name": "Venym Search Lead Generation Workflow",
"nodes": [
{
"parameters": {
"rule": {
"interval": [
{
"field": "hours",
"triggerAtHour": 9
}
]
}
},
"id": "f6e1ca5b-1853-4b11-8a81-9a5c7e5e5f52",
"name": "Schedule Trigger",
"type": "n8n-nodes-base.scheduleTrigger",
"typeVersion": 1.1,
"position": [250, 300]
},
{
"parameters": {
"query": "{{$('Set Search Terms').item.json.searchQuery}}",
"maxResults": 20,
"extractContacts": true
},
"id": "8a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p",
"name": "Venym Search Search",
"type": "searchHiveSearch",
"typeVersion": 1,
"position": [450, 300],
"credentials": {
"searchHiveApi": {
"id": "1",
"name": "Venym Search API Key"
}
}
},
{
"parameters": {
"values": {
"searchQuery": "construction companies Seattle",
"industry": "construction",
"location": "Seattle"
}
},
"id": "1a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p",
"name": "Set Search Terms",
"type": "n8n-nodes-base.set",
"typeVersion": 3.2,
"position": [650, 300]
},
{
"parameters": {
"conditions": {
"options": {
"caseSensitive": true,
"leftValue": "",
"typeValidation": "strict"
},
"conditions": [
{
"id": "f1e2d3c4-b5a6-9788-3c4d-5e6f7g8h9i0j",
"leftValue": "={{$json.contact_info.email}}",
"rightValue": "",
"operator": {
"type": "string",
"operation": "exists",
"singleValue": true
}
}
],
"combinator": "and"
}
},
"id": "2b3c4d5e-6f7g-8h9i-0j1k-2l3m4n5o6p7q",
"name": "Filter Valid Contacts",
"type": "n8n-nodes-base.filter",
"typeVersion": 2,
"position": [850, 300]
},
{
"parameters": {
"resource": "contact",
"operation": "create",
"properties": {
"email": "={{$json.contact_info.email}}",
"company": "={{$json.title}}",
"website": "={{$json.link}}",
"phone": "={{$json.contact_info.phone}}",
"industry": "={{$('Set Search Terms').item.json.industry}}",
"location": "={{$('Set Search Terms').item.json.location}}"
}
},
"id": "3c4d5e6f-7g8h-9i0j-1k2l-3m4n5o6p7q8r",
"name": "Add to CRM",
"type": "n8n-nodes-base.hubspot",
"typeVersion": 2,
"position": [1050, 300]
},
{
"parameters": {
"channel": "#sales",
"text": "🎯 New leads found: {{$('Filter Valid Contacts').item.json.length}} companies in {{$('Set Search Terms').item.json.industry}} industry"
},
"id": "4d5e6f7g-8h9i-0j1k-2l3m-4n5o6p7q8r9s",
"name": "Slack Notification",
"type": "n8n-nodes-base.slack",
"typeVersion": 2.1,
"position": [1250, 300]
}
],
"connections": {
"Schedule Trigger": {
"main": [
[
{
"node": "Set Search Terms",
"type": "main",
"index": 0
}
]
]
},
"Set Search Terms": {
"main": [
[
{
"node": "Venym Search Search",
"type": "main",
"index": 0
}
]
]
},
"Venym Search Search": {
"main": [
[
{
"node": "Filter Valid Contacts",
"type": "main",
"index": 0
}
]
]
},
"Filter Valid Contacts": {
"main": [
[
{
"node": "Add to CRM",
"type": "main",
"index": 0
}
]
]
},
"Add to CRM": {
"main": [
[
{
"node": "Slack Notification",
"type": "main",
"index": 0
}
]
]
}
}
}Workflow Features
Scheduled execution
Contact extraction and filtering
CRM integration
Team notifications
Deployment Options
Self-hosted on your servers
Docker container deployment
Kubernetes orchestration
Team collaboration features
Self-hosting Benefits
Data Privacy & Control
All data stays on your infrastructure
No third-party data sharing
GDPR and compliance friendly
Custom security configurations
Cost & Performance
No per-execution fees
Unlimited workflow executions
Scale based on your needs
Optimize for your workloads
Start Building
Ready to build self-hosted automation? Get your Venym Search API key and deploy n8n.