seranking

n8n connector for SE Ranking API - AI Search, Backlinks, Domain Analysis, Keyword Research, and Website Audit

Package Information

Downloads: 178 weekly / 556 monthly

Latest Version: 1.3.8

Author: SE Ranking

Available Nodes

SE Ranking

Interact with SE Ranking API for SEO data

Documentation

n8n-nodes-seranking

This is an n8n custom node that lets you use SE Ranking in your n8n workflows.

SE Ranking is a comprehensive SEO platform providing keyword research, competitor analysis, website audits, backlink monitoring, and AI search visibility tracking.

n8n is a workflow automation platform.

Installation
Credentials
Compatibility
Operations
Usage Examples
API Documentation
Version History

Installation

Follow the installation guide in the n8n community nodes documentation.

Prerequisites

Node.js 18.x or higher
n8n 1.0.0 or higher
SE Ranking API Token (Get it here)

npm (Recommended)

npm install @seranking/n8n-nodes-seranking

Quick Installation

Navigate to your n8n installation directory

Install the package:

npm install @seranking/n8n-nodes-seranking

Restart n8n

Manual Install

Step 1: Install n8n

npm install n8n -g

Step 2: Install SE Ranking Node

Option A: From .tgz file

npm install -g seranking-n8n-nodes-seranking-1.3.0.tgz

Option B: From GitHub

npm install -g git+https://github.com/seranking/n8n-nodes-seranking.git

Option C: From source (for developers)

cd ~/.n8n/custom
git clone https://github.com/seranking/n8n-nodes-seranking.git
cd n8n-nodes-seranking
npm install
npm run build
npm link

Step 3: Start n8n

n8n start

Open http://localhost:5678 and add the SE Ranking node to your workflow.

Step 4: Configure Credentials

Add SE Ranking node
Click "Create New Credential"
Enter your API Token
Select "Data API" as API Type
Save

Docker Installation

# Create custom directory
mkdir -p ~/.n8n/custom
cd ~/.n8n/custom

# Install node 
npm install @seranking/n8n-nodes-seranking
# OR
npm install git+https://github.com/seranking/n8n-nodes-seranking.git

# Run n8n
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Verify Installation

Open n8n at http://localhost:5678
Search for "SE Ranking" node
If it appears, installation successful ✓

Updating

From npm:

npm update @seranking/n8n-nodes-seranking

From .tgz:

npm uninstall -g seranking-n8n-nodes-seranking
npm install -g seranking-n8n-nodes-seranking-NEW-VERSION.tgz

From GitHub:

npm install -g git+https://github.com/seranking/n8n-nodes-seranking.git

From source:

cd ~/.n8n/custom/n8n-nodes-seranking
git pull
npm install
npm run build

Then restart n8n

Credentials

To use this node, you need:

SE Ranking Account - Sign up at seranking.com
API Token - Generate from your SE Ranking API Dashboard

Setting up credentials in n8n

Open any workflow and add the SE Ranking node
Click on Create New Credential
Enter your API Token
Select Data API as API Type
Click Save

The node will automatically test your credentials by making a test request to the SE Ranking API.

Compatibility

n8n version: 1.0.0 or higher
Node.js version: 18.x or higher
SE Ranking API: v1 (Data API)

Operations

This node provides access to 6 SE Ranking resources with 62 total operations:

AI Search (5 operations)

Get Overview - LLM visibility metrics across ChatGPT, Perplexity, Gemini
Discover Brand - Identify brand name for domain
Get Prompts by Target - Find prompts mentioning your domain
Get Prompts by Brand - Track brand mentions in AI responses
Get Leaderboard - Compare domain performance against competitors across LLMs

Backlinks (25 operations)

