n8n-nodes-qwairy

This is an n8n community node for Qwairy - AI Brand Visibility & Monitoring Platform.

Qwairy tracks your brand's presence across AI platforms like ChatGPT, Claude, Perplexity, Gemini and more.

n8n is a fair-code licensed workflow automation platform.

Compatibility

• n8n version: 1.0.0 or later
• Qwairy plan: Business or Enterprise (API access required)

Installation

Follow the installation guide in the n8n community nodes documentation.

npm install n8n-nodes-qwairy

Or in n8n:

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-qwairy
4. Click Install

Prerequisites

• Qwairy Business plan or higher (API access is a Business feature)
• API Key from your Qwairy workspace settings

Operations

Brand

• Get: Retrieve details of a specific brand
• Get Many: List all brands in your team

Answer

• Get: Retrieve a specific AI-generated answer
• Get Many: List all answers for a brand (with filtering)

Prompt

• Get: Retrieve a specific monitoring prompt
• Get Many: List all prompts for a brand
• Get Answers: Get all answers generated for a prompt

Source

• Get: Retrieve details of a cited source
• Get Many: List all sources cited for a brand
• Get Evolution: Get historical data for a source

Competitor

• Get: Retrieve competitor metrics
• Get Many: List all competitors for a brand
• Get Evolution: Get historical data for a competitor

Performance

• Get: Get overall performance metrics (Audit FLASH format)

Credentials

1. Go to your Qwairy workspace: Team Settings → Integrations → API Access
2. Create a new API key
3. In n8n, create new credentials of type Qwairy API
4. Enter your API key (format: qw-api-xxxxxx)

Filtering Options

Most operations support these filters:

• Period: Number of days to look back (e.g., 30)
• Start/End Date: Specific date range
• Provider: Filter by AI platform (OpenAI, Anthropic, Google, etc.)
• Topic: Filter by keyword/topic
• Tag: Filter by tag
• Type: Filter by funnel stage (TOFU, MOFU, BOFU)

Rate Limits

• 100 requests per minute per API key
• Responses are cached for 60 seconds
• Rate limit headers are included in responses (X-RateLimit-Remaining)

Example Workflows

Daily Brand Monitoring Report

1. Schedule Trigger: Run daily at 9 AM
2. Qwairy Node: Get Performance for your brand (period: 1 day)
3. Slack/Email Node: Send the metrics to your team

Alert on Competitor Mentions

1. Schedule Trigger: Run every hour
2. Qwairy Node: Get Answers (hasSelfMention: false, period: 1)
3. Filter Node: Check for specific competitors
4. Slack Node: Alert when competitor is mentioned but you're not

Weekly Analytics Export

1. Schedule Trigger: Run weekly
2. Qwairy Node: Get all Sources (period: 7)
3. Spreadsheet Node: Export to Google Sheets

Example Response

Performance (GET)

{
  "globalScore": 72,
  "mentionRate": 0.45,
  "sourceRate": 0.32,
  "avgSentiment": 0.78,
  "avgRelevance": 0.85,
  "shareOfVoice": 0.23,
  "topCompetitors": [...],
  "topSources": [...]
}

Answer (GET)

{
  "id": "ans_abc123",
  "text": "Based on my analysis...",
  "provider": "OPENAI",
  "model": "gpt-4o",
  "hasSelfMention": true,
  "mentionPosition": 1,
  "sentiment": 0.85,
  "relevance": 0.92,
  "createdAt": "2024-01-15T10:30:00Z"
}

Resources

• Qwairy Website
• Qwairy API Documentation
• n8n Community Nodes Documentation

License

MIT