@seranking/n8n-nodes-seranking 2.0.3 → 2.0.5

package/README.md

@@ -1,6 +1,6 @@
 # n8n-nodes-seranking
 
-n8n community node for [SE Ranking](https://seranking.com/)'s unified API — 190 operations across 21 resources: AI Search, Backlinks, Domain Analysis, Keyword Research, SERP Classic, Website Audits, Project Management, Competitors, Backlink Checker, Sub-Accounts, and more.
+n8n community node for [SE Ranking](https://seranking.com/)'s unified API — 194 operations across 21 resources: AI Search, Backlinks, Domain Analysis, Keyword Research, SERP Classic, Website Audits, Project Management, Competitors, Backlink Checker, Sub-Accounts, and more.
 
 SE Ranking is a comprehensive SEO platform providing keyword research, competitor analysis, website audits, backlink monitoring, and AI search visibility tracking.
 
@@ -187,7 +187,7 @@ If you're upgrading and have saved credentials of type `seRankingProjectApi`, yo
 
 ## Operations
 
-This node provides access to **21 SE Ranking resources** with **190 total operations** on the unified API:
+This node provides access to **21 SE Ranking resources** with **194 total operations** on the unified API:
 
 ### Data API (6 resources, 65 operations)
 
@@ -279,7 +279,7 @@ This node provides access to **21 SE Ranking resources** with **190 total operat
 
 ### Project API (14 resources, 107 operations)
 
-### Project Management (17 operations)
+### Project Management (20 operations)
 
 - List Projects - Get all projects
 - Add Project - Create a new project
@@ -386,7 +386,7 @@ This node provides access to **21 SE Ranking resources** with **190 total operat
 - Set Task Status - Mark task as complete/incomplete
 - Delete Task - Remove a custom task
 
-### Website Audit (Project) (12 operations)
+### Website Audit (Project) (21 operations)
 
 - Create Audit - Launch a website audit
 - List Audits - Get all audits
@@ -739,7 +739,7 @@ For detailed API specifications, visit [SE Ranking API Documentation](https://se
 * 🐛 **FIX: Update Audit Title** — was returning 400 since April 2026, now works
 * 🐛 **FIX: Run Position Check** — /api/ prefix bug resolved by unification
 * ⚠️ **Deprecated: Search Volume + Volume Regions** — 6 ops return 404 on unified host (friendly error with guidance)
-* 📊 **Total: 190 operations across 21 resources**
+* 📊 **Total: 192 operations across 21 resources**
 
 ### v1.5.13
 
@@ -826,7 +826,7 @@ For detailed API specifications, visit [SE Ranking API Documentation](https://se
 
 ## Features
 
-✅ **190 Operations** - Comprehensive coverage across 21 resources (unified API)
+✅ **192 Operations** - Comprehensive coverage across 21 resources (unified API)
 
 ✅ **Pingback Webhooks** - Event-driven notifications for SERP task completion
 

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

@@ -151,6 +151,12 @@ exports.backlinksOperations = [
                 description: 'Get distribution of domain authority scores among linking domains',
                 action: 'Get domain authority distribution',
             },
+            {
+                name: 'Get Domain Authority History',
+                value: 'getDomainAuthorityHistory',
+                description: 'Get historical Domain InLink Rank values for the target domain',
+                action: 'Get domain authority history',
+            },
             {
                 name: 'Get Page Authority',
                 value: 'getPageAuthority',
@@ -197,6 +203,7 @@ exports.backlinksFields = [
                     'getAuthority',
                     'getDomainAuthority',
                     'getDomainAuthorityDistribution',
+                    'getDomainAuthorityHistory',
                     'getPageAuthority',
                     'getPageAuthorityHistory',
                 ],
@@ -300,6 +307,7 @@ exports.backlinksFields = [
                     'getRefDomainsHistory',
                     'getRefDomainsHistoryCount',
                     'getPageAuthorityHistory',
+                    'getDomainAuthorityHistory',
                 ],
             },
         },
@@ -322,6 +330,7 @@ exports.backlinksFields = [
                     'getRefDomainsHistory',
                     'getRefDomainsHistoryCount',
                     'getPageAuthorityHistory',
+                    'getDomainAuthorityHistory',
                 ],
             },
         },

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

@@ -306,6 +306,19 @@ async function BacklinksOperations(index) {
             params.target = target;
             break;
         }
+        case 'getDomainAuthorityHistory': {
+            const target = this.getNodeParameter('target', index);
+            const dateFrom = this.getNodeParameter('dateFrom', index);
+            const dateTo = this.getNodeParameter('dateTo', index);
+            if (!(0, validators_1.validateDateFormat)(dateFrom) || !(0, validators_1.validateDateFormat)(dateTo)) {
+                throw new Error('Date must be in YYYY-MM-DD format');
+            }
+            endpoint = '/backlinks/authority/domain/history';
+            params.target = target;
+            params.date_from = dateFrom;
+            params.date_to = dateTo;
+            break;
+        }
         case 'getPageAuthority': {
             const target = this.getNodeParameter('target', index);
             endpoint = '/backlinks/authority/page';

package/dist/nodes/SeRanking/projectApi/descriptions/GeneralDataDescription.js

@@ -25,6 +25,12 @@ exports.generalDataOperations = [
                 description: 'Get a list of supported languages for Google',
                 action: 'List languages for Google',
             },
+            {
+                name: 'List Regions for Google',
+                value: 'listGoogleRegions',
+                description: 'Get a list of Google regions (region ID + name) for location targeting',
+                action: 'List regions for Google',
+            },
             {
                 name: 'List Search Engines',
                 value: 'listSearchEngines',

package/dist/nodes/SeRanking/projectApi/descriptions/ProjectManagementDescription.js

@@ -133,6 +133,12 @@ exports.projectManagementOperations = [
                 description: 'Remove a search engine configuration from a project',
                 action: 'Delete search engine from project',
             },
+            {
+                name: 'Edit Keyword',
+                value: 'editKeyword',
+                description: 'Update fields of an existing keyword in a project',
+                action: 'Edit keyword',
+            },
             {
                 name: 'Get Ads Chart',
                 value: 'getAds',
@@ -230,6 +236,7 @@ exports.projectManagementFields = [
                     'runRecheck',
                     'listCheckDates',
                     'getRankingTrends',
+                    'editKeyword',
                 ],
             },
         },
@@ -709,6 +716,83 @@ exports.projectManagementFields = [
         placeholder: '1,2,3',
         description: 'Comma-separated keyword IDs to delete',
     },
+    {
+        displayName: 'Keyword ID',
+        name: 'editKeywordId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['projectManagement'],
+                operation: ['editKeyword'],
+            },
+        },
+        default: 0,
+        description: 'Unique ID of the keyword to edit',
+    },
+    {
+        displayName: 'Update Fields',
+        name: 'updateFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['projectManagement'],
+                operation: ['editKeyword'],
+            },
+        },
+        description: 'Fields to update. Provide at least one (the API rejects an empty update, and a comment alone is not accepted — include Keyword or Group ID).',
+        options: [
+            {
+                displayName: 'Keyword',
+                name: 'keyword',
+                type: 'string',
+                default: '',
+                description: 'The keyword text',
+            },
+            {
+                displayName: 'Group ID',
+                name: 'group_id',
+                type: 'number',
+                default: 0,
+                description: 'Keyword group ID to move the keyword into',
+            },
+            {
+                displayName: 'Target URL',
+                name: 'target_url',
+                type: 'string',
+                default: '',
+                description: 'Target landing-page URL for the keyword',
+            },
+            {
+                displayName: 'Strict URL Match',
+                name: 'is_strict',
+                type: 'options',
+                options: [
+                    { name: 'No', value: 0 },
+                    { name: 'Yes', value: 1 },
+                ],
+                default: 0,
+                description: 'Whether to require a strict match of the target URL',
+            },
+            {
+                displayName: 'Comment',
+                name: 'comment',
+                type: 'string',
+                default: '',
+                description: 'Free-text note for the keyword',
+            },
+            {
+                displayName: 'Search Engine IDs',
+                name: 'site_engine_ids',
+                type: 'string',
+                default: '',
+                placeholder: '1149319,1149320',
+                description: 'Comma-separated search engine (site_engine_id) values to assign',
+            },
+        ],
+    },
     {
         displayName: 'Keyword ID',
         name: 'keywordId',

package/dist/nodes/SeRanking/projectApi/descriptions/WebsiteAuditDescription.js

@@ -133,6 +133,12 @@ exports.websiteAuditOperations = [
                 description: 'Remove an uploaded custom page list',
                 action: 'Delete audit source pages',
             },
+            {
+                name: 'Add Audit Source Pages',
+                value: 'addAuditSourcePages',
+                description: 'Upload a .txt list of URLs (one per line) as a custom page list',
+                action: 'Add audit source pages',
+            },
         ],
         default: 'listAudits',
     },