Get Summary - Complete backlink portfolio overview
Get Metrics - Key metrics for multiple targets
Get All Backlinks - Detailed backlink list with filters
Get Raw Backlinks - Cursor-based bulk retrieval
Get Count - Total backlinks count
Export Backlinks - Bulk export functionality
Check Export Status - Monitor export progress
Download Export Data - Retrieve completed exports
Get History - New/lost backlinks by date range
Get History Count - Daily new/lost counts
Get Cumulative History - Historical growth tracking
Get Anchors - Anchor text analysis
Get Referring Domains - List of linking domains
Get Referring Domains Count - Unique domain count
Get Referring Domains History - Domain link changes
Get Referring Domains History Count - Domain change counts
Get Referring IPs - IP addresses of linking sites
Get Referring IPs Count - Unique IP count
Get Referring Subnets Count - /24 subnet diversity
Get Indexed Pages - Pages in backlink index
Get Authority - InLink Rank metrics
Get Domain Authority - Domain-level authority
Get Domain Authority Distribution - Authority score distribution
Get Page Authority - Page-level authority
Get Page Authority History - Historical authority tracking

Domain Analysis (11 operations)

Get Regional Database Overview - Regional performance data
Get Worldwide Aggregate - Global domain statistics
Get Worldwide Aggregate for URL - URL-level global performance
Get Overview History - Historical metrics tracking
Get Keywords - Ranking keywords with filters
Get Keywords Comparison - Domain vs competitor analysis
Get Domain Pages - Page-level keyword and traffic metrics
Get Domain Subdomains - Subdomain performance analysis
Get Competitors - Identify competing domains
Get Paid Ads for Keyword - Advertisers on keywords
Get Paid Ads for Domain - Domain's advertising keywords

Keyword Research (5 operations)

Export Metrics - Bulk keyword metrics (up to 700 keywords)
Get Similar Keywords - Semantically similar suggestions with full filter support (traffic, difficulty, intents, SERP features, word count, and more)
Get Related Keywords - Topically related keywords with full filter support (traffic, difficulty, intents, SERP features, word count, and more)
Get Question Keywords - Question-based variations with full filter support (traffic, difficulty, intents, SERP features, word count, and more)
Get Longtail Keywords - Long-tail opportunities

Website Audit (14 operations)

Create Standard Audit - HTML site audit
Create Advanced Audit - JS-rendered audit for SPAs
List Audits - All audits with status
Get Audit Status - Check audit progress
Get Audit Report - Full audit results
Get Crawled Pages - List of crawled URLs
Get Issues by Type - Pages with specific issues
Get Issues by URL - All issues for one URL
Get Links - Internal/external links found
Get Audit History - Historical audit snapshots
Update Audit - Modify audit details
Delete Audit - Remove audit
Recheck Standard Audit - Re-run HTML audit
Recheck Advanced Audit - Re-run JS audit

SERP Classic (5 operations)

Add Tasks - Create SERP tasks for keywords (up to 1,000 per request, supports Pingback URL)
Get Results - Get standard SERP results for a task
List Tasks - List recent SERP tasks (last 24 hours)
Get Advanced Results - Retrieve detailed SERP results with all features
Get Locations - Get available location IDs for SERP queries

Usage Examples

Ready-to-use workflows demonstrating real-world applications of the SE Ranking node. Each example includes importable n8n workflows, setup instructions, and expected outputs.

🤖 Example 1: AI Search Visibility Tracker

Track your brand's presence and competitive gaps across ChatGPT, Perplexity, and Gemini

Two comprehensive workflows for monitoring AI visibility and identifying content opportunities.

Workflow 1: AI Search Visibility Tracker

Monitor how often your brand appears in AI-powered search engines with automated historical tracking.

Link presence count across multiple AI engines
Average position tracking in AI citations
AI opportunity traffic estimates
Period-over-period comparison metrics

Workflow 2: Competitor Topic Gap Analysis

Identify content opportunities by analyzing where competitors outrank you in AI search and traditional SEO.

AI visibility gaps across ChatGPT, Perplexity, and Gemini
Keyword gaps with search volume and difficulty
Competitor backlink authority metrics
Prioritized opportunities with HIGH/MEDIUM/LOW scoring
Actionable recommendations for each gap

Best For: Marketing teams tracking AI SEO performance, Content strategists planning editorial calendars, SEO teams doing competitive intelligence

📂 View Full Guide & Download Workflow →

🔗 Example 2: Backlinks Monitoring & Analysis

Track new/lost backlinks, monitor domain authority, and analyze anchor text distribution

