@seranking/n8n-nodes-seranking 1.3.8 → 1.3.9

package/README.md

@@ -574,7 +574,7 @@ For detailed API specifications, visit [SE Ranking API Documentation](https://se
 - ✅ **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)
+- ✅ Advanced filtering for pages/subdomains (traffic %, keywords count, traffic sum,)
 - ✅ Search intent breakdown (Informational, Navigational, Transactional, Commercial, Local)
 
 ### v1.3.0 
@@ -659,7 +659,7 @@ 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
+✅ **Advanced Filtering** - Volume, position, CPC, difficulty, traffic, search intent, SERP features, keyword word count, and include/exclude keyword pattern filters, and the new SERP Feature Link filter (filter[serp_features_2]) — which lets you filter keywords where your domain is specifically linked within a SERP feature (e.g. AI Overviews, Reviews), distinct from the existing serpFeatures filter which only checks for feature presence on the SERP.
 
 ---
 

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

@@ -943,6 +943,41 @@ exports.domainAnalysisFields = [
                 default: [],
                 description: 'Filter keywords by search intent',
             },
+            {
+                displayName: 'Include Keywords Containing',
+                name: 'multiKeywordIncluded',
+                type: 'string',
+                default: '',
+                placeholder: 'best, top, review',
+                description: 'Comma-separated words that must appear in results',
+            },
+            {
+                displayName: 'Exclude Keywords Containing',
+                name: 'multiKeywordExcluded',
+                type: 'string',
+                default: '',
+                placeholder: 'free, cheap',
+                description: 'Comma-separated words that must NOT appear in results',
+            },
+            {
+                displayName: 'SERP Feature Link Mode',
+                name: 'serpFeatures2Mode',
+                type: 'options',
+                options: [
+                    { name: 'With Link', value: 'with_link' },
+                    { name: 'Without Link', value: 'without_link' },
+                ],
+                default: 'with_link',
+                description: 'Filter by whether the analyzed domain is linked inside a SERP feature. Must be used together with SERP Feature Link Value.',
+            },
+            {
+                displayName: 'SERP Feature Link Value',
+                name: 'serpFeatures2Value',
+                type: 'string',
+                default: '',
+                placeholder: 'sge,reviews',
+                description: 'Comma-separated SERP feature codes to check domain linkage for. Must be used together with SERP Feature Link Mode.',
+            },
         ],
     },
     {

package/dist/nodes/SeRanking/dataApi/operations/DomainAnalysisOperations.js

@@ -3,6 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DomainAnalysisOperations = DomainAnalysisOperations;
 const apiRequest_1 = require("../../utils/apiRequest");
 const validators_1 = require("../../utils/validators");
+function buildMultiKeywordFilter(csv) {
+    return csv
+        .split(',')
+        .map((w) => w.trim())
+        .filter(Boolean)
+        .map((word) => [{ type: 'contains', value: word }]);
+}
 async function DomainAnalysisOperations(index) {
     const operation = this.getNodeParameter('operation', index);
     let endpoint = '';
@@ -238,6 +245,22 @@ async function DomainAnalysisOperations(index) {
             if (additionalFields.intents && additionalFields.intents.length > 0) {
                 params['filter[intents]'] = additionalFields.intents.join(',');
             }
+            if (additionalFields.multiKeywordIncluded) {
+                params['filter[multi_keyword_included]'] = JSON.stringify(buildMultiKeywordFilter(additionalFields.multiKeywordIncluded));
+            }
+            if (additionalFields.multiKeywordExcluded) {
+                params['filter[multi_keyword_excluded]'] = JSON.stringify(buildMultiKeywordFilter(additionalFields.multiKeywordExcluded));
+            }
+            if (additionalFields.serpFeatures2Mode && additionalFields.serpFeatures2Value) {
+                params['filter[serp_features_2][mode]'] = additionalFields.serpFeatures2Mode;
+                additionalFields.serpFeatures2Value
+                    .split(',')
+                    .map((v) => v.trim())
+                    .filter(Boolean)
+                    .forEach((val, i) => {
+                    params[`filter[serp_features_2][value][${i}]`] = val;
+                });
+            }
             break;
         }
         case 'getKeywordsComparison': {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@seranking/n8n-nodes-seranking",
-    "version": "1.3.8",
+    "version": "1.3.9",
     "description": "n8n connector for SE Ranking API - AI Search, Backlinks, Domain Analysis, Keyword Research, and Website Audit",
     "license": "MIT",
     "homepage": "https://github.com/seranking/n8n-nodes-seranking",