@seranking/n8n-nodes-seranking 1.3.6 → 1.3.8

package/README.md

@@ -236,9 +236,9 @@ This node provides access to 6 SE Ranking resources with 62 total operations:
 ### 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 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)
@@ -556,7 +556,11 @@ For detailed API specifications, visit [SE Ranking API Documentation](https://se
 
 ## Version History
 
-### v1.3.5 (Current)
+### 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
@@ -655,6 +659,8 @@ For detailed API specifications, visit [SE Ranking API Documentation](https://se
 
 ✅ **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
@@ -666,7 +672,18 @@ For detailed API specifications, visit [SE Ranking API Documentation](https://se
 - **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:
+
+1. **Retry On Fail**: Open node Settings → enable "Retry On Fail" → set "Wait Between Tries" to 1000ms or more
+2. **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](https://docs.n8n.io/integrations/builtin/rate-limits/).
+
+---
 ## Troubleshooting
 
 ### Pingback Not Received

package/dist/nodes/SeRanking/dataApi/descriptions/DomainAnalysisDescription.js

@@ -198,10 +198,10 @@ exports.domainAnalysisFields = [
         description: 'Type of search data to retrieve',
     },
     {
-        displayName: 'Additional Options',
-        name: 'additionalOptions',
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
         type: 'collection',
-        placeholder: 'Add Option',
+        placeholder: 'Add Field',
         default: {},
         displayOptions: {
             show: {
@@ -224,7 +224,7 @@ exports.domainAnalysisFields = [
             },
             {
                 displayName: 'Order Field',
-                name: 'order_field',
+                name: 'orderField',
                 type: 'options',
                 options: [
                     { name: 'Keywords Count', value: 'keywords_count' },
@@ -237,7 +237,7 @@ exports.domainAnalysisFields = [
             },
             {
                 displayName: 'Order Type',
-                name: 'order_type',
+                name: 'orderType',
                 type: 'options',
                 options: [
                     { name: 'Ascending', value: 'asc' },
@@ -262,7 +262,7 @@ exports.domainAnalysisFields = [
             },
             {
                 displayName: 'URL Filter',
-                name: 'filter_domain_url',
+                name: 'filterDomainUrl',
                 type: 'string',
                 default: '',
                 placeholder: '/blog/',
@@ -270,59 +270,59 @@ exports.domainAnalysisFields = [
             },
             {
                 displayName: 'Traffic Percent From',
-                name: 'filter_traffic_percent_from',
+                name: 'filterTrafficPercentFrom',
                 type: 'number',
                 default: 0,
-                description: 'Minimum traffic percentage (0-100)',
+                description: 'Minimum traffic percentage (0–100)',
             },
             {
                 displayName: 'Traffic Percent To',
-                name: 'filter_traffic_percent_to',
+                name: 'filterTrafficPercentTo',
                 type: 'number',
                 default: 100,
-                description: 'Maximum traffic percentage (0-100)',
+                description: 'Maximum traffic percentage (0–100)',
             },
             {
                 displayName: 'Keywords Count From',
-                name: 'filter_keywords_count_from',
+                name: 'filterKeywordsCountFrom',
                 type: 'number',
                 default: 0,
                 description: 'Minimum number of keywords',
             },
             {
                 displayName: 'Keywords Count To',
-                name: 'filter_keywords_count_to',
+                name: 'filterKeywordsCountTo',
                 type: 'number',
                 default: 0,
                 description: 'Maximum number of keywords (0 = no limit)',
             },
             {
                 displayName: 'Traffic Sum From',
-                name: 'filter_traffic_sum_from',
+                name: 'filterTrafficSumFrom',
                 type: 'number',
                 default: 0,
                 description: 'Minimum total traffic',
             },
             {
                 displayName: 'Traffic Sum To',
-                name: 'filter_traffic_sum_to',
+                name: 'filterTrafficSumTo',
                 type: 'number',
                 default: 0,
                 description: 'Maximum total traffic (0 = no limit)',
             },
             {
                 displayName: 'Price Sum From',
-                name: 'filter_price_sum_from',
+                name: 'filterPriceSumFrom',
                 type: 'number',
                 default: 0,
-                description: 'Minimum traffic value',
+                description: 'Minimum traffic value (PPC equivalent)',
             },
             {
                 displayName: 'Price Sum To',
-                name: 'filter_price_sum_to',
+                name: 'filterPriceSumTo',
                 type: 'number',
                 default: 0,
-                description: 'Maximum traffic value (0 = no limit)',
+                description: 'Maximum traffic value (PPC equivalent, 0 = no limit)',
             },
         ],
     },
@@ -356,6 +356,32 @@ exports.domainAnalysisFields = [
         placeholder: 'us',
         description: 'Regional database code (e.g., us, uk, de, fr, es, it, ca, au, pl)',
     },
+    {
+        displayName: 'Scope',
+        name: 'scope',
+        type: 'options',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['domainAnalysis'],
+                operation: ['getDomainSubdomains'],
+            },
+        },
+        options: [
+            {
+                name: 'Base Domain',
+                value: 'base_domain',
+                description: 'Aggregate subdomains under the registrable domain',
+            },
+            {
+                name: 'Domain',
+                value: 'domain',
+                description: 'Aggregate subdomains under the specified host',
+            },
+        ],
+        default: 'base_domain',
+        description: 'Scope of the subdomain analysis',
+    },
     {
         displayName: 'Type',
         name: 'type',
@@ -375,10 +401,10 @@ exports.domainAnalysisFields = [
         description: 'Type of search data to retrieve',
     },
     {
-        displayName: 'Additional Options',
-        name: 'additionalOptions',
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
         type: 'collection',
-        placeholder: 'Add Option',
+        placeholder: 'Add Field',
         default: {},
         displayOptions: {
             show: {
@@ -389,7 +415,7 @@ exports.domainAnalysisFields = [
         options: [
             {
                 displayName: 'Order Field',
-                name: 'order_field',
+                name: 'orderField',
                 type: 'options',
                 options: [
                     { name: 'Keywords Count', value: 'keywords_count' },
@@ -402,7 +428,7 @@ exports.domainAnalysisFields = [
             },
             {
                 displayName: 'Order Type',
-                name: 'order_type',
+                name: 'orderType',
                 type: 'options',
                 options: [
                     { name: 'Ascending', value: 'asc' },
@@ -426,68 +452,68 @@ exports.domainAnalysisFields = [
                 description: 'Maximum number of results (max 1000)',
             },
             {
-                displayName: 'URL Filter',
-                name: 'filter_domain_url',
+                displayName: 'Subdomain Filter',
+                name: 'filterDomainUrl',
                 type: 'string',
                 default: '',
                 placeholder: 'blog',
-                description: 'Filter subdomains by URL pattern',
+                description: 'Filter subdomains by text pattern',
             },
             {
                 displayName: 'Traffic Percent From',
-                name: 'filter_traffic_percent_from',
+                name: 'filterTrafficPercentFrom',
                 type: 'number',
                 default: 0,
-                description: 'Minimum traffic percentage (0-100)',
+                description: 'Minimum traffic percentage (0–100)',
             },
             {
                 displayName: 'Traffic Percent To',
-                name: 'filter_traffic_percent_to',
+                name: 'filterTrafficPercentTo',
                 type: 'number',
                 default: 100,
-                description: 'Maximum traffic percentage (0-100)',
+                description: 'Maximum traffic percentage (0–100)',
             },
             {
                 displayName: 'Keywords Count From',
-                name: 'filter_keywords_count_from',
+                name: 'filterKeywordsCountFrom',
                 type: 'number',
                 default: 0,
                 description: 'Minimum number of keywords',
             },
             {
                 displayName: 'Keywords Count To',
-                name: 'filter_keywords_count_to',
+                name: 'filterKeywordsCountTo',
                 type: 'number',
                 default: 0,
                 description: 'Maximum number of keywords (0 = no limit)',
             },
             {
                 displayName: 'Traffic Sum From',
-                name: 'filter_traffic_sum_from',
+                name: 'filterTrafficSumFrom',
                 type: 'number',
                 default: 0,
-                description: 'Minimum total traffic',
+                description: 'Minimum estimated monthly traffic',
             },
             {
                 displayName: 'Traffic Sum To',
-                name: 'filter_traffic_sum_to',
+                name: 'filterTrafficSumTo',
                 type: 'number',
                 default: 0,
-                description: 'Maximum total traffic (0 = no limit)',
+                description: 'Maximum estimated monthly traffic (0 = no limit)',
             },
             {
                 displayName: 'Price Sum From',
-                name: 'filter_price_sum_from',
+                name: 'filterPriceSumFrom',
                 type: 'number',
                 default: 0,
-                description: 'Minimum traffic value',
+                description: 'Minimum traffic value (PPC equivalent)',
             },
             {
                 displayName: 'Price Sum To',
-                name: 'filter_price_sum_to',
+                name: 'filterPriceSumTo',
                 type: 'number',
                 default: 0,
-                description: 'Maximum traffic value (0 = no limit)',
+                description: 'Maximum traffic value (PPC equivalent, 0 = no limit)',
             },
         ],
     },
@@ -556,16 +582,8 @@ exports.domainAnalysisFields = [
             },
         },
         options: [
-            {
-                name: 'Organic',
-                value: 'organic',
-                description: 'Organic search results',
-            },
-            {
-                name: 'Paid (Ads)',
-                value: 'adv',
-                description: 'Paid advertising results',
-            },
+            { name: 'Organic', value: 'organic', description: 'Organic search results' },
+            { name: 'Paid (Ads)', value: 'adv', description: 'Paid advertising results' },
         ],
         default: 'organic',
         description: 'Type of search results to analyze',
@@ -582,7 +600,7 @@ exports.domainAnalysisFields = [
         },
         options: [
             {
-                name: 'Common Keywords (A ∩ B)',
+                name: 'Common Keywords (A ∩ B)',
                 value: '0',
                 description: 'Keywords both domains rank for',
             },
@@ -688,28 +706,30 @@ exports.domainAnalysisFields = [
                 type: 'number',
                 default: 1,
                 description: 'Page number for pagination',
-                typeOptions: {
-                    minValue: 1,
-                },
+                typeOptions: { minValue: 1 },
             },
             {
                 displayName: 'Limit',
                 name: 'limit',
                 type: 'number',
                 default: 100,
-                description: 'Maximum number of results to return (1-1000)',
-                typeOptions: {
-                    minValue: 1,
-                    maxValue: 1000,
-                },
+                description: 'Maximum number of results to return (1–1000)',
+                typeOptions: { minValue: 1, maxValue: 1000 },
+            },
+            {
+                displayName: 'Include Subdomains',
+                name: 'withSubdomains',
+                type: 'boolean',
+                default: true,
+                description: 'Whether to include keywords ranking for subdomains',
             },
             {
                 displayName: 'Columns',
                 name: 'cols',
                 type: 'string',
                 default: '',
-                placeholder: 'keyword,position,volume,cpc,url',
-                description: 'Comma-separated list of columns to return',
+                placeholder: 'keyword,position,volume,url,difficulty',
+                description: 'Comma-separated list of columns to return (leave empty for defaults)',
             },
             {
                 displayName: 'Order Field',
@@ -735,7 +755,7 @@ exports.domainAnalysisFields = [
                     { name: 'Descending', value: 'desc' },
                 ],
                 default: 'desc',
-                description: 'Order of sorting',
+                description: 'Sort order direction',
             },
             {
                 displayName: 'Position Change',
@@ -751,43 +771,177 @@ exports.domainAnalysisFields = [
                     { name: 'Same', value: 'same' },
                 ],
                 default: '',
-                description: 'Filter by position changes',
+                description: 'Filter by position change vs. the previous period',
             },
             {
                 displayName: 'Volume From',
                 name: 'volumeFrom',
                 type: 'number',
                 default: 0,
-                description: 'Minimum search volume filter',
+                description: 'Minimum monthly search volume',
             },
             {
                 displayName: 'Volume To',
                 name: 'volumeTo',
                 type: 'number',
                 default: 0,
-                description: 'Maximum search volume filter (0 = no limit)',
+                description: 'Maximum monthly search volume (0 = no limit)',
+            },
+            {
+                displayName: 'Traffic From',
+                name: 'trafficFrom',
+                type: 'number',
+                default: 0,
+                description: 'Minimum estimated monthly traffic',
+            },
+            {
+                displayName: 'Traffic To',
+                name: 'trafficTo',
+                type: 'number',
+                default: 0,
+                description: 'Maximum estimated monthly traffic (0 = no limit)',
+            },
+            {
+                displayName: 'Traffic Percent From',
+                name: 'trafficPercentFrom',
+                type: 'number',
+                default: 0,
+                description: 'Minimum traffic share percentage',
+            },
+            {
+                displayName: 'Traffic Percent To',
+                name: 'trafficPercentTo',
+                type: 'number',
+                default: 0,
+                description: 'Maximum traffic share percentage (0 = no limit)',
             },
             {
                 displayName: 'Position From',
                 name: 'positionFrom',
                 type: 'number',
                 default: 1,
-                description: 'Minimum position filter',
-                typeOptions: {
-                    minValue: 1,
-                    maxValue: 100,
-                },
+                description: 'Minimum ranking position',
+                typeOptions: { minValue: 1, maxValue: 100 },
             },
             {
                 displayName: 'Position To',
                 name: 'positionTo',
                 type: 'number',
                 default: 100,
-                description: 'Maximum position filter',
-                typeOptions: {
-                    minValue: 1,
-                    maxValue: 100,
-                },
+                description: 'Maximum ranking position',
+                typeOptions: { minValue: 1, maxValue: 100 },
+            },
+            {
+                displayName: 'Keyword Word Count From',
+                name: 'keywordCountFrom',
+                type: 'number',
+                default: 0,
+                description: 'Minimum number of words in a keyword phrase',
+                typeOptions: { minValue: 1 },
+            },
+            {
+                displayName: 'Keyword Word Count To',
+                name: 'keywordCountTo',
+                type: 'number',
+                default: 0,
+                description: 'Maximum number of words in a keyword phrase (0 = no limit)',
+            },
+            {
+                displayName: 'Characters Count From',
+                name: 'charactersCountFrom',
+                type: 'number',
+                default: 0,
+                description: 'Minimum character length of keyword phrases',
+                typeOptions: { minValue: 1 },
+            },
+            {
+                displayName: 'Characters Count To',
+                name: 'charactersCountTo',
+                type: 'number',
+                default: 0,
+                description: 'Maximum character length of keyword phrases (0 = no limit)',
+            },
+            {
+                displayName: 'CPC From',
+                name: 'cpcFrom',
+                type: 'number',
+                default: 0,
+                description: 'Minimum cost per click',
+            },
+            {
+                displayName: 'CPC To',
+                name: 'cpcTo',
+                type: 'number',
+                default: 0,
+                description: 'Maximum cost per click (0 = no limit)',
+            },
+            {
+                displayName: 'Price From',
+                name: 'priceFrom',
+                type: 'number',
+                default: 0,
+                description: 'Minimum keyword price value',
+            },
+            {
+                displayName: 'Price To',
+                name: 'priceTo',
+                type: 'number',
+                default: 0,
+                description: 'Maximum keyword price value (0 = no limit)',
+            },
+            {
+                displayName: 'Competition From',
+                name: 'competitionFrom',
+                type: 'number',
+                default: 0,
+                description: 'Minimum competition score (0.0–1.0)',
+                typeOptions: { minValue: 0, maxValue: 1, numberPrecision: 2 },
+            },
+            {
+                displayName: 'Competition To',
+                name: 'competitionTo',
+                type: 'number',
+                default: 1,
+                description: 'Maximum competition score (0.0–1.0)',
+                typeOptions: { minValue: 0, maxValue: 1, numberPrecision: 2 },
+            },
+            {
+                displayName: 'Difficulty From',
+                name: 'difficultyFrom',
+                type: 'number',
+                default: 0,
+                description: 'Minimum keyword difficulty score (0–100)',
+                typeOptions: { minValue: 0, maxValue: 100 },
+            },
+            {
+                displayName: 'Difficulty To',
+                name: 'difficultyTo',
+                type: 'number',
+                default: 100,
+                description: 'Maximum keyword difficulty score (0–100)',
+                typeOptions: { minValue: 0, maxValue: 100 },
+            },
+            {
+                displayName: 'SERP Features',
+                name: 'serpFeatures',
+                type: 'string',
+                default: '',
+                placeholder: 'featured_snippet,local_pack,sitelinks',
+                description: 'Comma-separated list of SERP feature codes to filter by (e.g., featured_snippet, local_pack, sitelinks). See SE Ranking docs for all accepted values.',
+            },
+            {
+                displayName: 'Search Intents',
+                name: 'intents',
+                type: 'multiOptions',
+                options: [
+                    { name: 'Informational (I)', value: 'I' },
+                    { name: 'Navigational (N)', value: 'N' },
+                    { name: 'Transactional (T)', value: 'T' },
+                    { name: 'Commercial (C)', value: 'C' },
+                    { name: 'Local (L)', value: 'L' },
+                ],
+                default: [],
+                description: 'Filter keywords by search intent',
             },
         ],
     },
@@ -810,20 +964,15 @@ exports.domainAnalysisFields = [
                 type: 'number',
                 default: 1,
                 description: 'Page number for pagination',
-                typeOptions: {
-                    minValue: 1,
-                },
+                typeOptions: { minValue: 1 },
             },
             {
                 displayName: 'Limit',
                 name: 'limit',
                 type: 'number',
                 default: 100,
-                description: 'Maximum number of results to return (1-1000)',
-                typeOptions: {
-                    minValue: 1,
-                    maxValue: 1000,
-                },
+                description: 'Maximum number of results to return (1–1000)',
+                typeOptions: { minValue: 1, maxValue: 1000 },
             },
             {
                 displayName: 'Columns',
@@ -859,7 +1008,7 @@ exports.domainAnalysisFields = [
                     { name: 'Descending', value: 'desc' },
                 ],
                 default: 'asc',
-                description: 'Order of sorting',
+                description: 'Sort order direction',
             },
         ],
     },
@@ -927,20 +1076,15 @@ exports.domainAnalysisFields = [
                 type: 'number',
                 default: 1,
                 description: 'Page number for pagination',
-                typeOptions: {
-                    minValue: 1,
-                },
+                typeOptions: { minValue: 1 },
             },
             {
                 displayName: 'Limit',
                 name: 'limit',
                 type: 'number',
                 default: 100,
-                description: 'Maximum number of domains to return (1-100)',
-                typeOptions: {
-                    minValue: 1,
-                    maxValue: 100,
-                },
+                description: 'Maximum number of domains to return (1–100)',
+                typeOptions: { minValue: 1, maxValue: 100 },
             },
         ],
     },
@@ -979,20 +1123,15 @@ exports.domainAnalysisFields = [
                 type: 'number',
                 default: 1,
                 description: 'Page number for pagination',
-                typeOptions: {
-                    minValue: 1,
-                },
+                typeOptions: { minValue: 1 },
             },
             {
                 displayName: 'Limit',
                 name: 'limit',
                 type: 'number',
                 default: 100,
-                description: 'Maximum number of keywords to return (1-100)',
-                typeOptions: {
-                    minValue: 1,
-                    maxValue: 100,
-                },
+                description: 'Maximum number of keywords to return (1–100)',
+                typeOptions: { minValue: 1, maxValue: 100 },
             },
         ],
     },