Automatically monitor backlink portfolio health with daily tracking and alerts for significant changes.

What You'll Get:

Daily new/lost backlink reports
Domain authority trend tracking
Anchor text distribution analysis
Referring domain diversity metrics
Export-ready CSV/Excel reports

Best For: SEO agencies managing client backlink portfolios, In-house SEO teams tracking link-building campaigns

📂 View Full Guide & Download Workflow →

📊 Example 3: Domain Analysis Data Processor

Transform SE Ranking API data into structured Google Sheets reports

Automatically process and organize domain analysis data with intelligent type detection.

What You'll Get:

Regional performance across 200+ countries
Domain summary with organic vs. paid breakdown
Keywords analysis with positions and difficulty
Competitor insights and gap analysis
Multi-domain comparison with worldwide traffic data

Best For: SEO agencies managing multiple clients, Enterprise teams tracking regional performance

📂 View Full Guide & Download Workflow →

🔍 Example 4: Keyword Research Automation

Automate comprehensive keyword research with trend analysis

Build an automated keyword intelligence pipeline with historical tracking and SERP features.

What You'll Get:

Bulk keyword metrics with volume and CPC
Historical trend analysis (peaks, valleys, averages)
SERP features tracking (PAA, featured snippets, etc.)
Search intent mapping (informational, commercial, navigational)

Best For: Content strategists planning editorial calendars, SEO specialists doing competitor research

📂 View Full Guide & Download Workflow →

🔧 Example 5: Website Audit Automation

Automatically crawl sites, detect issues, and generate reports

Schedule regular technical SEO audits and get alerts when critical issues are detected.

What You'll Get:

Automated monthly/weekly site audits
Issue detection across 25+ SEO factors
Historical issue tracking and resolution monitoring
Exportable reports for clients/stakeholders

Best For: Development teams doing pre-launch checks, SEO consultants managing multiple client sites

📂 View Full Guide & Download Workflow →

📍 Example 6: SERP Classic Tracking

Track keyword rankings and analyze SERP features across search engines

Monitor keyword positions, SERP features, and competitor visibility with automated rank tracking.

What You'll Get:

Keyword position tracking across multiple locations
SERP features analysis (featured snippets, local pack, etc.)
Competitor ranking visibility
Device-specific rankings (desktop, mobile, tablet)
Historical rank tracking

Best For: SEO teams tracking keyword performance, Local businesses monitoring location-based rankings, Agencies managing multi-client SERP tracking

📂 View Full Guide & Download Workflow →

🔔 Example 7: SERP Pingback Webhooks

Get notified instantly when SERP results are ready — no polling required!

Instead of checking task status repeatedly, SE Ranking calls your webhook when done.

Simple Workflow (3 nodes)

[Webhook] → [SE Ranking: Get Results] → [Google Sheets]
   ↑
   └── SE Ranking calls this when task completes

Step-by-Step Setup

Step 1: Create Webhook to Receive Notifications

Add a Webhook node:

Setting	Value
HTTP Method	`GET`
Path	`serp-callback`
Response Mode	`Immediately`

Click "Listen for test event" and copy the URL.

Step 2: Create SERP Task with Pingback

In another workflow, add SE Ranking node:

Setting	Value
Resource	`SERP Classic`
Operation	`Add Tasks`
Search Engine	`google`
Device	`desktop`
Language Code	`en`
Location ID	`2840` (USA)
Keywords	`seo tools`
Tag	`my-test`
Pingback URL	`https://your-n8n.com/webhook/serp-callback?id=$id&tag=$tag`

⚠️ Use $id and $tag exactly as shown — SE Ranking replaces them with real values.

Step 3: Fetch Results When Webhook Fires

Back in your webhook workflow, add SE Ranking node after the Webhook:

Setting	Value
Resource	`SERP Classic`
Operation	`Get Results`
Task ID	`{{ $json.query.id }}`

That's it! When SE Ranking finishes, it calls your webhook, which fetches the results automatically.

Using in Advanced Workflows

Add pingback to any existing SERP workflow:

[Schedule] → [SE Ranking: Add Tasks] ──(async)──→ [Webhook] → [Get Results] → [Process]
                    │
                    └── pingback_url triggers webhook when done

