n8n-nodes-apiverve

This is an n8n community node that lets you use APIVerve in your n8n workflows.

APIVerve provides 310+ fast, reliable utility APIs for validation, conversion, generation, analysis, and lookup operations. One node, hundreds of APIs.

n8n is a fair-code licensed workflow automation platform.

Table of Contents

• Installation
  • n8n Cloud
  • n8n Desktop
  • Self-hosted n8n (npm)
  • Self-hosted n8n (Docker)
• Credentials
• Operations
• Node Reference
  • API Selection
  • Parameters
  • Options
• Usage Examples
• Response Format
• Error Handling
• Development
  • Prerequisites
  • Local Setup
  • Testing
• Compatibility
• Troubleshooting
• Resources
• Version History
• License

Installation

n8n Cloud

1. Log in to your n8n Cloud instance
2. Go to Settings → Community Nodes
3. Select Install a community node
4. Enter: @apiverve/n8n-nodes-apiverve
5. Agree to the risks and click Install

The node will appear in the nodes panel under APIVerve.

n8n Desktop

1. Open n8n Desktop
2. Go to Settings → Community Nodes
3. Click Install a community node
4. Enter: @apiverve/n8n-nodes-apiverve
5. Click Install
6. Restart n8n Desktop

Self-hosted n8n (npm)

# Navigate to your n8n installation directory
cd /path/to/n8n

# Install the package
npm install @apiverve/n8n-nodes-apiverve

# Restart n8n
pm2 restart n8n
# or
systemctl restart n8n

Self-hosted n8n (Docker)

Add the package to your N8N_CUSTOM_EXTENSIONS environment variable:

# docker-compose.yml
services:
  n8n:
    image: n8nio/n8n
    environment:
      - N8N_CUSTOM_EXTENSIONS=@apiverve/n8n-nodes-apiverve

Or install in a running container:

docker exec -it n8n npm install @apiverve/n8n-nodes-apiverve
docker restart n8n

Credentials

This node uses OAuth2 authentication to securely connect to your APIVerve account.

Setting Up OAuth2

1. Sign up at apiverve.com (free tier includes 100 requests/day)
2. In n8n, go to Credentials → Add Credential
3. Search for APIVerve OAuth2 API
4. Click Sign in with APIVerve to authorize
5. Grant access to your APIVerve account
6. Click Save

Your OAuth2 tokens will be automatically managed and refreshed by n8n.

Operations

The APIVerve node provides a single, dynamic operation that can execute any of the 310+ available APIs:

| Operation | Description | |-----------|-------------| | Execute API | Run any APIVerve API with custom parameters |

APIs are organized into 29 categories including:

• Validation — Email, phone, address, credit card, VAT, domain validation
• Conversion — Currency, units, timezone, file format conversion
• Generation — QR codes, barcodes, passwords, UUIDs, lorem ipsum
• Analysis — Sentiment, language detection, readability, SEO analysis
• Lookup — IP geolocation, DNS, WHOIS, weather, zip codes

Browse all 310+ APIs →

Node Reference

API Selection

| Property | Type | Required | Description | |----------|------|----------|-------------| | API | Dropdown | Yes | Select an API from the dynamically-loaded list. APIs are grouped by category. |

The API list is fetched dynamically when you open the dropdown, ensuring you always have access to the latest APIs.

Parameters

| Property | Type | Required | Description | |----------|------|----------|-------------| | Parameters (JSON) | JSON | No | API parameters as a JSON object. Leave as {} for APIs with no parameters. |

Parameters vary by API. Common parameters include:

• email — Email address for validation APIs
• url — URL for web-related APIs
• text — Text content for analysis APIs
• value — Input value for conversion/generation APIs

See the API documentation for specific parameter requirements.

Usage Example

Validate an Email Address

Configuration:

• API: Email Validator
• Parameters (JSON): {"email": "[email protected]"}

Output:

{
  "status": "ok",
  "error": null,
  "data": {
    "valid": true,
    "email": "[email protected]",
    "domain": "example.com",
    "disposable": false,
    "mx_found": true
  }
}

Response Format

All APIVerve APIs return a consistent response structure:

{
  "status": "ok",
  "error": null,
  "data": {
    // API-specific response data
  }
}

| Field | Type | Description | |-------|------|-------------| | status | string | "ok" for success, "error" for failure | | error | string|null | Error message if status is error, otherwise null | | data | object|null | API response data, null if error |

Alternative Formats

Use the Response Format option to receive data in different formats:

• JSON (default) — application/json
• XML — application/xml
• YAML — application/x-yaml
• CSV — text/csv (for tabular data)

Error Handling

The node handles errors gracefully and provides detailed error information:

| HTTP Status | Error Type | Description | |-------------|------------|-------------| | 400 | Bad Request | Invalid parameters or missing required fields | | 401 | Unauthorized | Invalid or missing API key | | 403 | Forbidden | API access not allowed for your plan | | 404 | Not Found | API endpoint not found | | 429 | Rate Limited | Too many requests, retry after delay | | 500 | Server Error | APIVerve server error |

Error Response Example

{
  "status": "error",
  "error": "Missing required parameter: email",
  "data": null
}

Continue on Fail

Enable Continue on Fail in the node settings to prevent workflow execution from stopping on API errors. The error will be captured in the output for handling in subsequent nodes.

Development

Prerequisites

• Node.js v18.10 or higher
• pnpm (recommended) or npm
• n8n installed locally for testing

Local Setup

1. Clone the repository:

   git clone https://github.com/apiverve/n8n-nodes-apiverve.git
   cd n8n-nodes-apiverve

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

4. Link to your local n8n installation:

   # Create the custom nodes directory if it doesn't exist
   mkdir -p ~/.n8n/nodes
   
   # Create a symlink
   ln -s $(pwd) ~/.n8n/nodes/@apiverve/n8n-nodes-apiverve

5. Start n8n:

   n8n start

Development Mode

Run TypeScript in watch mode during development:

npm run dev

Linting

# Check for issues
npm run lint

# Auto-fix issues
npm run lintfix

Building

npm run build

This compiles TypeScript and copies icons to the dist folder.

Compatibility

| Requirement | Version | |-------------|---------| | n8n | 1.0.0+ | | Node.js | 18.10+ |

This node has been tested with:

• n8n Cloud
• n8n Desktop (Windows, macOS, Linux)
• Self-hosted n8n (npm, Docker)

Troubleshooting

"No options available" in API dropdown

• Verify your API key is correct in the credentials
• Check that your APIVerve account is active
• Ensure you have network access to api.apiverve.com

"Unauthorized" error

• Re-check your API key in the n8n credentials
• Verify the API key is active in your APIVerve Dashboard

"Rate Limited" error

• You've exceeded your plan's request limit
• Wait for the rate limit to reset or upgrade your plan
• Check rate limit headers in the response for reset time

Node not appearing after installation

• Restart n8n completely
• Check the n8n logs for installation errors
• Verify the package is in node_modules

Need help?

• APIVerve Documentation
• GitHub Issues
• n8n Community Forum

Resources

| Resource | Link | |----------|------| | APIVerve Website | apiverve.com | | API Documentation | docs.apiverve.com | | API Dashboard | dashboard.apiverve.com | | Browse All APIs | apiverve.com/marketplace | | n8n Documentation | docs.n8n.io | | n8n Community Nodes | docs.n8n.io/integrations/community-nodes |

Version History

| Version | Date | Changes | |---------|------|---------| | 1.0.0 | 2025-12-19 | Initial release with 310+ APIs |

License

MIT

Copyright (c) 2025 EvlarSoft LLC and APIVerve