@seranking/n8n-nodes-seranking 1.5.7 → 1.5.9

package/README.md

@@ -90,8 +90,8 @@ Open `http://localhost:5678` and add the SE Ranking node to your workflow.
 
 1. Add SE Ranking node
 2. Click "Create New Credential"
-3. Enter your API Token
-4. Select "Data API" as API Type
+3. Enter your **Data API Token** (required)
+4. Enter your **Project API Token** (optional — only if using Project API resources)
 5. Save
 
 ### Docker Installation
@@ -164,15 +164,13 @@ To use this node, you need:
 
 1. Open any workflow and add the **SE Ranking** node
 2. Click on **Create New Credential**
-3. Enter your **API Token**
-4. Select **API Type**:
-   - **Data API** — SEO research data (domains, keywords, backlinks, SERP)
-   - **Project API** — Project management, tracking, audits, sub-accounts
+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**
 
-The node will automatically test your credentials by making a test request to the SE Ranking API.
+The node will automatically test your Data API credentials by making a test request to the SE Ranking API.
 
-> **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).
+> **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.
 
 ---
 
@@ -184,7 +182,7 @@ The node will automatically test your credentials by making a test request to th
 
 ## Operations
 
-This node provides access to **20 SE Ranking resources** with **171 total operations** across two API types:
+This node provides access to **20 SE Ranking resources** with **172 total operations** across two API types:
 
 ### Data API (6 resources, 65 operations)
 
@@ -274,7 +272,7 @@ This node provides access to **20 SE Ranking resources** with **171 total operat
 
 ---
 
-### Project API (14 resources, 106 operations)
+### Project API (14 resources, 107 operations)
 
 ### Project Management (17 operations)
 
@@ -304,7 +302,7 @@ This node provides access to **20 SE Ranking resources** with **171 total operat
 - Delete Group - Remove a project group
 - Move Projects to Group - Move projects into a group
 
-### AI Result Tracker (13 operations)
+### AI Result Tracker (14 operations)
 
 - Get Site Brand - Get brand name for a site
 - Save Site Brand - Set brand name for a site
@@ -319,6 +317,7 @@ This node provides access to **20 SE Ranking resources** with **171 total operat
 - Add Prompts - Add keywords/prompts to LLM engine
 - Delete Prompts - Remove prompts from LLM engine
 - Get Prompt Rankings - Prompt ranking data over time
+- Get Prompt Answer - Full AI answer text, cited sources, detected brands, and organic URLs (Google AI Overview) for a tracked prompt on a given date
 
 ### Keyword Groups (5 operations)
 