🏆 Example 8: AI Search Leaderboard

Compare your AI visibility against competitors in one request.

See how your brand performs vs competitors across ChatGPT, Perplexity, Gemini, and Google AI Overview.

Simple Workflow (2 nodes)

[Manual Trigger] → [SE Ranking: Get Leaderboard] → [View Results]

Step-by-Step Setup

Step 1: Add SE Ranking Node

Setting	Value
Resource	`AI Search`
Operation	`Get Leaderboard`
Primary Target	`yoursite.com`
Primary Brand	`Your Brand`
Source	`us`
AI Engines	Select: `chatgpt`, `perplexity`, `ai-overview`

Step 2: Add Competitors

Click "Add Competitor" and enter:

Target Domain	Brand Name
`competitor1.com`	`Competitor 1`
`competitor2.com`	`Competitor 2`

Step 3: Run and View Results

Execute the workflow. Response includes:

Link presence count (how often you appear)
Average position in AI citations
Change vs previous period
Breakdown by AI engine

Using in Advanced Workflows

Combine with scheduling and reporting:

[Schedule: Weekly] → [Get Leaderboard] → [Code: Calculate Gaps] → [Google Sheets] → [Slack Alert]

Example: Find where competitors beat you

// In Code node after Get Leaderboard
const dominated = $input.all().filter(item => 
  item.json.competitor_presence > item.json.primary_presence
);
return dominated;

🚀 Quick Start

Browse the example that matches your use case
Download the workflow.json file from the example folder
Import into n8n (Workflows → Import from File)
Configure your SE Ranking API credentials
Run and customize to your needs

Need help? Each example includes troubleshooting tips and configuration details.

API Documentation

This node implements the following SE Ranking APIs:

For detailed API specifications, visit SE Ranking API Documentation.

Version History

v1.3.6 (Current)

🔧 FIX: Rate limiting compatibility - Replaced setTimeout with n8n-workflow sleep function for n8n verified node compliance

v1.3.5

✅ NEW: SERP Pingback URL - Webhook notifications when SERP tasks complete
✅ NEW: AI Search Leaderboard - Compare visibility against competitors across LLMs
✅ Total: 65 operations across 6 resources
✅ Event-driven SERP workflow support
✅ Multi-competitor AI visibility comparison

v1.3.3

✅ NEW: Get Worldwide Aggregate for URL - URL-level global performance metrics
✅ NEW: Get Domain Pages - Page-level keyword and traffic analysis with intent breakdown
✅ NEW: Get Domain Subdomains - Subdomain traffic and keyword metrics
✅ Total: 62 operations across 6 resources
✅ Advanced filtering for pages/subdomains (traffic %, keywords count, traffic sum)
✅ Search intent breakdown (Informational, Navigational, Transactional, Commercial, Local)

v1.3.0

✅ Complete AI Search resource (4 operations)
✅ Complete Backlinks resource (25 operations)
✅ Enhanced Domain Analysis resource (8 operations - added History, Comparison, Paid Ads)
✅ Complete Keyword Research resource (5 operations)
✅ Complete Website Audit resource (14 operations)
✅ NEW: Complete SERP Classic resource (5 operations)
✅ Total: 59 operations across 6 resources
✅ Comprehensive error handling with detailed messages
✅ Full TypeScript support
✅ Input validation (domains, sources, dates)
✅ Pagination support (offset/limit)
✅ Advanced filtering options
✅ Multi-keyword support (up to 1,000 keywords for SERP tasks)
✅ Backlink export and bulk operations
✅ Website audit creation and management
✅ NEW: SERP rank tracking and analysis
✅ NEW: Multi-location SERP data retrieval

v1.2.3

✅ Complete AI Search resource (4 operations)
✅ NEW: Complete Backlinks resource (25 operations)
✅ Enhanced Domain Analysis resource (8 operations - added History, Comparison, Paid Ads)
✅ Complete Keyword Research resource (5 operations)
✅ NEW: Complete Website Audit resource (14 operations)
✅ Total: 54 operations across 5 resources
✅ Comprehensive error handling with detailed messages
✅ Full TypeScript support
✅ Input validation (domains, sources, dates)
✅ Pagination support (offset/limit)
✅ Advanced filtering options
✅ Multi-keyword support (up to 700 keywords)
✅ NEW: Backlink export and bulk operations
✅ NEW: Website audit creation and management