@@ -146,7 +152,7 @@ exports.websiteAuditFields = [
         displayOptions: {
             show: {
                 resource: ['websiteAuditProject'],
-                operation: ['getStatus', 'getReport', 'getPages', 'getPagesByIssue', 'getIssues', 'getLinks', 'getHistory', 'updateTitle', 'deleteAudit', 'recheckAudit', 'getAuditSettings', 'updateAuditSettings', 'resetAuditSettings', 'listAuditSitemaps', 'addAuditSitemap', 'deleteAuditSitemap', 'listAuditSourcePages', 'deleteAuditSourcePages'],
+                operation: ['getStatus', 'getReport', 'getPages', 'getPagesByIssue', 'getIssues', 'getLinks', 'getHistory', 'updateTitle', 'deleteAudit', 'recheckAudit', 'getAuditSettings', 'updateAuditSettings', 'resetAuditSettings', 'listAuditSitemaps', 'addAuditSitemap', 'deleteAuditSitemap', 'listAuditSourcePages', 'deleteAuditSourcePages', 'addAuditSourcePages'],
             },
         },
         default: 0,
@@ -485,4 +491,18 @@ exports.websiteAuditFields = [
         default: '',
         description: 'ID of the uploaded page list to remove (from List Audit Source Pages)',
     },
+    {
+        displayName: 'Input Binary Field',
+        name: 'binaryPropertyName',
+        type: 'string',
+        required: true,
+        default: 'data',
+        displayOptions: {
+            show: {
+                resource: ['websiteAuditProject'],
+                operation: ['addAuditSourcePages'],
+            },
+        },
+        description: 'Name of the binary property holding the UTF-8 .txt file (one URL per line) to upload',
+    },
 ];

