n8n-nodes-ventur

An n8n community node for integrating with the Ventur Business Intelligence API. This node provides seamless access to 10 different API endpoints for comprehensive business intelligence, company research, people profiles, and market analysis.

✨ Features

• 🎯 10 API Endpoints: Access all Ventur API endpoints through a single, intuitive n8n node
• 🔄 Dynamic UI: Input fields dynamically appear based on selected endpoint
• 🔐 Secure Authentication: API key management with password protection
• 💡 Comprehensive Tooltips: Detailed descriptions and guidance for all parameters with examples
• ⚡ Error Handling: Robust error messages and graceful failure handling

📦 Installation

From npm (recommended for production)

npm install @venturhq/n8n-nodes-ventur

From source

1. Clone this repository
2. Install dependencies:

   npm install

3. Build the node:

   npm run build

4. Install in n8n by uploading the built package or using the npm package

Setup

1. Obtain a Ventur API key from Ventur API
2. In n8n, go to Settings > Community Nodes
3. Install the Ventur node
4. Add credentials:
   • API Key: Your Ventur API key
   • Base URL: https://api.venturhq.com (default)

Available Endpoints

Company Snapshot

Get comprehensive company intelligence and profiles

• Input: Company name
• Use case: Detailed company research

People Snapshot

Get detailed person profiles and professional intelligence

• Input: Person name
• Use case: Executive and professional research

Web Search

AI-powered web search with intelligent analysis

• Input: Search query
• Use case: Web research and analysis

Enterprise Company Report

Detailed enterprise-level company analysis

• Inputs: Company name, website, country
• Use case: In-depth enterprise analysis

Discover Companies

Find companies matching specific criteria

• Input: Search criteria
• Use case: Company discovery and lead generation

Customer Feedback

Analyze customer reviews and sentiment

• Input: Company name
• Use case: Customer sentiment analysis

Recruitment Data

Extract job market intelligence and company benefits

• Input: Company name
• Use case: HR and recruitment research

Technology Lookup

Analyze company technology stacks and infrastructure

• Input: Company name
• Use case: Technology stack analysis

Official Records

Access official company registration data

• Input: Company name
• Use case: Legal and registration information

Usage Examples

Company Research Workflow

1. Trigger: Schedule or webhook
2. Ventur Node:
   • Venture Intelligence Endpoint: Company Snapshot
   • Company Name: {{$json.companyName}}
3. Output: Company intelligence data

Advanced Workflow

The node automatically handles complex data structures and provides comprehensive responses from the Ventur API.

Node Parameters

Common Parameters

• Venture Intelligence Endpoint: Select the API endpoint to use

Endpoint-Specific Parameters

Each endpoint has specific input fields with clear labels and examples:

• Company Snapshot: Company Name (e.g., "Monzo Bank")
• People Snapshot: Person Name (e.g., "John Doe")
• Web Search: Search Query
• Enterprise Company Report: Company name, website, and country
• Discover Companies: Search Criteria (e.g., "pre-seed investors in the UK")
• Customer Feedback: Company Name (e.g., "Monzo Bank")
• Recruitment Data: Company Name
• Technology Lookup: Company Name
• Official Records: Company Name (UK companies only)

Error Handling

The node provides clear error messages for:

• Invalid API keys
• Missing required parameters
• API rate limits
• Network issues

Best Practices

• Implement proper error handling in your workflows
• Respect API rate limits
• Store API keys securely using n8n credentials
• Use the specific input fields with provided examples for best results

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

🏢 About Ventur

Ventur is a leading business intelligence platform providing comprehensive company and people data through advanced AI-powered APIs. Our mission is to democratize access to high-quality business intelligence for developers and businesses worldwide.

📞 Support

• Ventur API Documentation: https://docs.venturhq.com
• n8n Community Nodes: https://docs.n8n.io/integrations/community-nodes/
• n8n Forums: https://community.n8n.io/
• Email Support: [email protected]

Built with ❤️ by Ventur HQ Ltd.