v1.0.7

✅ Complete AI Search resource (4 operations)
✅ Complete Domain Analysis resource (4 operations)
✅ Complete Keyword Research resource (5 operations)
✅ Total: 13 operations across 3 resources
✅ Comprehensive error handling with detailed messages
✅ Full TypeScript support
✅ Input validation (domains, sources, dates)
✅ Pagination support (offset/limit)
✅ Advanced filtering options
✅ Multi-keyword support (up to 700 keywords)

Features

✅ 65 Operations - Comprehensive coverage across 6 major resources

✅ Pingback Webhooks - Event-driven notifications for SERP task completion

✅ AI Competitive Analysis - Leaderboard comparison across LLM engines

✅ Type Safety - Full TypeScript implementation with strict typing

✅ Error Handling - Detailed error messages with troubleshooting hints

✅ Pagination - Efficient handling of large datasets

✅ Advanced Filtering - Volume, position, CPC, difficulty filters

✅ Validation - Input validation for domains, country codes, and parameters

✅ Authentication - Automatic credential management and testing

✅ Rate Limiting - Built-in rate limit handling with retry logic

✅ Batch Operations - Support for multiple keywords/domains

✅ Backlink Monitoring - Complete backlink analysis and tracking

✅ Website Auditing - Technical SEO audits with issue detection

✅ SERP Tracking - Keyword ranking and SERP features analysis

✅ Advanced Filtering - Volume, position, CPC, difficulty, traffic, search intent, SERP features, keyword word count, and include/exclude keyword pattern filters

Limitations

Rate Limits: SE Ranking API has rate limits (varies by plan)
Regional Data: Some data is region-specific (requires country code)
Keyword Limits: Export Metrics supports up to 700 keywords per request
Historical Data: History trend data adds to response time
API Credits: Some operations consume API credits (check your plan)

Rate Limiting

This node includes built-in rate limiting (300ms delay between requests) to help prevent hitting SE Ranking API limits.

If you still encounter "429 Too Many Requests" errors when processing large amounts of data, you can use n8n's built-in solutions:

Retry On Fail: Open node Settings → enable "Retry On Fail" → set "Wait Between Tries" to 1000ms or more
Split In Batches + Wait: Use the "Loop Over Items" node to process items in smaller batches with a "Wait" node between requests

For more details, see n8n's rate limiting documentation.

Troubleshooting

Pingback Not Received

Problem: SERP task completes but webhook never fires

Solution:

Use production webhook URL (not webhook-test)
Ensure URL is publicly accessible (not localhost)
Use HTTPS
Respond within 5 seconds with HTTP 200
Use literal $id and $tag placeholders

Valid URL format:

✅ https://your-domain.com/webhook/serp-callback?id=$id&tag=$tag
❌ https://localhost:5678/webhook/...
❌ https://your-domain.com/webhook-test/...


---

### Authentication Errors

**Problem**: "401 Unauthorized" or "Invalid API Token"

**Solution**:

1. Verify API token is correct (copy from SE Ranking dashboard)
2. Ensure API Type is set to "Data API"
3. Check token hasn't expired
4. Regenerate token in SE Ranking dashboard if needed
5. Test credentials using the "Test" button in n8n

---

### Invalid Source/Country Code

**Problem**: "Invalid source" or "400 Bad Request"

**Solution**:

1. Use correct Alpha-2 country codes: `us`, `uk`, `de`, `fr`, `es`, `it`, `ca`, `au`, `pl`
2. Country code must be lowercase
3. Check if SE Ranking has data for that region
4. Some engines/features may not be available in all regions

---

### Domain Format Errors

**Problem**: "Invalid domain format" or "Domain validation failed"

**Solution**:

1. Remove `http://` or `https://` from domain (unless operation specifies full URL)
2. Remove `www.` prefix
3. Remove trailing slashes
4. Use format: `example.com` not `www.example.com/`
5. For subdomains: `blog.example.com` is valid

