Skip to main content

​
Overview

The ChatAds n8n node lets you add affiliate links to your automated workflows. Use it with chatbots, email automations, content generation, and any workflow that processes user messages.

​
Installation

npm install n8n-nodes-chatads
Then restart n8n to load the new node.

​
Option 2: Manual Installation

  1. Download the node package
  2. Copy to your n8n custom nodes directory (~/.n8n/custom/)
  3. Restart n8n

​
Configuration

​
Credentials Setup

  1. In n8n, go to Credentials → New
  2. Search for “ChatAds API”
  3. Enter your credentials:
FieldValue
API KeyYour key from getchatads.com
Base URLhttps://api.getchatads.com
Store your API key securely. Never expose it in client-side code or commit it to version control.

​
Node Parameters

​
Required

​
message
string
required
The user message to analyze. Must be 1-5000 characters.

​
Optional

​
ip
string
IPv4/IPv6 address for country detection (max 45 characters).
​
country
string
Country code (e.g., ‘US’). If provided, skips IP-based country detection.
​
quality
string
default:"standard"
Variable for playing around with keyword quality, link accuracy, and response times. ‘fast’ = quickest, but less likely to find a working affiliate link (~150ms), ‘standard’ = strong keyword quality and decent link matching (~1.4s), ‘best’ = strong keyword and strong matching (~2.5s).

​
Advanced Settings

​
endpoint
string
default:"/v1/chatads/messages"
API endpoint path (for custom deployments).
​
maxConcurrency
number
default:"4"
Maximum parallel requests (1-50). Increase for high-throughput workflows.
​
timeoutSeconds
number
default:"30"
HTTP request timeout in seconds (5-300).

​
Input Modes

The node supports two input modes:

​
GUI Mode (Default)

Configure each parameter individually using n8n’s form interface. Good for simple workflows and visual configuration.

​
JSON Mode

Pass a complete request payload as JSON. Enable by toggling “JSON Parameters” in the node settings: 
{
  "message": "What's the best yoga mat for beginners?",
  "country": "US",
  "quality": "standard"
}
Use JSON mode for:
  • Dynamic payloads from expressions
  • Complex configurations
  • Copying requests from API Explorer

​
Response

The node outputs the full ChatAds API response: 
{
  "data": {
    "status": "partial_fill",
    "offers": [
      {
        "link_text": "yoga mat",
        "url": "https://amazon.com/...",
        "confidence_level": "high"
      }
    ],
    "requested": 2,
    "returned": 1
  },
  "error": null,
  "meta": {
    "request_id": "abc-123",
    "usage": {
      "monthly_requests": 50,
      "daily_requests": 10
    }
  }
}
Access response fields using expressions: 
{{ $json.data.offers[0].url }}
{{ $json.data.offers[0].link_text }}
{{ $json.data.returned > 0 }}
{{ $json.data.returned }}

​
Workflow Examples

​
AI Chatbot with Affiliates

Add affiliate links to AI responses:
1

Trigger

Webhook receives user message
2

ChatAds Node

Analyze message for product keywords
3

IF Node

Check {{ $json.data.returned > 0 }}
4

OpenAI Node

Generate response with affiliate link in prompt:
Include this product recommendation if relevant:
{{ $json.data.offers[0].link_text }} - {{ $json.data.offers[0].url }}
5

Response

Return AI response to user

​
Email Product Mentions

Scan emails for product mentions: 
Trigger: Gmail (new email)
  → ChatAds (analyze email body)
  → IF (returned > 0)
    → Slack (notify with affiliate opportunity)

​
Content Generation Pipeline

Enrich generated content with affiliate links: 
Trigger: Schedule
  → HTTP Request (fetch content topics)
  → ChatAds (find affiliate for each topic)
  → Merge (combine content + affiliate)
  → WordPress (publish with affiliate links)

​
Error Handling

Enable “Continue on Fail” to handle errors gracefully:
  1. Click the ChatAds node
  2. Go to Settings
  3. Enable Continue on Fail
Failed items will pass through with error data: 
{
  "error": {
    "message": "Daily quota exceeded",
    "httpCode": 429
  }
}
Use an IF node to route errors: 
{{ $json.error ? 'Error' : 'Success' }}

​
Best Practices

Use expressions for dynamic messages

{{ $json.userMessage }}
Pull messages from previous nodes instead of hardcoding.

Handle no-match cases

Always check data.returned > 0 before using affiliate data. Design workflows for both matched and unmatched scenarios.

Set appropriate concurrency

Increase maxConcurrency for batch processing. Keep it low (4-8) for real-time chatbots.

Monitor usage

Check meta.usage in responses to track quota consumption.

​
Troubleshooting

​
Node Not Appearing

  1. Ensure the package is installed: npm list n8n-nodes-chatads
  2. Restart n8n completely (not just refresh)
  3. Check n8n logs for load errors

​
Authentication Errors

  • Verify API key starts with cak_
  • Check credentials are saved (not just entered)
  • Test key with curl first

​
Timeout Errors

Increase timeoutSeconds in Advanced Settings for:
  • Complex queries with thorough analysis
  • Network latency issues
  • High-traffic periods

​
Rate Limit Errors

  • Lower maxConcurrency to spread requests
  • Add a Wait node between batches
  • Upgrade plan for higher limits