Description
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.
Table of Contents
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 59 total operations:
AI Search (4 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
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 (8 operations)
- Get Regional Database Overview – Regional performance data
- Get Worldwide Aggregate – Global domain statistics
- Get Overview History – Historical metrics tracking
- Get Keywords – Ranking keywords with filters
- Get Keywords Comparison – Domain vs competitor 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
- Get Related Keywords – Topically related keywords
- Get Question Keywords – Question-based variations
- 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)
- 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 β
π Quick Start
- Browse the example that matches your use case
- Download the
workflow.jsonfile 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.0 (Current)
- β 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
β 59 Operations – Comprehensive coverage across 6 major resources
β 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
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)
Troubleshooting
Authentication Errors
Problem: "401 Unauthorized" or "Invalid API Token"
Solution:
- Verify API token is correct (copy from SE Ranking dashboard)
- Ensure API Type is set to "Data API"
- Check token hasn't expired
- Regenerate token in SE Ranking dashboard if needed
- Test credentials using the "Test" button in n8n
Invalid Source/Country Code
Problem: "Invalid source" or "400 Bad Request"
Solution:
- Use correct Alpha-2 country codes:
us,uk,de,fr,es,it,ca,au,pl - Country code must be lowercase
- Check if SE Ranking has data for that region
- Some engines/features may not be available in all regions
Domain Format Errors
Problem: "Invalid domain format" or "Domain validation failed"
Solution:
- Remove
http://orhttps://from domain (unless operation specifies full URL) - Remove
www.prefix - Remove trailing slashes
- Use format:
example.comnotwww.example.com/ - For subdomains:
blog.example.comis 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:
- Verify domain has data in SE Ranking database
- Check if domain is indexed/tracked
- Try different source/region (domain may rank elsewhere)
- Adjust filters – they may be too restrictive
- For new domains, wait 24-48 hours for initial data collection
- Check if keyword has search volume in selected region
Timeout Errors
Problem: "Request timeout" or "Operation exceeded time limit"
Solution:
- Reduce
limitparameter (try 100 instead of 1000) - Use pagination with
offsetto fetch data in chunks - For keyword export, reduce number of keywords (try 100 instead of 700)
- Remove
history_trendparameter if not needed (adds processing time) - Use "Get Worldwide Aggregate" instead of getting all regional databases
Too Many Keywords Error
Problem: "Too many keywords" or "Maximum 700 keywords exceeded"
Solution:
- Split keyword list into batches of 700 or less
- Use multiple node executions with different batches
- Consider using keyword suggestion operations first to narrow down list
Rate Limit Errors
Problem: "429 Too Many Requests" or "Rate limit exceeded"
Solution:
- Add delay between requests using n8n Wait node
- Reduce frequency of scheduled workflows
- Use batch operations instead of individual requests
- Upgrade SE Ranking plan for higher rate limits
- 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
# 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