**Valid formats:**

- ✅ `example.com`
- ✅ `blog.example.com`
- ✅ `example.co.uk`
- ❌ `https://example.com`
- ❌ `www.example.com`
- ❌ `example.com/`

---

### Empty Results

**Problem**: No data returned from API

**Solution**:

1. Verify domain has data in SE Ranking database
2. Check if domain is indexed/tracked
3. Try different source/region (domain may rank elsewhere)
4. Adjust filters - they may be too restrictive
5. For new domains, wait 24-48 hours for initial data collection
6. Check if keyword has search volume in selected region

---

### Timeout Errors

**Problem**: "Request timeout" or "Operation exceeded time limit"

**Solution**:

1. Reduce `limit` parameter (try 100 instead of 1000)
2. Use pagination with `offset` to fetch data in chunks
3. For keyword export, reduce number of keywords (try 100 instead of 700)
4. Remove `history_trend` parameter if not needed (adds processing time)
5. Use "Get Worldwide Aggregate" instead of getting all regional databases

---

### Too Many Keywords Error

**Problem**: "Too many keywords" or "Maximum 700 keywords exceeded"

**Solution**:

1. Split keyword list into batches of 700 or less
2. Use multiple node executions with different batches
3. Consider using keyword suggestion operations first to narrow down list

---

### Rate Limit Errors

**Problem**: "429 Too Many Requests" or "Rate limit exceeded"

**Solution**:

1. Add delay between requests using n8n Wait node
2. Reduce frequency of scheduled workflows
3. Use batch operations instead of individual requests
4. Upgrade SE Ranking plan for higher rate limits
5. Implement exponential backoff retry logic

---

## Best Practices

### 1. Efficient Data Retrieval

✅ **DO:**

- Use "Get Worldwide Aggregate" for quick domain overview
- Use pagination for large datasets (limit: 100-500)
- Cache frequently accessed data
- Use filters to reduce result size

❌ **DON'T:**

- Request all databases when you only need one region
- Fetch 10,000 keywords at once without pagination
- Request history_trend unless specifically needed

### 2. Keyword Research

✅ **DO:**

- Start with similar keywords, then expand to related/questions
- Use filters to focus on achievable opportunities (difficulty < 50)
- Export metrics in batches of 200-500 keywords
- Include multiple keyword types for comprehensive research

❌ **DON'T:**

- Request all keyword types simultaneously without filtering
- Ignore difficulty scores (targeting too-hard keywords wastes effort)
- Forget to check search intent and relevance

### 3. Backlink Monitoring

✅ **DO:**

- Schedule daily checks for new/lost backlinks
- Use "Get Summary" for quick health checks
- Export full data monthly for archival
- Track Domain InLink Rank trends over time
- Monitor anchor text distribution for natural link profile

❌ **DON'T:**

- Poll "Get All Backlinks" every hour (use history endpoints)
- Download exports without checking status first
- Ignore referring domain diversity (IP distribution)

### 4. Competitor Analysis

✅ **DO:**

- Use "Get Competitors" to identify relevant competitors first
- Track competitor changes over time (weekly/monthly)
- Focus on keywords where competitors rank in top 20
- Analyze multiple competitors to find patterns

❌ **DON'T:**

- Compare against irrelevant competitors
- Track too many competitors (focus on top 5-10)
- Ignore competitor's content strategy and backlink profile

### 5. AI Search Optimization

✅ **DO:**

- Monitor multiple engines (ChatGPT, Perplexity, Gemini)
- Track brand mentions and citation types
- Focus on high-volume prompts
- Use base_domain scope for brand monitoring

❌ **DON'T:**

- Only track one LLM engine
- Ignore prompt context and user intent
- Forget to optimize content based on insights

### 6. Website Auditing

✅ **DO:**

- Use Advanced Audit for JavaScript-heavy sites (React, Vue, Angular)
- Set realistic max_pages based on site size
- Schedule monthly audits for ongoing monitoring
- Compare historical audits to track improvements
- Export issues to spreadsheet for team collaboration

❌ **DON'T:**

