@seranking/n8n-nodes-seranking 1.5.13 → 2.0.1

package/README.md

@@ -89,9 +89,10 @@ Open `http://localhost:5678` and add the SE Ranking node to your workflow.
 ### Step 4: Configure Credentials
 
 1. Add SE Ranking node
-2. Click "Create New Credential" for **SE Ranking API** (Data API) — enter your Data API token
-3. (Optional) Click "Create New Credential" for **SE Ranking Project API** — enter your Project API token
-4. Save
+2. Click "Create New Credential" for **SE Ranking API** — enter your API token
+3. Save
+
+> **v2.0.0 note:** SE Ranking unified its two APIs (Data API + Project API) onto a single host (`api.seranking.com`) with a single token in 2026-05. The node now uses one credential type for everything. If you're upgrading from v1.x, see the Migration section below.
 
 ### Docker Installation
 
@@ -156,19 +157,25 @@ Then restart n8n
 
 To use this node, you need:
 
-1. **SE Ranking Account** - Sign up at [seranking.com](https://seranking.com/)
-2. **API Token** - Generate from your [SE Ranking API Dashboard](https://online.seranking.com/admin.api.dashboard.html)
+1. **SE Ranking Account** — Sign up at [seranking.com](https://seranking.com/)
+2. **API Token** — Generate from your [SE Ranking API Dashboard](https://online.seranking.com/admin.api.dashboard.html)
 
 ### Setting up credentials in n8n
 
 1. Open any workflow and add the **SE Ranking** node
-2. In the **SE Ranking API** credential slot, click "Create New Credential" and enter your **Data API token** — required for all Data API resources
-3. In the **SE Ranking Project API** credential slot, click "Create New Credential" and enter your **Project API token** — only needed for Project API resources
-4. Click **Save**
+2. In the **SE Ranking API** credential slot, click "Create New Credential" and enter your API token
+3. Click **Save** — the credential is tested by hitting `GET /v1/account/subscription`
+
+### Migrating from v1.x
+
+v1.x used two separate credential types (`seRankingApi` for Data API and `seRankingProjectApi` for Project API) with two different base URLs and two different tokens. As of v2.0.0:
 
-Each credential is tested independently when saved. The node automatically routes requests to the correct API and credential based on the resource you select.
+- One credential type covers everything: **SE Ranking API**
+- One token works against all endpoints — get the unified token from the [API Dashboard](https://online.seranking.com/admin.api.dashboard.html)
+- Old base URL `api4.seranking.com` is deprecated; everything now lives under `api.seranking.com/v1`
+- Project API endpoints moved under `/v1/project-management/...` path prefix
 
-> **Note:** Data API and Project API use different tokens. Data API tokens are UUID format; Project API tokens are 40-character hex format. Get both from your [SE Ranking API Dashboard](https://online.seranking.com/admin.api.dashboard.html).
+If you're upgrading and have saved credentials of type `seRankingProjectApi`, you'll need to re-save them as `seRankingApi` on each affected node. The v1.5.13 release is preserved on npm for rollback (`npm install @seranking/n8n-nodes-seranking@1.5.13`).
 
 ---
 
@@ -176,11 +183,11 @@ Each credential is tested independently when saved. The node automatically route
 
 - **n8n version**: 1.0.0 or higher
 - **Node.js version**: 18.x or higher
-- **SE Ranking API**: v1 (Data API) + Project API (`api4.seranking.com`)
+- **SE Ranking API**: unified host `api.seranking.com/v1`
 
 ## Operations
 
-This node provides access to **20 SE Ranking resources** with **172 total operations** across two API types:
+This node provides access to **21 SE Ranking resources** with **190 total operations** on the unified API:
 
 ### Data API (6 resources, 65 operations)
 
@@ -696,33 +703,57 @@ return dominated;
 
 ## API Documentation
 
-This node implements the following SE Ranking APIs:
+This node implements the SE Ranking unified API (`api.seranking.com/v1`):
 
-**Data API** (`api.seranking.com/v1`):
-- [AI Search API](https://seranking.com/api/data/ai-search/)
-- [Backlinks API](https://seranking.com/api/data/backlinks/)
-- [Domain Analysis API](https://seranking.com/api/data/domain-analysis/)
-- [Keyword Research API](https://seranking.com/api/data/keyword-research/)
-- [Website Audit API](https://seranking.com/api/data/website-audit/)
-- [SERP API](https://seranking.com/api/data/serp/)
+**Data API resources:**
+- [AI Search](https://seranking.com/api/data/ai-search/)
+- [Backlinks](https://seranking.com/api/data/backlinks/)
+- [Domain Analysis](https://seranking.com/api/data/domain-analysis/)
+- [Keyword Research](https://seranking.com/api/data/keyword-research/)
+- [Website Audit](https://seranking.com/api/data/website-audit/)
 
-**Project API** (`api4.seranking.com`):
-- [Project API Documentation](https://seranking.com/api/project/)
+**Project API resources** (under `/v1/project-management/`):
+- [Project Management](https://seranking.com/api/project/project-management/)
+- [AI Result Tracker](https://seranking.com/api/project/ai-result-tracker/)
+- [Competitors](https://seranking.com/api/project/competitors/)
+- [Backlink Checker](https://seranking.com/api/project/backlink-checker/)
+- [Website Audit (Project)](https://seranking.com/api/project/audit/)
+- [And more...](https://seranking.com/api/project/)
 
-For detailed API specifications, visit [SE Ranking API Documentation](https://seranking.com/api.html).
+For detailed API specifications, visit [SE Ranking API Documentation](https://seranking.com/api/).
 
 ---
 
 ## Version History
 
-### v1.5.8 (Current)
+### v2.0.1 (Current)
+
+* 🐛 **FIX: Keyword Groups → Move Keywords** — was returning 400; API expects body key `keywords_ids` (plural), not `keyword_ids`
+* 🐛 **FIX: Sub-Account → Share Projects** — `site_ids` must be a single integer per request; now loops one call per site so multiple IDs work
+* 🐛 **FIX: Backlink Checker → Move to Group** — added missing Target Group ID field to the UI
+
+### v2.0.0
+
+* **BREAKING: API Unification** — single credential, single host (`api.seranking.com`). Old `seRankingProjectApi` credential type removed. Re-save affected nodes with unified `SE Ranking API` credential.
+* ✅ **10 new operations** — List Check Dates, Get Ranking Trends, Audit Settings (get/update/reset), Audit Sitemaps (list/add/delete), Audit Source Pages (list/delete), AIRT Rankings group mode
+* 🐛 **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**
+
+### v1.5.13
+
+* ✅ **NEW: AIRT Groups resource (8 operations)** — manage AI Result Tracker prompt groups
+* ✅ **NEW: Dynamic Issue Code dropdown** — Get Pages by Issue auto-populates from audit report
+* 🐛 **FIX: Run Position Check URL** — removed incorrect `/api/` prefix
+
+### v1.5.8
 
-* ✅ **NEW: Get Prompt Answer (AI Result Tracker)** - Returns full AI answer text, cited source URLs, detected brand mentions, and (for Google AI Overview) top organic URLs for a tracked prompt on a given date. Cost: 0 credits.
-* 📝 **Note on SE Ranking docs quirk** - The endpoint's path param is documented as `keyword_id` but actually requires `k2site_llm_id` from `List Prompts`. The node field is labeled accordingly.
+* ✅ **NEW: Get Prompt Answer (AI Result Tracker)** - Returns full AI answer text, cited source URLs, detected brand mentions, and organic URLs for a tracked prompt.
 
 ### v1.3.6
 
-* 🔧 **FIX: Rate limiting compatibility** - Replaced setTimeout with n8n-workflow sleep function for n8n verified node compliance
+* 🔧 **FIX: Rate limiting compatibility** - Replaced setTimeout with n8n-workflow sleep function
 
 ### v1.3.5 
 
@@ -795,7 +826,7 @@ For detailed API specifications, visit [SE Ranking API Documentation](https://se
 
 ## Features
 
-✅ **172 Operations** - Comprehensive coverage across 20 resources (Data API + Project API)
+✅ **190 Operations** - Comprehensive coverage across 21 resources (unified API)
 
 ✅ **Pingback Webhooks** - Event-driven notifications for SERP task completion
 
@@ -878,7 +909,7 @@ For more details, see [n8n's rate limiting documentation](https://docs.n8n.io/in
 **Solution**:
 
 1. Verify API token is correct (copy from SE Ranking dashboard)
-2. For Project API resources, ensure the SE Ranking Project API credential is configured
+2. Ensure your SE Ranking API credential has the correct unified token
 3. Check token hasn't expired
 4. Regenerate token in SE Ranking dashboard if needed
 5. Test credentials using the "Test" button in n8n

package/dist/credentials/SeRankingApi.credentials.js

@@ -5,7 +5,7 @@ class SeRankingApi {
     constructor() {
         this.name = 'seRankingApi';
         this.displayName = 'SE Ranking API';
-        this.documentationUrl = 'https://seranking.com/api-google-organic.html';
+        this.documentationUrl = 'https://seranking.com/api/';
         this.properties = [
             {
                 displayName: 'API Token',
@@ -16,7 +16,7 @@ class SeRankingApi {
                 },
                 default: '',
                 required: true,
-                description: 'Your SE Ranking Data API token from the API Dashboard',
+                description: 'Your SE Ranking API token from the API Dashboard. As of 2026-05 a single unified token authenticates both Data API and Project API endpoints.',
             },
         ];
         this.authenticate = {

package/dist/nodes/SeRanking/SeRanking.node.js

@@ -64,43 +64,6 @@ class SeRanking {
                 {
                     name: 'seRankingApi',
                     required: true,
-                    displayOptions: {
-                        show: {
-                            resource: [
-                                'aiSearch',
-                                'backlinks',
-                                'domainAnalysis',
-                                'keywordResearch',
-                                'serpClassic',
-                                'websiteAudit',
-                            ],
-                        },
-                    },
-                },
-                {
-                    name: 'seRankingProjectApi',
-                    required: true,
-                    displayOptions: {
-                        show: {
-                            resource: [
-                                'accountSystem',
-                                'aiResultTracker',
-                                'airtGroups',
-                                'analyticsTraffic',
-                                'backlinkChecker',
-                                'competitors',
-                                'generalData',
-                                'keywordGroups',
-                                'marketingPlan',
-                                'projectGroups',
-                                'projectManagement',
-                                'searchVolume',
-                                'subAccount',
-                                'urlTags',
-                                'websiteAuditProject',
-                            ],
-                        },
-                    },
                 },
             ],
             properties: [
@@ -269,9 +232,10 @@ class SeRanking {
                     if (!auditId) {
                         return [];
                     }
-                    const response = await this.helpers.httpRequestWithAuthentication.call(this, 'seRankingProjectApi', {
+                    const response = await this.helpers.httpRequestWithAuthentication.call(this, 'seRankingApi', {
                         method: 'GET',
-                        url: `https://api4.seranking.com/audit/${auditId}/report`,
+                        url: 'https://api.seranking.com/v1/project-management/audits/report',
+                        qs: { audit_id: auditId },
                         json: true,
                     });
                     const codes = new Set();

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

@@ -429,6 +429,17 @@ exports.aiResultTrackerFields = [
                 default: 0,
                 description: 'Offset from the beginning of the list',
             },
+            {
+                displayName: 'Mode',
+                name: 'mode',
+                type: 'options',
+                options: [
+                    { name: 'Per Prompt (Default)', value: '' },
+                    { name: 'Aggregated by Group', value: 'groups' },
+                ],
+                default: '',
+                description: 'Set to "groups" to get aggregated time-series per prompt group (mention_presence/link_presence as percentages) instead of per-prompt rankings',
+            },
         ],
     },
     {

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

@@ -510,6 +510,20 @@ exports.backlinkCheckerFields = [
         default: '',
         description: 'New name for the backlink group',
     },
+    {
+        displayName: 'Target Group ID',
+        name: 'targetGroupId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['backlinkChecker'],
+                operation: ['moveToGroup'],
+            },
+        },
+        default: 0,
+        description: 'Destination backlink group ID to move backlinks/groups into',
+    },
     {
         displayName: 'Backlink IDs',
         name: 'backlinkIds',

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

@@ -187,6 +187,18 @@ exports.projectManagementOperations = [
                 description: 'Set a ranking position for a keyword on a date',
                 action: 'Set manual keyword position',
             },
+            {
+                name: 'List Check Dates',
+                value: 'listCheckDates',
+                description: 'Get actual ranking check dates for a project',
+                action: 'List check dates',
+            },
+            {
+                name: 'Get Ranking Trends',
+                value: 'getRankingTrends',
+                description: 'Get ranking trend time series (avg position, visibility, top10)',
+                action: 'Get ranking trends',
+            },
         ],
         default: 'listProjects',
     },
@@ -216,6 +228,8 @@ exports.projectManagementFields = [
                     'deleteKeywords',
                     'setManualPosition',
                     'runRecheck',
+                    'listCheckDates',
+                    'getRankingTrends',
                 ],
             },
         },
@@ -807,4 +821,117 @@ exports.projectManagementFields = [
         default: '[{"site_engine_id":1,"keyword_id":2}]',
         description: 'JSON array of objects: { site_engine_id, keyword_id }',
     },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['projectManagement'],
+                operation: ['listCheckDates'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Site Engine ID',
+                name: 'siteEngineId',
+                type: 'number',
+                default: 0,
+                description: 'Limit to a single search engine',
+            },
+            {
+                displayName: 'Date From',
+                name: 'dateFrom',
+                type: 'string',
+                default: '',
+                placeholder: '2026-01-01',
+                description: 'Start date (YYYY-MM-DD). Defaults to 7 days ago.',
+            },
+            {
+                displayName: 'Date To',
+                name: 'dateTo',
+                type: 'string',
+                default: '',
+                placeholder: '2026-01-31',
+                description: 'End date (YYYY-MM-DD). Defaults to today.',
+            },
+        ],
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['projectManagement'],
+                operation: ['getRankingTrends'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Site Engine ID',
+                name: 'siteEngineId',
+                type: 'number',
+                default: 0,
+                description: 'Limit to a single search engine (drops the cross-engine average row)',
+            },
+            {
+                displayName: 'Date From',
+                name: 'dateFrom',
+                type: 'string',
+                default: '',
+                placeholder: '2026-01-01',
+                description: 'Start date (YYYY-MM-DD). Defaults to 7 days ago.',
+            },
+            {
+                displayName: 'Date To',
+                name: 'dateTo',
+                type: 'string',
+                default: '',
+                placeholder: '2026-01-31',
+                description: 'End date (YYYY-MM-DD). Defaults to today.',
+            },
+            {
+                displayName: 'Metric Type',
+                name: 'metricType',
+                type: 'options',
+                options: [
+                    { name: 'Average Position', value: 'avg_pos' },
+                    { name: 'Visibility (Raw Score)', value: 'visibility' },
+                    { name: 'Visibility (%)', value: 'visibility_percent' },
+                    { name: 'Top 10 (Count)', value: 'top10' },
+                    { name: 'Top 10 (%)', value: 'top10_percent' },
+                ],
+                default: 'avg_pos',
+                description: 'Which ranking metric to retrieve',
+            },
+            {
+                displayName: 'Group ID',
+                name: 'groupId',
+                type: 'number',
+                default: 0,
+                description: 'Filter to a keyword group',
+            },
+            {
+                displayName: 'Keyword IDs',
+                name: 'keywordsIds',
+                type: 'string',
+                default: '',
+                placeholder: '123,456,789',
+                description: 'Comma-separated keyword IDs to filter',
+            },
+            {
+                displayName: 'Tag IDs',
+                name: 'tagsIds',
+                type: 'string',
+                default: '',
+                placeholder: '1,2,3',
+                description: 'Comma-separated landing-page tag IDs to filter',
+            },
+        ],
+    },
 ];

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

@@ -85,6 +85,54 @@ exports.websiteAuditOperations = [
                 description: 'Update the title of an audit',
                 action: 'Update audit title',
             },
+            {
+                name: 'Get Audit Settings',
+                value: 'getAuditSettings',
+                description: 'Get the full configuration of an audit',
+                action: 'Get audit settings',
+            },
+            {
+                name: 'Update Audit Settings',
+                value: 'updateAuditSettings',
+                description: 'Partially update audit configuration',
+                action: 'Update audit settings',
+            },
+            {
+                name: 'Reset Audit Settings',
+                value: 'resetAuditSettings',
+                description: 'Restore all audit settings to defaults',
+                action: 'Reset audit settings',
+            },
+            {
+                name: 'List Audit Sitemaps',
+                value: 'listAuditSitemaps',
+                description: 'List configured sitemaps for an audit',
+                action: 'List audit sitemaps',
+            },
+            {
+                name: 'Add Audit Sitemap',
+                value: 'addAuditSitemap',
+                description: 'Register a sitemap URL as a crawl source',
+                action: 'Add audit sitemap',
+            },
+            {
+                name: 'Delete Audit Sitemap',
+                value: 'deleteAuditSitemap',
+                description: 'Remove a sitemap from crawl sources',
+                action: 'Delete audit sitemap',
+            },
+            {
+                name: 'List Audit Source Pages',
+                value: 'listAuditSourcePages',
+                description: 'List uploaded custom page lists',
+                action: 'List audit source pages',
+            },
+            {
+                name: 'Delete Audit Source Pages',
+                value: 'deleteAuditSourcePages',
+                description: 'Remove an uploaded custom page list',
+                action: 'Delete audit source pages',
+            },
         ],
         default: 'listAudits',
     },
@@ -98,7 +146,7 @@ exports.websiteAuditFields = [
         displayOptions: {
             show: {
                 resource: ['websiteAuditProject'],
-                operation: ['getStatus', 'getReport', 'getPages', 'getPagesByIssue', 'getIssues', 'getLinks', 'getHistory', 'updateTitle', 'deleteAudit', 'recheckAudit'],
+                operation: ['getStatus', 'getReport', 'getPages', 'getPagesByIssue', 'getIssues', 'getLinks', 'getHistory', 'updateTitle', 'deleteAudit', 'recheckAudit', 'getAuditSettings', 'updateAuditSettings', 'resetAuditSettings', 'listAuditSitemaps', 'addAuditSitemap', 'deleteAuditSitemap', 'listAuditSourcePages', 'deleteAuditSourcePages'],
             },
         },
         default: 0,
@@ -379,4 +427,62 @@ exports.websiteAuditFields = [
         default: '',
         description: 'New title for the audit report (max 300 characters)',
     },
+    {
+        displayName: 'Settings JSON',
+        name: 'settingsJson',
+        type: 'string',
+        typeOptions: { rows: 5 },
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['websiteAuditProject'],
+                operation: ['updateAuditSettings'],
+            },
+        },
+        default: '{}',
+        description: 'JSON object of settings to update (partial update — only send changed fields). E.g. {"max_pages": 5000, "schedule_type": "week"}',
+    },
+    {
+        displayName: 'Sitemap URL',
+        name: 'sitemapUrl',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['websiteAuditProject'],
+                operation: ['addAuditSitemap'],
+            },
+        },
+        default: '',
+        placeholder: 'https://example.com/sitemap.xml',
+        description: 'Absolute URL of the sitemap to register as a crawl source',
+    },
+    {
+        displayName: 'Sitemap ID',
+        name: 'sitemapId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['websiteAuditProject'],
+                operation: ['deleteAuditSitemap'],
+            },
+        },
+        default: 0,
+        description: 'ID of the sitemap to remove (from List Audit Sitemaps)',
+    },
+    {
+        displayName: 'Source Pages List ID',
+        name: 'sourcePagesListId',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['websiteAuditProject'],
+                operation: ['deleteAuditSourcePages'],
+            },
+        },
+        default: '',
+        description: 'ID of the uploaded page list to remove (from List Audit Source Pages)',
+    },
 ];

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

@@ -6,10 +6,10 @@ async function AccountSystemOperations(index) {
     const operation = this.getNodeParameter('operation', index);
     switch (operation) {
         case 'getBalance': {
-            return await apiRequest_1.apiRequest.call(this, 'GET', '/account/balance', {}, {}, index);
+            return await apiRequest_1.apiRequest.call(this, 'GET', '/account/subscription', {}, {}, index);
         }
         case 'getProfile': {
-            return await apiRequest_1.apiRequest.call(this, 'GET', '/account/profile', {}, {}, index);
+            return await apiRequest_1.apiRequest.call(this, 'GET', '/project-management/users/me', {}, {}, index);
         }
         case 'getSubscription': {
             return await apiRequest_1.apiRequest.call(this, 'GET', '/account/subscription', {}, {}, index);