@seranking/n8n-nodes-seranking 1.5.9 → 1.5.12

package/README.md

@@ -89,10 +89,9 @@ 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"
-3. Enter your **Data API Token** (required)
-4. Enter your **Project API Token** (optional — only if using Project API resources)
-5. Save
+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
 
 ### Docker Installation
 
@@ -163,14 +162,13 @@ To use this node, you need:
 ### Setting up credentials in n8n
 
 1. Open any workflow and add the **SE Ranking** node
-2. Click on **Create New Credential**
-3. Enter your **API Token (Data API)** — required
-4. Enter your **API Token (Project API)** — optional, only needed for Project API resources
-5. Click **Save**
+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**
 
-The node will automatically test your Data API credentials by making a test request to the SE Ranking API.
+Each credential is tested independently when saved. The node automatically routes requests to the correct API and credential based on the resource you select.
 
-> **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). The node automatically routes to the correct API based on the resource you select.
+> **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).
 
 ---
 
@@ -880,7 +878,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 Project API Token field is filled
+2. For Project API resources, ensure the SE Ranking Project API credential is configured
 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.d.ts

@@ -1,8 +1,9 @@
-import { ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
 export declare class SeRankingApi implements ICredentialType {
     name: string;
     displayName: string;
     documentationUrl: string;
     properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
     test: ICredentialTestRequest;
 }

package/dist/credentials/SeRankingApi.credentials.js

@@ -8,7 +8,7 @@ class SeRankingApi {
         this.documentationUrl = 'https://seranking.com/api-google-organic.html';
         this.properties = [
             {
-                displayName: 'API Token (Data API)',
+                displayName: 'API Token',
                 name: 'apiToken',
                 type: 'string',
                 typeOptions: {
@@ -16,27 +16,22 @@ class SeRankingApi {
                 },
                 default: '',
                 required: true,
-                description: 'Token for Data API — domain analysis, keywords, backlinks, SERP, etc.',
+                description: 'Your SE Ranking Data API token from the API Dashboard',
             },
-            {
-                displayName: 'API Token (Project API)',
-                name: 'projectApiToken',
-                type: 'string',
-                typeOptions: {
-                    password: true,
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'Authorization': '=Token {{$credentials.apiToken}}',
                 },
-                default: '',
-                description: 'Token for Project API — project management, competitors, audit, etc. Leave empty if not using Project API resources.',
             },
-        ];
+        };
         this.test = {
             request: {
                 baseURL: 'https://api.seranking.com/v1',
                 url: '/account/subscription',
                 method: 'GET',
-                headers: {
-                    'Authorization': '=Token {{$credentials.apiToken}}',
-                },
             },
         };
     }

package/dist/credentials/SeRankingProjectApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class SeRankingProjectApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/SeRankingProjectApi.credentials.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeRankingProjectApi = void 0;
+class SeRankingProjectApi {
+    constructor() {
+        this.name = 'seRankingProjectApi';
+        this.displayName = 'SE Ranking Project API';
+        this.documentationUrl = 'https://seranking.com/api-google-organic.html';
+        this.properties = [
+            {
+                displayName: 'API Token',
+                name: 'apiToken',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+                description: 'Your SE Ranking Project API token from the API Dashboard',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'Authorization': '=Token {{$credentials.apiToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: 'https://api4.seranking.com',
+                url: '/sites',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.SeRankingProjectApi = SeRankingProjectApi;

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

@@ -62,6 +62,42 @@ class SeRanking {
                 {
                     name: 'seRankingApi',
                     required: true,
+                    displayOptions: {
+                        show: {
+                            resource: [
+                                'aiSearch',
+                                'backlinks',
+                                'domainAnalysis',
+                                'keywordResearch',
+                                'serpClassic',
+                                'websiteAudit',
+                            ],
+                        },
+                    },
+                },
+                {
+                    name: 'seRankingProjectApi',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: [
+                                'accountSystem',
+                                'aiResultTracker',
+                                'analyticsTraffic',
+                                'backlinkChecker',
+                                'competitors',
+                                'generalData',
+                                'keywordGroups',
+                                'marketingPlan',
+                                'projectGroups',
+                                'projectManagement',
+                                'searchVolume',
+                                'subAccount',
+                                'urlTags',
+                                'websiteAuditProject',
+                            ],
+                        },
+                    },
                 },
             ],
             properties: [

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

@@ -302,6 +302,14 @@ exports.aiResultTrackerFields = [
             },
         },
         options: [
+            {
+                displayName: 'Group IDs',
+                name: 'groupIds',
+                type: 'string',
+                default: '',
+                placeholder: '12,18',
+                description: 'Comma-separated prompt group IDs to filter by',
+            },
             {
                 displayName: 'Limit',
                 name: 'limit',
@@ -333,6 +341,28 @@ exports.aiResultTrackerFields = [
         placeholder: 'best seo tool,seo rank tracker,website audit tool',
         description: 'Comma-separated list of keyword prompts to add (max 255 chars each)',
     },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['aiResultTracker'],
+                operation: ['addPrompts'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Group ID',
+                name: 'groupId',
+                type: 'number',
+                default: 0,
+                description: 'Target prompt group ID. Defaults to the site\'s default group.',
+            },
+        ],
+    },
     {
         displayName: 'Keyword-LLM Link IDs',
         name: 'k2siteLlmIds',
@@ -377,6 +407,14 @@ exports.aiResultTrackerFields = [
                 placeholder: '2026-01-31',
                 description: 'End date (YYYY-MM-DD). Defaults to current date.',
             },
+            {
+                displayName: 'Group IDs',
+                name: 'groupIds',
+                type: 'string',
+                default: '',
+                placeholder: '12,18',
+                description: 'Comma-separated prompt group IDs to filter by',
+            },
             {
                 displayName: 'Limit',
                 name: 'limit',
@@ -405,7 +443,7 @@ exports.aiResultTrackerFields = [
             },
         },
         default: 0,
-        description: 'Value of the <code>k2site_llm_id</code> field from List Prompts (the SE Ranking docs call this parameter <code>keyword_id</code>, but the endpoint actually expects <code>k2site_llm_id</code>)',
+        description: 'Value of the <code>k2site_llm_id</code> field from List Prompts',
     },
     {
         displayName: 'Additional Fields',

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

@@ -79,13 +79,22 @@ async function AiResultTrackerOperations(index) {
                 query.limit = additionalFields.limit;
             if (additionalFields.offset !== undefined)
                 query.offset = additionalFields.offset;
-            return await apiRequest_1.apiRequest.call(this, 'GET', `/sites/${siteId}/airt/llm/${llmId}/prompts`, {}, query, index);
+            let endpoint = `/sites/${siteId}/airt/llm/${llmId}/prompts`;
+            if (additionalFields.groupIds) {
+                const ids = additionalFields.groupIds.split(',').map((id) => id.trim());
+                endpoint += '?' + ids.map((id) => `group_ids[]=${encodeURIComponent(id)}`).join('&');
+            }
+            return await apiRequest_1.apiRequest.call(this, 'GET', endpoint, {}, query, index);
         }
         case 'addPrompts': {
             const llmId = this.getNodeParameter('llmId', index);
             const promptsStr = this.getNodeParameter('prompts', index);
             const prompts = promptsStr.split(',').map((p) => p.trim()).filter((p) => p.length > 0);
-            return await apiRequest_1.apiRequest.call(this, 'POST', `/sites/${siteId}/airt/llm/${llmId}/prompts`, { prompts }, {}, index);
+            const additionalFields = this.getNodeParameter('additionalFields', index, {});
+            const body = { prompts };
+            if (additionalFields.groupId)
+                body.group_id = additionalFields.groupId;
+            return await apiRequest_1.apiRequest.call(this, 'POST', `/sites/${siteId}/airt/llm/${llmId}/prompts`, body, {}, index);
         }
         case 'deletePrompts': {
             const llmId = this.getNodeParameter('llmId', index);
@@ -106,7 +115,12 @@ async function AiResultTrackerOperations(index) {
                 query.limit = additionalFields.limit;
             if (additionalFields.offset !== undefined)
                 query.offset = additionalFields.offset;
-            return await apiRequest_1.apiRequest.call(this, 'GET', `/sites/${siteId}/airt/llm/${llmId}/prompts/rankings`, {}, query, index);
+            let endpoint = `/sites/${siteId}/airt/llm/${llmId}/prompts/rankings`;
+            if (additionalFields.groupIds) {
+                const ids = additionalFields.groupIds.split(',').map((id) => id.trim());
+                endpoint += '?' + ids.map((id) => `group_ids[]=${encodeURIComponent(id)}`).join('&');
+            }
+            return await apiRequest_1.apiRequest.call(this, 'GET', endpoint, {}, query, index);
         }
         case 'getPromptAnswer': {
             const llmId = this.getNodeParameter('llmId', index);

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

@@ -5,7 +5,7 @@ const n8n_workflow_1 = require("n8n-workflow");
 let lastRequestTime = 0;
 const MIN_REQUEST_INTERVAL = 300;
 async function apiRequest(method, endpoint, body = {}, query = {}, itemIndex = 0) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
     const now = Date.now();
     const timeSinceLastRequest = now - lastRequestTime;
     if (timeSinceLastRequest < MIN_REQUEST_INTERVAL) {
@@ -29,23 +29,12 @@ async function apiRequest(method, endpoint, body = {}, query = {}, itemIndex = 0
         resource = '';
     }
     const isDataApi = DATA_API_RESOURCES.has(resource);
-    const credentials = await this.getCredentials('seRankingApi');
-    const token = isDataApi
-        ? credentials.apiToken
-        : credentials.projectApiToken;
-    if (!token) {
-        throw new n8n_workflow_1.NodeOperationError(this.getNode(), isDataApi
-            ? 'Data API token not configured. Add your Data API token in the SE Ranking credentials.'
-            : 'Project API token not configured. Add your Project API token in the SE Ranking credentials.', { itemIndex });
-    }
+    const credentialType = isDataApi ? 'seRankingApi' : 'seRankingProjectApi';
     const httpMethod = method.toUpperCase();
     const options = {
         method: httpMethod,
         timeout: 60000,
         url: '',
-        headers: {
-            'Authorization': `Token ${token}`,
-        },
     };
     if (query._fullUrl) {
         options.url = endpoint;
@@ -117,12 +106,24 @@ async function apiRequest(method, endpoint, body = {}, query = {}, itemIndex = 0
         }
     }
     try {
-        const response = await this.helpers.httpRequest(options);
+        const response = await this.helpers.httpRequestWithAuthentication.call(this, credentialType, options);
         return response;
     }
     catch (error) {
-        const errorData = ((_a = error.response) === null || _a === void 0 ? void 0 : _a.body) || ((_b = error.response) === null || _b === void 0 ? void 0 : _b.data) || {};
-        const statusCode = error.statusCode || ((_c = error.response) === null || _c === void 0 ? void 0 : _c.status) || 'Unknown';
+        if (((_a = error.message) === null || _a === void 0 ? void 0 : _a.includes('does not require credentials')) || ((_b = error.message) === null || _b === void 0 ? void 0 : _b.includes('No credentials'))) {
+            const missingCred = isDataApi
+                ? 'SE Ranking API credential not configured'
+                : 'SE Ranking Project API credential not configured';
+            const missingDesc = isDataApi
+                ? 'This resource requires the SE Ranking API credential. Click the node, find the "SE Ranking API" credential slot, and create/select your Data API token.'
+                : 'This resource requires the SE Ranking Project API credential. Click the node, find the "SE Ranking Project API" credential slot, and create/select your Project API token.';
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), missingCred, {
+                itemIndex,
+                description: missingDesc,
+            });
+        }
+        const errorData = ((_c = error.response) === null || _c === void 0 ? void 0 : _c.body) || ((_d = error.response) === null || _d === void 0 ? void 0 : _d.data) || {};
+        const statusCode = error.statusCode || ((_e = error.response) === null || _e === void 0 ? void 0 : _e.status) || 'Unknown';
         let errorMessage = 'Unknown error occurred';
         let errorDescription = '';
         if (statusCode === 400) {
@@ -143,7 +144,7 @@ async function apiRequest(method, endpoint, body = {}, query = {}, itemIndex = 0
         }
         else if (statusCode === 429) {
             errorMessage = 'Rate Limit Exceeded';
-            const retryAfter = ((_e = (_d = error.response) === null || _d === void 0 ? void 0 : _d.headers) === null || _e === void 0 ? void 0 : _e['retry-after']) || ((_g = (_f = error.response) === null || _f === void 0 ? void 0 : _f.headers) === null || _g === void 0 ? void 0 : _g['Retry-After']) || 60;
+            const retryAfter = ((_g = (_f = error.response) === null || _f === void 0 ? void 0 : _f.headers) === null || _g === void 0 ? void 0 : _g['retry-after']) || ((_j = (_h = error.response) === null || _h === void 0 ? void 0 : _h.headers) === null || _j === void 0 ? void 0 : _j['Retry-After']) || 60;
             errorDescription = `Too many requests. SE Ranking requires you to wait ${retryAfter} seconds. The node now automatically adds 300ms delay between requests, but SE Ranking may have additional hourly/daily limits.`;
         }
         else if (statusCode === 500 || statusCode === 502 || statusCode === 503) {
@@ -158,7 +159,7 @@ async function apiRequest(method, endpoint, body = {}, query = {}, itemIndex = 0
             errorMessage = 'Connection Failed';
             errorDescription = 'Cannot reach SE Ranking API. Check your internet connection';
         }
-        else if (error.code === 'ETIMEDOUT' || ((_h = error.message) === null || _h === void 0 ? void 0 : _h.includes('timeout'))) {
+        else if (error.code === 'ETIMEDOUT' || ((_k = error.message) === null || _k === void 0 ? void 0 : _k.includes('timeout'))) {
             errorMessage = 'Request Timeout';
             errorDescription = 'Request exceeded 60 seconds. Try with fewer items or use a faster operation';
         }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@seranking/n8n-nodes-seranking",
-    "version": "1.5.9",
+    "version": "1.5.12",
     "description": "n8n connector for SE Ranking API - AI Search, Backlinks, Domain Analysis, Keyword Research, Website Audit, Project Management, Project Groups, AI Result Tracker, Keyword Groups, Competitors, URL Tags, Analytics Traffic, Account System, Sub-Account Management, General Data, Marketing Plan, Backlink Checker, Search Volume",
     "license": "MIT",
     "homepage": "https://github.com/seranking/n8n-nodes-seranking",
@@ -51,7 +51,8 @@
             "dist/nodes/SeRanking/SeRanking.node.js"
         ],
         "credentials": [
-            "dist/credentials/SeRankingApi.credentials.js"
+            "dist/credentials/SeRankingApi.credentials.js",
+            "dist/credentials/SeRankingProjectApi.credentials.js"
         ]
     },
     "scripts": {