- Set max_pages too high (start with 1000-5000)
- Ignore robots.txt unless intentionally testing blocked areas
- Run audits too frequently (daily audits waste credits)

### 7. Error Handling

✅ **DO:**

- Implement retry logic for transient errors
- Log errors for debugging
- Use n8n's "Continue on Fail" for batch operations
- Validate input before API calls

❌ **DON'T:**

- Ignore error messages (they contain helpful hints)
- Retry immediately after rate limit (wait 60s)
- Skip input validation

---

### Development Setup

```bash
# Clone the repository
git clone https://github.com/seranking/n8n-nodes-seranking.git

# Navigate to directory
cd n8n-nodes-seranking

# Install dependencies
npm install

# Build the node
npm run build

# Watch for changes during development
npm run dev

Project Structure

n8n-nodes-seranking/
│
├── credentials/
│   └── SeRankingApi.credentials.ts                               # API credentials configuration
│
├── nodes/
│   └── SeRanking/
│       ├── SeRanking.node.ts                                     # Main node definition
│       ├── dataApi/
│       │   ├── operations/
│       │   │   ├── AiSearchOperations.ts                         # AI Search operations logic
│       │   │   ├── BacklinksOperations.ts                        # Backlinks operations logic
│       │   │   ├── DomainAnalysisOperations.ts                   # Domain Analysis operations logic
│       │   │   ├── KeywordResearchOperations.ts                  # Keyword Research operations logic
│       │   │   ├── WebsiteAuditOperations.ts                     # Website Audit operations logic
│       │   │   └── SerpClassicOperations.ts                      # SERP Classic operations logic
│       │   └── descriptions/
│       │       ├── AiSearchDescription.ts                        # AI Search UI definitions
│       │       ├── BacklinksDescription.ts                       # Backlinks UI definitions
│       │       ├── DomainAnalysisDescription.ts                  # Domain Analysis UI definitions
│       │       ├── KeywordResearchDescription.ts                 # Keyword Research UI definitions
│       │       ├── WebsiteAuditDescription.ts                    # Website Audit UI definitions
│       │       └── SerpClassicDescription.ts                     # SERP Classic UI definitions
│       └── utils/
│           ├── validators.ts                                     # Input validators
│           └── apiRequest.ts                                     # API request handler
│
├── Usage-Examples/
│   ├── AI-Search/
│   │   ├── AIVisibilityTracker.json                              # Workflow 1: AI Visibility Tracker
│   │   ├── AIVisibilityTrackerResults.xlsx                       # Workflow 1 Results
│   │   ├── SERanking-CompetitorTopicGapAnalysis.json             # Workflow 2: Competitor Topic Gap Analysis
│   │   ├── SE Ranking - Competitor Topic Gap Analysis.xlsx       # Workflow 2 Results
│   │   └── README.md                                             # AI Search workflows documentation
│   │
│   ├── Backlinks/
│   │   ├── Backlinks-Monitoring&Analysis.json                    # Backlinks monitoring workflow
│   │   └── README.md                                             # Backlinks workflow documentation
│   │
│   ├── Domain-Analysis/
│   │   ├── DomainAnalysisMulti-FormatProcessor.json              # Workflow 1: Multi-Format Data Processor
│   │   ├── DomainAnalysisMulti-FormatProcessor.xlsx              # Workflow 1 Results
│   │   ├── DomainTraffic&CompetitorAnalysis.json                 # Workflow 2: Multi-Domain Traffic Analysis
│   │   ├── DomainTraffic&CompetitorAnalysis.xlsx                 # Workflow 2 Results
│   │   ├── Get_Regional_DB_Overview.jpg                          # Screenshot: Regional Overview
│   │   ├── Get_Worldwide_Aggregate.jpg                           # Screenshot: Worldwide Aggregate
│   │   ├── Get_Domain_Keywords.jpg                               # Screenshot: Keywords Analysis
│   │   ├── Get_Competitors.jpg                                   # Screenshot: Competitors
│   │   ├── Get keywords comparison Organic Common Keywords.jpg   # Screenshot: Keywords Comparison
│   │   ├── Get keywords comparison Organic Keyword Gap.jpg       # Screenshot: Organic Gap
│   │   ├── Get keywords comparison Paid Keyword Gap.jpg          # Screenshot: Paid Gap
│   │   ├── Get keywords comparison Paid.jpg                      # Screenshot: Paid Comparison
│   │   ├── Get overview history Organic.jpg                      # Screenshot: Organic History
│   │   ├── Get overview history Paid.jpg                         # Screenshot: Paid History
│   │   ├── Get paid ads for domain.jpg                           # Screenshot: Domain Ads
│   │   ├── Get paid ads for keyword.jpg                          # Screenshot: Keyword Ads
│   │   ├── Get audit links.png                                   # Screenshot: Audit Links
│   │   ├── Get crawled pages.png                                 # Screenshot: Crawled Pages
│   │   ├── Get issues for URL.png                                # Screenshot: URL Issues
│   │   └── README.md                                             # Domain Analysis workflows documentation
│   │
│   ├── Keyword-Research/
│   │   ├── KeywordResearch→GoogleSheetsPipeline.json             # Keyword research workflow
│   │   ├── KeywordResearch→GoogleSheetsPipeline.xlsx             # Workflow results
│   │   ├── Get_Similar_Keywords.jpg                              # Screenshot: Similar Keywords
│   │   ├── Get_Related_Keywords.jpg                              # Screenshot: Related Keywords
│   │   ├── Get_Question_Keywords.jpg                             # Screenshot: Question Keywords
│   │   ├── Get_Longtail_Keywords.jpg                             # Screenshot: Longtail Keywords
│   │   └── README.md                                             # Keyword Research workflow documentation
│   │
│   ├── Website-Audit/
│   │   ├── Website-Audit-Technical-SEO-Monitor.json              # Website audit workflow
│   │   └── README.md                                             # Website Audit workflow documentation
│   │
│   └── SERP-Classic/
│       ├── Gelato-Small-Towns-Amsterdam-Area.json                # SERP tracking workflow
│       ├── Gelato Small Towns Amsterdam Area.xlsx                # Workflow results
│       └── README.md                                             # SERP Classic workflow documentation
│
├── package.json
├── package-lock.json
├── tsconfig.json
└── README.md

Acknowledgments

Built for the n8n workflow automation platform
Powered by SE Ranking API

Keywords

n8n, n8n-custom-node, seranking, seo, keyword-research, domain-analysis, ai-search, llm-visibility, serp-tracking, competitive-analysis, seo-automation, workflow-automation

Made with ❤️ for SEO professionals using n8n

serankingInstall

Package Information

Available Nodes

Documentation

n8n-nodes-seranking

Table of Contents

Installation

Prerequisites

npm (Recommended)

Quick Installation

Manual Install

Step 1: Install n8n

Step 2: Install SE Ranking Node

Step 3: Start n8n

Step 4: Configure Credentials

Docker Installation

Verify Installation

Updating

Then restart n8n

Credentials

Setting up credentials in n8n

Compatibility

Operations

AI Search (5 operations)

Backlinks (25 operations)

Domain Analysis (11 operations)

Keyword Research (5 operations)

Website Audit (14 operations)

SERP Classic (5 operations)

Usage Examples

🤖 Example 1: AI Search Visibility Tracker

🔗 Example 2: Backlinks Monitoring & Analysis

📊 Example 3: Domain Analysis Data Processor

🔍 Example 4: Keyword Research Automation

🔧 Example 5: Website Audit Automation

📍 Example 6: SERP Classic Tracking

🔔 Example 7: SERP Pingback Webhooks

Simple Workflow (3 nodes)

Step-by-Step Setup

Using in Advanced Workflows

🏆 Example 8: AI Search Leaderboard

Simple Workflow (2 nodes)

Step-by-Step Setup

Using in Advanced Workflows

🚀 Quick Start

API Documentation

Version History

v1.3.6 (Current)

v1.3.5

v1.3.3

v1.3.0

v1.2.3

v1.0.7

Features

Limitations

Rate Limiting

Troubleshooting

Pingback Not Received

Project Structure

Acknowledgments

Keywords

Discussion

seranking