package/dist/nodes/SeRanking/projectApi/operations/GeneralDataOperations.js

@@ -11,6 +11,9 @@ async function GeneralDataOperations(index) {
         case 'listGoogleLangs': {
             return await apiRequest_1.apiRequest.call(this, 'GET', '/project-management/system/google/languages', {}, {}, index);
         }
+        case 'listGoogleRegions': {
+            return await apiRequest_1.apiRequest.call(this, 'GET', '/project-management/system/google/regions', {}, {}, index);
+        }
         case 'listVolumeRegions': {
             throw new Error('listVolumeRegions: The /system/volume-regions endpoint is not available under the unified API (HTTP 404 as of 2026-05-22). ' +
                 'SE Ranking has not yet published a replacement in the unified docs. ' +

package/dist/nodes/SeRanking/projectApi/operations/ProjectManagementOperations.js

@@ -145,6 +145,29 @@ async function ProjectManagementOperations(index) {
             await apiRequest_1.apiRequest.call(this, 'DELETE', '/project-management/keywords', {}, query, index);
             return { success: true, deleted: true, keyword_ids: keywordIds };
         }
+        case 'editKeyword': {
+            const siteId = this.getNodeParameter('siteId', index);
+            const keywordId = this.getNodeParameter('editKeywordId', index);
+            const updateFields = this.getNodeParameter('updateFields', index, {});
+            const body = {};
+            if (updateFields.keyword)
+                body.keyword = updateFields.keyword;
+            if (updateFields.group_id)
+                body.group_id = updateFields.group_id;
+            if (updateFields.target_url)
+                body.target_url = updateFields.target_url;
+            if (updateFields.is_strict !== undefined)
+                body.is_strict = updateFields.is_strict;
+            if (updateFields.comment !== undefined && updateFields.comment !== '')
+                body.comment = updateFields.comment;
+            if (updateFields.site_engine_ids) {
+                body.site_engine_ids = String(updateFields.site_engine_ids)
+                    .split(',')
+                    .map((v) => parseInt(v.trim(), 10));
+            }
+            await apiRequest_1.apiRequest.call(this, 'PATCH', `/project-management/keywords?site_id=${siteId}&keyword_id=${keywordId}`, body, {}, index);
+            return { success: true, keyword_id: keywordId, updated: Object.keys(body) };
+        }
         case 'getStats': {
             const siteId = this.getNodeParameter('siteId', index);
             return await apiRequest_1.apiRequest.call(this, 'GET', '/project-management/sites/summary', {}, { site_id: siteId }, index);

package/dist/nodes/SeRanking/projectApi/operations/WebsiteAuditOperations.js

@@ -154,14 +154,28 @@ async function WebsiteAuditOperations(index) {
         }
         case 'listAuditSourcePages': {
             const auditId = this.getNodeParameter('auditId', index);
-            return await apiRequest_1.apiRequest.call(this, 'GET', '/project-management/audits/source_pages', {}, { audit_id: auditId }, index);
+            return await apiRequest_1.apiRequest.call(this, 'GET', '/project-management/audits/source-pages', {}, { audit_id: auditId }, index);
         }
         case 'deleteAuditSourcePages': {
             const auditId = this.getNodeParameter('auditId', index);
             const listId = this.getNodeParameter('sourcePagesListId', index);
-            await apiRequest_1.apiRequest.call(this, 'DELETE', '/project-management/audits/source_pages', {}, { audit_id: auditId, list_id: listId }, index);
+            await apiRequest_1.apiRequest.call(this, 'DELETE', '/project-management/audits/source-pages', {}, { audit_id: auditId, list_id: listId }, index);
             return { success: true, deleted: true, list_id: listId };
         }
+        case 'addAuditSourcePages': {
+            const auditId = this.getNodeParameter('auditId', index);
+            const binaryPropertyName = this.getNodeParameter('binaryPropertyName', index);
+            const binaryData = this.helpers.assertBinaryData(index, binaryPropertyName);
+            const buffer = await this.helpers.getBinaryDataBuffer(index, binaryPropertyName);
+            return await apiRequest_1.apiRequest.call(this, 'POST', `/project-management/audits/source-pages?audit_id=${auditId}`, {
+                _fileUpload: {
+                    fieldName: 'file',
+                    filename: binaryData.fileName || 'source-pages.txt',
+                    contentType: 'text/plain',
+                    data: buffer,
+                },
+            }, {}, index);
+        }
         default:
             throw new Error(`Unknown Website Audit operation: ${operation}`);
     }

package/dist/nodes/SeRanking/utils/apiRequest.js

@@ -62,7 +62,21 @@ async function apiRequest(method, endpoint, body = {}, query = {}, itemIndex = 0
         }
     }
     if (method !== 'GET' && body != null && (Array.isArray(body) || Object.keys(body).length > 0)) {
-        if (body.keywords && Array.isArray(body.keywords)) {
+        if (body._fileUpload) {
+            const f = body._fileUpload;
+            const boundary = `----serankingFormBoundary${Date.now().toString(16)}`;
+            const preamble = Buffer.from(`--${boundary}\r\n` +
+                `Content-Disposition: form-data; name="${f.fieldName}"; filename="${f.filename}"\r\n` +
+                `Content-Type: ${f.contentType}\r\n\r\n`);
+            const epilogue = Buffer.from(`\r\n--${boundary}--\r\n`);
+            options.body = Buffer.concat([preamble, f.data, epilogue]);
+            options.headers = {
+                ...options.headers,
+                'Content-Type': `multipart/form-data; boundary=${boundary}`,
+            };
+            options.json = false;
+        }
+        else if (body.keywords && Array.isArray(body.keywords)) {
             const formDataBody = {};
             body.keywords.forEach((kw, index) => {
                 formDataBody[`keywords[${index}]`] = kw;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@seranking/n8n-nodes-seranking",
-    "version": "2.0.3",
-    "description": "n8n community node for SE Ranking's unified API — 190 operations across 21 resources: AI Search, Backlinks, Domain Analysis, Keyword Research, SERP Classic, Website Audits, Project Management, Competitors, Backlink Checker, Sub-Accounts, and more",
+    "version": "2.0.5",
+    "description": "n8n community node for SE Ranking's unified API — 194 operations across 21 resources: AI Search, Backlinks, Domain Analysis, Keyword Research, SERP Classic, Website Audits, Project Management, Competitors, Backlink Checker, Sub-Accounts, and more",
     "license": "MIT",
     "homepage": "https://github.com/seranking/n8n-nodes-seranking",
     "author": {