@@ -718,7 +717,12 @@ For detailed API specifications, visit [SE Ranking API Documentation](https://se
 
 ## Version History
 
-### v1.3.6 (Current)
+### v1.5.8 (Current)
+
+* ✅ **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.
+
+### v1.3.6
 
 * 🔧 **FIX: Rate limiting compatibility** - Replaced setTimeout with n8n-workflow sleep function for n8n verified node compliance
 
@@ -793,7 +797,7 @@ For detailed API specifications, visit [SE Ranking API Documentation](https://se
 
 ## Features
 
-✅ **171 Operations** - Comprehensive coverage across 20 resources (Data API + Project API)
+✅ **172 Operations** - Comprehensive coverage across 20 resources (Data API + Project API)
 
 ✅ **Pingback Webhooks** - Event-driven notifications for SERP task completion
 
@@ -876,7 +880,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. Ensure API Type is set to "Data API"
+2. For Project API resources, ensure the Project API Token field is filled
 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,9 +1,8 @@
-import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+import { 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',
+                displayName: 'API Token (Data API)',
                 name: 'apiToken',
                 type: 'string',
                 typeOptions: {
@@ -16,41 +16,27 @@ class SeRankingApi {
                 },
                 default: '',
                 required: true,
-                description: 'Your SE Ranking API token from the API Dashboard',
+                description: 'Token for Data API — domain analysis, keywords, backlinks, SERP, etc.',
             },
             {
-                displayName: 'API Type',
-                name: 'apiType',
-                type: 'options',
-                options: [
-                    {
-                        name: 'Data API',
-                        value: 'data',
-                        description: 'Used for positions, rankings, keyword data.',
-                    },
-                    {
-                        name: 'Project API',
-                        value: 'project',
-                        description: 'Used for managing sites, accounts, etc.',
-                    },
-                ],
-                default: 'data',
-                description: 'Choose which SE Ranking API you want to connect to',
-            },
-        ];
-        this.authenticate = {
-            type: 'generic',
-            properties: {
-                headers: {
-                    'Authorization': '=Token {{$credentials.apiToken}}',
+                displayName: 'API Token (Project API)',
+                name: 'projectApiToken',
+                type: 'string',
+                typeOptions: {
+                    password: true,
                 },
+                default: '',
+                description: 'Token for Project API — project management, competitors, audit, etc. Leave empty if not using Project API resources.',
             },
-        };
+        ];
         this.test = {
             request: {
-                baseURL: '={{$credentials.apiType === "project" ? "https://api4.seranking.com" : "https://api.seranking.com/v1"}}',
-                url: '={{$credentials.apiType === "project" ? "/sites" : "/account/subscription"}}',
+                baseURL: 'https://api.seranking.com/v1',
+                url: '/account/subscription',
                 method: 'GET',
+                headers: {
+                    'Authorization': '=Token {{$credentials.apiToken}}',
+                },
             },
         };
     }

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

@@ -50,7 +50,7 @@ class SeRanking {
             icon: 'file:seranking.svg',
             group: ['transform'],
             version: 1,
-            subtitle: '={{$parameter["apiType"] === "projectApi" ? "Project" : "Data"}} — {{$parameter["resource"] + ": " + $parameter["operation"]}}',
+            subtitle: '={{$parameter["resource"] + ": " + $parameter["operation"]}}',
             description: 'Interact with SE Ranking API for SEO data',
             defaults: {
                 name: 'SE Ranking',
@@ -66,76 +66,70 @@ class SeRanking {
             ],
             properties: [
                 {
-                    displayName: 'API Type',
-                    name: 'apiType',
+                    displayName: 'Resource',
+                    name: 'resource',
                     type: 'options',
                     noDataExpression: true,
                     options: [
                         {
-                            name: 'Data API',
-                            value: 'dataApi',
-                            description: 'SEO research data (domains, keywords, backlinks, etc.)',
+                            name: 'Account System',
+                            value: 'accountSystem',
+                            description: 'Account balance, profile, and subscription info',
                         },
                         {
-                            name: 'Project API',
-                            value: 'projectApi',
-                            description: 'Project management, groups, and AI result tracking',
+                            name: 'AI Result Tracker',
+                            value: 'aiResultTracker',
+                            description: 'Track brand visibility across AI search engines',
                         },
-                    ],
-                    default: 'dataApi',
-                },
-                {
-                    displayName: 'Resource',
-                    name: 'resource',
-                    type: 'options',
-                    noDataExpression: true,
-                    displayOptions: {
-                        show: { apiType: ['dataApi'] },
-                    },
-                    options: [
                         {
                             name: 'AI Search',
                             value: 'aiSearch',
                             description: 'LLM visibility and AI search data',
                         },
+                        {
+                            name: 'Analytics Traffic',
+                            value: 'analyticsTraffic',
+                            description: 'Google Search Console data and SEO potential',
+                        },
+                        {
+                            name: 'Backlink Checker',
+                            value: 'backlinkChecker',
+                            description: 'Backlink monitoring, disavow, and groups',
+                        },
                         {
                             name: 'Backlinks',
                             value: 'backlinks',
                             description: 'Backlink analysis and authority metrics',
                         },
+                        {
+                            name: 'Competitors',
+                            value: 'competitors',
+                            description: 'Manage competitors and retrieve ranking data',
+                        },
                         {
                             name: 'Domain Analysis',
                             value: 'domainAnalysis',
                             description: 'Domain keyword rankings and competitor analysis',
                         },
                         {
-                            name: 'Keyword Research',
-                            value: 'keywordResearch',
-                            description: 'Keyword metrics, volume, CPC, and related keywords',
+                            name: 'General Data',
+                            value: 'generalData',
+                            description: 'System search engines, languages, regions, and keyword volume',
                         },
                         {
-                            name: 'SERP Classic',
-                            value: 'serpClassic',
-                            description: 'SERP tracking and results retrieval',
+                            name: 'Keyword Groups',
+                            value: 'keywordGroups',
+                            description: 'Manage keyword groups within a project',
                         },
                         {
-                            name: 'Website Audit',
-                            value: 'websiteAudit',
-                            description: 'Site crawling, technical SEO, and on-page analysis',
+                            name: 'Keyword Research',
+                            value: 'keywordResearch',
+                            description: 'Keyword metrics, volume, CPC, and related keywords',
                         },
-                    ],
-                    default: 'domainAnalysis',
-                },
-                {
-                    displayName: 'Resource',
-                    name: 'resource',
-                    type: 'options',
-                    noDataExpression: true,
-                    options: [
                         {
-                            name: 'Project Management',
-                            value: 'projectManagement',
-                            description: 'Manage projects and search engine configurations',
+                            name: 'Marketing Plan',
+                            value: 'marketingPlan',
+                            description: 'Marketing plan checklists and tasks',
                         },
                         {
                             name: 'Project Groups',
@@ -143,34 +137,19 @@ class SeRanking {
                             description: 'Manage project groups within the account',
                         },
                         {
-                            name: 'AI Result Tracker',
-                            value: 'aiResultTracker',
-                            description: 'Track brand visibility across AI search engines',
-                        },
-                        {
-                            name: 'Keyword Groups',
-                            value: 'keywordGroups',
-                            description: 'Manage keyword groups within a project',
-                        },
-                        {
-                            name: 'Competitors',
-                            value: 'competitors',
-                            description: 'Manage competitors and retrieve ranking data',
-                        },
-                        {
-                            name: 'URL Tags',
-                            value: 'urlTags',
-                            description: 'Manage landing page tags within a site',
+                            name: 'Project Management',
+                            value: 'projectManagement',
+                            description: 'Manage projects and search engine configurations',
                         },
                         {
-                            name: 'Analytics Traffic',
-                            value: 'analyticsTraffic',
-                            description: 'Google Search Console data and SEO potential',
+                            name: 'Search Volume',
+                            value: 'searchVolume',
+                            description: 'Keyword search volume check requests',
                         },
                         {
-                            name: 'Account System',
-                            value: 'accountSystem',
-                            description: 'Account balance, profile, and subscription info',
+                            name: 'SERP Classic',
+                            value: 'serpClassic',
+                            description: 'SERP tracking and results retrieval',
                         },
                         {
                             name: 'Sub-Account Management',
@@ -178,32 +157,22 @@ class SeRanking {
                             description: 'Manage sub-accounts, sharing, and permissions',
                         },
                         {
-                            name: 'General Data',
-                            value: 'generalData',
-                            description: 'System search engines, languages, regions, and keyword volume',
+                            name: 'URL Tags',
+                            value: 'urlTags',
+                            description: 'Manage landing page tags within a site',
                         },
                         {
-                            name: 'Marketing Plan',
-                            value: 'marketingPlan',
-                            description: 'Marketing plan checklists and tasks',
+                            name: 'Website Audit (Data)',
+                            value: 'websiteAudit',
+                            description: 'Site crawling, technical SEO, and on-page analysis',
                         },
                         {
-                            name: 'Website Audit',
+                            name: 'Website Audit (Project)',
                             value: 'websiteAuditProject',
                             description: 'Technical SEO audits lifecycle management',
                         },
-                        {
-                            name: 'Backlink Checker',
-                            value: 'backlinkChecker',
-                            description: 'Backlink monitoring, disavow, and groups',
-                        },
-                        {
-                            name: 'Search Volume',
-                            value: 'searchVolume',
-                            description: 'Keyword search volume check requests',
-                        },
                     ],
-                    default: 'projectManagement',
+                    default: 'domainAnalysis',
                 },
                 ...AiSearchDescription_1.aiSearchOperations,
                 ...AiSearchDescription_1.aiSearchFields,

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

@@ -55,6 +55,12 @@ exports.aiResultTrackerOperations = [
                 description: 'Get tracking status and progress for an LLM engine',
                 action: 'Get LLM status',
             },
+            {
+                name: 'Get Prompt Answer',
+                value: 'getPromptAnswer',
+                description: 'Get the full AI answer text, sources, brands, and organic URLs for a tracked prompt',
+                action: 'Get prompt answer',
+            },
             {
                 name: 'Get Prompt Rankings',
                 value: 'getPromptRankings',
@@ -127,6 +133,7 @@ exports.aiResultTrackerFields = [
                     'addPrompts',
                     'deletePrompts',
                     'getPromptRankings',
+                    'getPromptAnswer',
                 ],
             },
         },
@@ -262,7 +269,7 @@ exports.aiResultTrackerFields = [
                 name: 'from',
                 type: 'string',
                 default: '',
-                placeholder: '2024-01-01',
+                placeholder: '2026-01-01',
                 description: 'Start date (YYYY-MM-DD). Defaults to current date.',
             },
             {
@@ -270,7 +277,7 @@ exports.aiResultTrackerFields = [
                 name: 'to',
                 type: 'string',
                 default: '',
-                placeholder: '2024-01-31',
+                placeholder: '2026-01-31',
                 description: 'End date (YYYY-MM-DD). Defaults to current date.',
             },
             {
@@ -359,7 +366,7 @@ exports.aiResultTrackerFields = [
                 name: 'dateFrom',
                 type: 'string',
                 default: '',
-                placeholder: '2024-01-01',
+                placeholder: '2026-01-01',
                 description: 'Start date (YYYY-MM-DD). Defaults to current date.',
             },
             {
@@ -367,7 +374,7 @@ exports.aiResultTrackerFields = [
                 name: 'dateTo',
                 type: 'string',
                 default: '',
-                placeholder: '2024-01-31',
+                placeholder: '2026-01-31',
                 description: 'End date (YYYY-MM-DD). Defaults to current date.',
             },
             {
@@ -386,4 +393,41 @@ exports.aiResultTrackerFields = [
             },
         ],
     },
+    {
+        displayName: 'Keyword-LLM Link ID',
+        name: 'k2siteLlmId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['aiResultTracker'],
+                operation: ['getPromptAnswer'],
+            },
+        },
+        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>)',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['aiResultTracker'],
+                operation: ['getPromptAnswer'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Date',
+                name: 'date',
+                type: 'string',
+                default: '',
+                placeholder: '2026-04-01',
+                description: 'Date of the cached answer (YYYY-MM-DD). Defaults to current date. Full text retained for last 30 days only.',
+            },
+        ],
+    },
 ];

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

@@ -108,6 +108,15 @@ async function AiResultTrackerOperations(index) {
                 query.offset = additionalFields.offset;
             return await apiRequest_1.apiRequest.call(this, 'GET', `/sites/${siteId}/airt/llm/${llmId}/prompts/rankings`, {}, query, index);
         }
+        case 'getPromptAnswer': {
+            const llmId = this.getNodeParameter('llmId', index);
+            const k2siteLlmId = this.getNodeParameter('k2siteLlmId', index);
+            const additionalFields = this.getNodeParameter('additionalFields', index, {});
+            const query = {};
+            if (additionalFields.date)
+                query.date = additionalFields.date;
+            return await apiRequest_1.apiRequest.call(this, 'GET', `/sites/${siteId}/airt/llm/${llmId}/prompts/${k2siteLlmId}/answer`, {}, query, index);
+        }
         default:
             throw new Error(`Unknown AI Result Tracker operation: ${operation}`);
     }

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

@@ -13,12 +13,39 @@ async function apiRequest(method, endpoint, body = {}, query = {}, itemIndex = 0
         await (0, n8n_workflow_1.sleep)(waitTime);
     }
     lastRequestTime = Date.now();
+    const DATA_API_RESOURCES = new Set([
+        'aiSearch',
+        'backlinks',
+        'domainAnalysis',
+        'keywordResearch',
+        'serpClassic',
+        'websiteAudit',
+    ]);
+    let resource;
+    try {
+        resource = this.getNodeParameter('resource', itemIndex);
+    }
+    catch {
+        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 httpMethod = method.toUpperCase();
     const options = {
         method: httpMethod,
         timeout: 60000,
         url: '',
+        headers: {
+            'Authorization': `Token ${token}`,
+        },
     };
     if (query._fullUrl) {
         options.url = endpoint;
@@ -28,16 +55,9 @@ async function apiRequest(method, endpoint, body = {}, query = {}, itemIndex = 0
         options.json = false;
     }
     else {
-        let baseUrl;
-        if (endpoint.startsWith('/site-audit/') || endpoint.startsWith('/backlinks/') || endpoint.startsWith('/ai-search/') || endpoint.startsWith('/domain/') || endpoint.startsWith('/keywords/')) {
-            baseUrl = 'https://api.seranking.com/v1';
-        }
-        else if (credentials.apiType === 'project') {
-            baseUrl = 'https://api4.seranking.com';
-        }
-        else {
-            baseUrl = 'https://api.seranking.com/v1';
-        }
+        const baseUrl = isDataApi
+            ? 'https://api.seranking.com/v1'
+            : 'https://api4.seranking.com';
         options.url = `${baseUrl}${endpoint}`;
         options.json = true;
     }
@@ -97,7 +117,7 @@ async function apiRequest(method, endpoint, body = {}, query = {}, itemIndex = 0
         }
     }
     try {
-        const response = await this.helpers.httpRequestWithAuthentication.call(this, 'seRankingApi', options);
+        const response = await this.helpers.httpRequest(options);
         return response;
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@seranking/n8n-nodes-seranking",
-    "version": "1.5.7",
+    "version": "1.5.9",
     "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",
@@ -79,6 +79,5 @@
     "engines": {
         "node": ">=18.0.0"
     },
-    "dependencies": {
-    }
+    "dependencies": {}
 }