@seranking/n8n-nodes-seranking 1.5.12 → 2.0.0

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`).
 
 ---
 

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.d.ts

@@ -1,5 +1,10 @@
-import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+import { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
 export declare class SeRanking implements INodeType {
     description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getAuditIssueCodes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
     execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
 }

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

@@ -11,6 +11,7 @@ const SerpClassicDescription_1 = require("./dataApi/descriptions/SerpClassicDesc
 const ProjectManagementDescription_1 = require("./projectApi/descriptions/ProjectManagementDescription");
 const ProjectGroupsDescription_1 = require("./projectApi/descriptions/ProjectGroupsDescription");
 const AiResultTrackerDescription_1 = require("./projectApi/descriptions/AiResultTrackerDescription");
+const AirtGroupsDescription_1 = require("./projectApi/descriptions/AirtGroupsDescription");
 const KeywordGroupsDescription_1 = require("./projectApi/descriptions/KeywordGroupsDescription");
 const CompetitorsDescription_1 = require("./projectApi/descriptions/CompetitorsDescription");
 const UrlTagsDescription_1 = require("./projectApi/descriptions/UrlTagsDescription");
@@ -31,6 +32,7 @@ const SerpClassicOperations_1 = require("./dataApi/operations/SerpClassicOperati
 const ProjectManagementOperations_1 = require("./projectApi/operations/ProjectManagementOperations");
 const ProjectGroupsOperations_1 = require("./projectApi/operations/ProjectGroupsOperations");
 const AiResultTrackerOperations_1 = require("./projectApi/operations/AiResultTrackerOperations");
+const AirtGroupsOperations_1 = require("./projectApi/operations/AirtGroupsOperations");
 const KeywordGroupsOperations_1 = require("./projectApi/operations/KeywordGroupsOperations");
 const CompetitorsOperations_1 = require("./projectApi/operations/CompetitorsOperations");
 const UrlTagsOperations_1 = require("./projectApi/operations/UrlTagsOperations");
@@ -62,42 +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',
-                                'analyticsTraffic',
-                                'backlinkChecker',
-                                'competitors',
-                                'generalData',
-                                'keywordGroups',
-                                'marketingPlan',
-                                'projectGroups',
-                                'projectManagement',
-                                'searchVolume',
-                                'subAccount',
-                                'urlTags',
-                                'websiteAuditProject',
-                            ],
-                        },
-                    },
                 },
             ],
             properties: [
@@ -117,6 +83,11 @@ class SeRanking {
                             value: 'aiResultTracker',
                             description: 'Track brand visibility across AI search engines',
                         },
+                        {
+                            name: 'AIRT Groups',
+                            value: 'airtGroups',
+                            description: 'Manage AI Result Tracker prompt groups',
+                        },
                         {
                             name: 'AI Search',
                             value: 'aiSearch',
@@ -228,6 +199,8 @@ class SeRanking {
                 ...ProjectGroupsDescription_1.projectGroupsFields,
                 ...AiResultTrackerDescription_1.aiResultTrackerOperations,
                 ...AiResultTrackerDescription_1.aiResultTrackerFields,
+                ...AirtGroupsDescription_1.airtGroupsOperations,
+                ...AirtGroupsDescription_1.airtGroupsFields,
                 ...KeywordGroupsDescription_1.keywordGroupsOperations,
                 ...KeywordGroupsDescription_1.keywordGroupsFields,
                 ...CompetitorsDescription_1.competitorsOperations,
@@ -252,6 +225,35 @@ class SeRanking {
                 ...SearchVolumeDescription_1.searchVolumeFields,
             ],
         };
+        this.methods = {
+            loadOptions: {
+                async getAuditIssueCodes() {
+                    const auditId = this.getCurrentNodeParameter('auditId');
+                    if (!auditId) {
+                        return [];
+                    }
+                    const response = await this.helpers.httpRequestWithAuthentication.call(this, 'seRankingApi', {
+                        method: 'GET',
+                        url: 'https://api.seranking.com/v1/project-management/audits/report',
+                        qs: { audit_id: auditId },
+                        json: true,
+                    });
+                    const codes = new Set();
+                    const sections = (response && response.sections) || [];
+                    for (const section of sections) {
+                        const props = section && section.props;
+                        if (props && typeof props === 'object') {
+                            for (const key of Object.keys(props)) {
+                                codes.add(key);
+                            }
+                        }
+                    }
+                    return Array.from(codes)
+                        .sort()
+                        .map((code) => ({ name: code, value: code }));
+                },
+            },
+        };
     }
     async execute() {
         const items = this.getInputData();
@@ -288,6 +290,9 @@ class SeRanking {
                     case 'aiResultTracker':
                         responseData = await AiResultTrackerOperations_1.AiResultTrackerOperations.call(this, i);
                         break;
+                    case 'airtGroups':
+                        responseData = await AirtGroupsOperations_1.AirtGroupsOperations.call(this, i);
+                        break;
                     case 'keywordGroups':
                         responseData = await KeywordGroupsOperations_1.KeywordGroupsOperations.call(this, i);
                         break;

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/AirtGroupsDescription.d.ts

@@ -0,0 +1,3 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const airtGroupsOperations: INodeProperties[];
+export declare const airtGroupsFields: INodeProperties[];

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

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.airtGroupsFields = exports.airtGroupsOperations = void 0;
+exports.airtGroupsOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+            },
+        },
+        options: [
+            {
+                name: 'Change Group Order',
+                value: 'changeGroupOrder',
+                description: 'Move a group to a new position in the site group order',
+                action: 'Change prompt group order',
+            },
+            {
+                name: 'Create Prompt Group',
+                value: 'createPromptGroup',
+                description: 'Create a new prompt group for a site',
+                action: 'Create prompt group',
+            },
+            {
+                name: 'Delete All Prompts in Group',
+                value: 'deleteAllPromptsInGroup',
+                description: 'Remove every prompt currently assigned to the group (group itself is kept)',
+                action: 'Delete all prompts in group',
+            },
+            {
+                name: 'Delete Prompt Group',
+                value: 'deletePromptGroup',
+                description: 'Delete a prompt group; its prompts move to the default group',
+                action: 'Delete prompt group',
+            },
+            {
+                name: 'List Prompt Groups',
+                value: 'listPromptGroups',
+                description: 'List prompt groups for a site, optionally filtered by LLM engine',
+                action: 'List prompt groups',
+            },
+            {
+                name: 'Move All Prompts Between Groups',
+                value: 'moveAllPromptsBetweenGroups',
+                description: 'Move every prompt from one group to another',
+                action: 'Move all prompts between groups',
+            },
+            {
+                name: 'Move Prompts to Group',
+                value: 'movePromptsToGroup',
+                description: 'Move a specific set of prompts into a target group',
+                action: 'Move prompts to group',
+            },
+            {
+                name: 'Rename Prompt Group',
+                value: 'renamePromptGroup',
+                description: 'Update the name of an existing prompt group',
+                action: 'Rename prompt group',
+            },
+        ],
+        default: 'listPromptGroups',
+    },
+];
+exports.airtGroupsFields = [
+    {
+        displayName: 'Site ID',
+        name: 'siteId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+            },
+        },
+        default: 0,
+        description: 'Unique project (site) ID',
+    },
+    {
+        displayName: 'Group ID',
+        name: 'groupId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: [
+                    'renamePromptGroup',
+                    'deletePromptGroup',
+                    'changeGroupOrder',
+                    'deleteAllPromptsInGroup',
+                    'movePromptsToGroup',
+                ],
+            },
+        },
+        default: 0,
+        description: 'Prompt group ID',
+    },
+    {
+        displayName: 'Group Name',
+        name: 'groupName',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['createPromptGroup'],
+            },
+        },
+        default: '',
+        placeholder: 'Brand queries',
+        description: 'Non-empty, max 255 characters, unique within the site',
+    },
+    {
+        displayName: 'New Group Name',
+        name: 'groupName',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['renamePromptGroup'],
+            },
+        },
+        default: '',
+        placeholder: 'Updated group name',
+        description: 'New name for the prompt group; non-empty, max 255 characters',
+    },
+    {
+        displayName: 'Place Before Group ID',
+        name: 'beforeId',
+        type: 'number',
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['changeGroupOrder'],
+            },
+        },
+        default: 0,
+        description: 'Place the group immediately before this neighbour. Provide exactly ONE of Before or After — leave the other at 0',
+    },
+    {
+        displayName: 'Place After Group ID',
+        name: 'afterId',
+        type: 'number',
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['changeGroupOrder'],
+            },
+        },
+        default: 0,
+        description: 'Place the group immediately after this neighbour. Provide exactly ONE of Before or After — leave the other at 0',
+    },
+    {
+        displayName: 'Keyword-LLM Link IDs',
+        name: 'k2siteLlmIds',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['movePromptsToGroup'],
+            },
+        },
+        default: '',
+        placeholder: '2164555,2164556,2164557',
+        description: 'Comma-separated list of integer k2site_llm_id values (from List Prompts)',
+    },
+    {
+        displayName: 'Source Group ID',
+        name: 'fromGroupId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['moveAllPromptsBetweenGroups'],
+            },
+        },
+        default: 0,
+        description: 'Group whose prompts will be moved',
+    },
+    {
+        displayName: 'Target Group ID',
+        name: 'toGroupId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['moveAllPromptsBetweenGroups'],
+            },
+        },
+        default: 0,
+        description: 'Destination group; must differ from Source Group ID',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['listPromptGroups'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Include Prompt Counts',
+                name: 'keysCount',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to include keys_count on every group',
+            },
+            {
+                displayName: 'Filter by Site LLM IDs',
+                name: 'siteLlmIds',
+                type: 'string',
+                default: '',
+                placeholder: '1130467,1130468',
+                description: 'Comma-separated list of site_llm_id values to filter groups by',
+            },
+        ],
+    },
+];

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',
+            },
+        ],
+    },
 ];