@seranking/n8n-nodes-seranking 1.5.7 → 1.5.8

package/README.md

@@ -184,7 +184,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 +274,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 +304,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 +319,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 +719,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 +799,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
 

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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@seranking/n8n-nodes-seranking",
-    "version": "1.5.7",
+    "version": "1.5.8",
     "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",