n8n-nodes-apivault-website-traffic-database 0.2.1 → 0.3.0

package/README.md

@@ -1,64 +1,11 @@
-# n8n-nodes-apivault-website-traffic-database
+# Websites by Traffic Volume 2026 — n8n node
 
-An [n8n](https://n8n.io) community node for **Websites by Traffic Volume 2026**, powered by the [`apivault_labs/website-traffic-database` Apify Actor](https://apify.com/apivault_labs/website-traffic-database).
+Calls the hosted [Apify Actor](https://apify.com/apivault_labs/website-traffic-database). Requires your own Apify credential; Apify run charges apply.
 
-The reverse of SimilarWeb: instead of one domain's stats, get every website in a traffic range. Filter 40M+ sites by monthly visits, category, country, rank, traffic channel, engagement, growth, or the keywords they rank for. A cheaper SimilarWeb/Semrush alternative for bulk site discovery. $5/1K.
+Install `n8n-nodes-apivault-website-traffic-database` through Settings → Community nodes → Install in self-hosted n8n.
 
-The node is a thin connector: collection, analysis, retries and billing run in the hosted Actor. It contains no private scraper implementation or embedded credentials.
+## Upgrade compatibility
 
-## Installation
+Existing node names, credential type and input parameter names are retained. Existing version 1 workflows keep their previous charge behavior unless an event cap is selected. New version 2 nodes default to a $0.05 event charge cap and 1,000 downloaded rows; platform usage can be charged separately. Select Read Existing Run and provide the Run ID to resume without starting a paid duplicate. Full output includes run metadata, SUMMARY and ERRORS when available. Dataset rows retain their original fields and paired input item. Actor build is latest.
 
-1. Open **Settings → Community Nodes** in your n8n instance.
-2. Select **Install**.
-3. Enter `n8n-nodes-apivault-website-traffic-database` and confirm.
-
-## Credentials
-
-Create an **Apify API** credential in n8n and paste your personal token from [Apify Console → Integrations](https://console.apify.com/account/integrations). The token is sent to Apify as a bearer credential and is never bundled with this package.
-
-## Usage
-
-Add **Websites by Traffic Volume 2026** to a workflow, fill the public Actor inputs below, and execute the node. Every Dataset result becomes one n8n item, so it can flow into Sheets, databases, CRMs, alerts or your own code. The node respects n8n's **Continue On Fail** behavior.
-
-## Ready-to-import workflow
-
-Import [`examples/quickstart-workflow.json`](examples/quickstart-workflow.json), select your Apify API credential in the Actor node, replace the sample business inputs and run it. The workflow returns destination-ready rows without exposing Actor internals.
-
-| Input | Type | Description |
-|---|---|---|
-| `workflow` | `string` | Choose one way to find websites. Auto-detect preserves existing integrations and uses this priority: domain lookup, similar sites, global rank, then traffic filters. |
-| `minVisits` | `integer` | Return sites with at least this many visits in the most recent month (e.g. 1000 = 1K+ visits/month). Used only in traffic mode. If you use ‘Top sites by Global Rank’ in section ②,  |
-| `maxVisits` | `integer` | Return sites with at most this many visits in the most recent month. Leave empty for no upper limit. |
-| `topGlobalRank` | `integer` | Enter 1000 to get the world's top 1000 sites — global ranks 1 through 1000, ordered from rank 1 (rank 1 = the most visited site in the world). Just fill this one field: the monthly |
-| `category` | `string` | Keep only sites whose category contains this text (e.g. 'finance', 'health', 'games'). Category is known for a subset of sites, so this narrows results. Leave empty for all. |
-| `country` | `string` | Keep only sites whose #1 visitor country matches this code (e.g. 'US', 'DE', 'GB'). Leave empty for all countries. |
-| `minSearchShare` | `integer` | Keep only sites where organic search is at least this % of traffic (e.g. 50 = SEO-dependent sites). Leave empty to ignore. |
-| `hasAiTraffic` | `boolean` | Keep only sites that get visits from AI assistants (ChatGPT, Perplexity, etc.). |
-| `onlyGrowing` | `boolean` | Keep only sites whose most recent month is higher than their earliest tracked month (positive trend). |
-| `minGrowthPercent` | `integer` | Keep only sites growing at least this % from their earliest to most recent tracked month (e.g. 20 = fast-growing / trending sites). Leave empty to ignore. |
-| `keyword` | `string` | Keep only sites that have this keyword among their top search keywords (reverse keyword lookup, e.g. 'crypto wallet'). Best combined with other filters. Leave empty to ignore. |
-| `trafficSource` | `string` | Which traffic channel to filter by (used together with 'Minimum channel share' below). E.g. pick 'social' + 40 to find sites where social is 40%+ of traffic. |
-| `minSourceShare` | `integer` | Keep only sites where the chosen 'Traffic channel' is at least this % of total traffic (e.g. 40). Leave empty to ignore this filter. |
-| `maxBounce` | `integer` | Keep only sites with a bounce rate at or below this % (lower = more engaged visitors, e.g. 40). Leave empty to ignore. |
-| `minPagesPerVisit` | `integer` | Keep only sites where visitors view at least this many pages per visit (engagement, e.g. 3). Leave empty to ignore. |
-| `minTimeOnSite` | `integer` | Keep only sites with an average visit duration of at least this many seconds (e.g. 120 = 2 min). Leave empty to ignore. |
-| `maxResults` | `integer` | Maximum number of websites to return — this is also your cost control, since you pay per result. Up to 50,000 are returned as an accurate global top-N; larger values (up to 1,000,0 |
-| `sortBy` | `string` | Which field to sort results by. |
-| `sortOrder` | `string` | Highest first (descending) or lowest first (ascending). |
-| `outputPreset` | `string` | Compact returns core traffic and ranking facts. Outreach adds engagement, growth and channel mix. Full keeps monthly history, countries, keywords and every available field. Calls t |
-| `domains` | `array` | Enter one or more domains (e.g. 'stripe.com', 'https://www.nike.com/') to get their traffic data directly. Only domains already tracked in the database return a row. When you fill  |
-| `similarTo` | `string` | Enter ONE domain (e.g. 'stripe.com') to get its competitors: other sites in the same category with comparable monthly traffic. The domain must be in the database and have a known c |
-
-## Pricing
-
-The package is free. Actor runs are billed by Apify using the pricing shown on the [Actor page](https://apify.com/apivault_labs/website-traffic-database); platform usage may also apply.
-
-## Resources
-
-- [Actor and live input schema](https://apify.com/apivault_labs/website-traffic-database)
-- [Source repository](https://github.com/apivault-labs/n8n-nodes-apivault-website-traffic-database)
-- [n8n community-node documentation](https://docs.n8n.io/integrations/community-nodes/)
-
-## License
-
-MIT. The hosted Actor is a separate paid service governed by Apify terms.
+Runtime dependencies: none. n8n Cloud availability requires separate n8n verification.

package/dist/credentials/ApifyApi.credentials.d.ts

@@ -1,6 +1,10 @@
 import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
 export declare class ApifyApi implements ICredentialType {
     name: string;
+    icon: {
+        readonly light: "file:apivault.svg";
+        readonly dark: "file:apivault.svg";
+    };
     displayName: string;
     documentationUrl: string;
     properties: INodeProperties[];

package/dist/credentials/ApifyApi.credentials.js

@@ -2,27 +2,25 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApifyApi = void 0;
 class ApifyApi {
-    constructor() {
-        this.name = 'apifyApi';
-        this.displayName = 'Apify API';
-        this.documentationUrl = 'https://docs.apify.com/platform/integrations/api';
-        this.properties = [
-            {
-                displayName: 'API Token',
-                name: 'apiToken',
-                type: 'string',
-                typeOptions: { password: true },
-                default: '',
-                required: true,
-                description: 'Your personal Apify API token (Apify Console -> Settings -> Integrations).',
-            },
-        ];
-        this.authenticate = {
-            type: 'generic',
-            properties: { headers: { Authorization: '=Bearer {{$credentials.apiToken}}' } },
-        };
-        this.test = { request: { baseURL: 'https://api.apify.com/v2', url: '/users/me' } };
-    }
+    name = 'apifyApi';
+    icon = { light: 'file:apivault.svg', dark: 'file:apivault.svg' };
+    displayName = 'Apify API';
+    documentationUrl = 'https://docs.apify.com/platform/integrations/api';
+    properties = [
+        {
+            displayName: 'API Token',
+            name: 'apiToken',
+            type: 'string',
+            typeOptions: { password: true },
+            default: '',
+            required: true,
+            description: 'Your personal Apify API token (Apify Console -> Settings -> Integrations).',
+        },
+    ];
+    authenticate = {
+        type: 'generic',
+        properties: { headers: { Authorization: '=Bearer {{$credentials.apiToken}}' } },
+    };
+    test = { request: { baseURL: 'https://api.apify.com/v2', url: '/users/me' } };
 }
 exports.ApifyApi = ApifyApi;
-//# sourceMappingURL=ApifyApi.credentials.js.map

package/dist/credentials/apivault.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" rx="14" fill="#4f46e5"/><path d="M16 48 28 16h8l12 32H38l-2-7H26l-2 7zm12-15h6l-3-10z" fill="white"/></svg>

package/dist/nodes/WebsiteTrafficDatabase/WebsiteTrafficDatabase.node.js

@@ -2,26 +2,47 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebsiteTrafficDatabase = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
-const ACTOR_ID = 'apivault_labs~website-traffic-database';
+const actorTransport_1 = require("../helpers/actorTransport");
+const ACTOR_ID = '2ahDVr2hK6unhydIJ';
 class WebsiteTrafficDatabase {
-    constructor() {
-        this.description = {
-            displayName: 'Websites by Traffic Volume 2026',
-            name: 'websiteTrafficDatabase',
-            icon: 'file:websitetrafficdatabase.svg',
-            group: ['transform'],
-            version: 1,
-            description: 'The reverse of SimilarWeb: instead of one domain\'s stats, get every website in a traffic range. Filter 40M+ sites by monthly visits, category, country, rank, traffic channel, engagement, growth, or the keywords they rank for. A cheaper SimilarWeb/Semrush alternative for bulk site discovery. $5/1K.',
-            defaults: { name: 'Websites by Traffic Volume 2026' },
-            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
-            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
-            usableAsTool: true,
-            credentials: [{ name: 'apifyApi', required: true }],
-            properties: [
+    description = {
+        "displayName": "Websites by Traffic Volume 2026",
+        "name": "websiteTrafficDatabase",
+        "icon": {
+            "light": "file:websitetrafficdatabase.svg",
+            "dark": "file:websitetrafficdatabase.svg"
+        },
+        "subtitle": "={{$parameter[\"apivaultMode\"]}}",
+        "group": [
+            "transform"
+        ],
+        "version": [
+            1,
+            2
+        ],
+        "description": "Run Website Traffic Database through the hosted Apify Actor and read its results",
+        "defaults": {
+            "name": "Websites by Traffic Volume 2026"
+        },
+        "inputs": [
+            n8n_workflow_1.NodeConnectionTypes.Main
+        ],
+        "outputs": [
+            n8n_workflow_1.NodeConnectionTypes.Main
+        ],
+        "usableAsTool": true,
+        "credentials": [
+            {
+                "name": "apifyApi",
+                "required": true
+            }
+        ],
+        "defaultVersion": 2,
+        properties: [...actorTransport_1.executionProperties, ...[
                 {
                     "displayName": "Workflow",
                     "name": "workflow",
-                    "description": "Choose one way to find websites. Auto-detect preserves existing integrations and uses this priority: domain lookup, similar sites, global rank, then traffic filters.",
+                    "description": "Actor input: Workflow",
                     "type": "options",
                     "options": [
                         {
@@ -45,92 +66,169 @@ class WebsiteTrafficDatabase {
                             "value": "similarSites"
                         }
                     ],
-                    "default": "auto"
+                    "default": "auto",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Minimum monthly visits",
                     "name": "minVisits",
-                    "description": "Return sites with at least this many visits in the most recent month (e.g. 1000 = 1K+ visits/month). Used only in traffic mode. If you use ‘Top sites by Global Rank’ in section ②, this field is ignored automatically — you don't need to clear it.",
+                    "description": "Actor input: Minimum monthly visits",
                     "type": "number",
                     "default": 1000,
                     "typeOptions": {
                         "minValue": 0
+                    },
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
                     }
                 },
                 {
                     "displayName": "Maximum monthly visits",
                     "name": "maxVisits",
-                    "description": "Return sites with at most this many visits in the most recent month. Leave empty for no upper limit.",
+                    "description": "Actor input: Maximum monthly visits",
                     "type": "number",
-                    "default": 0
+                    "default": 0,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Top sites worldwide (enter N, e.g. 100)",
                     "name": "topGlobalRank",
-                    "description": "Enter 1000 to get the world's top 1000 sites — global ranks 1 through 1000, ordered from rank 1 (rank 1 = the most visited site in the world). Just fill this one field: the monthly-visits fields in ① and every optional filter in ③ (category, country, etc.) are ignored automatically, so you don't have to clear anything. Leave this empty to select by traffic instead.",
+                    "description": "Actor input: Top sites worldwide (enter N, e.g. 100)",
                     "type": "number",
                     "default": 0,
                     "typeOptions": {
                         "minValue": 1
+                    },
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
                     }
                 },
                 {
                     "displayName": "Category contains",
                     "name": "category",
-                    "description": "Keep only sites whose category contains this text (e.g. 'finance', 'health', 'games'). Category is known for a subset of sites, so this narrows results. Leave empty for all.",
+                    "description": "Actor input: Category contains",
                     "type": "string",
-                    "default": ""
+                    "default": "",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Top country (code)",
                     "name": "country",
-                    "description": "Keep only sites whose #1 visitor country matches this code (e.g. 'US', 'DE', 'GB'). Leave empty for all countries.",
+                    "description": "Actor input: Top country (code)",
                     "type": "string",
-                    "default": ""
+                    "default": "",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Minimum search-traffic share (%)",
                     "name": "minSearchShare",
-                    "description": "Keep only sites where organic search is at least this % of traffic (e.g. 50 = SEO-dependent sites). Leave empty to ignore.",
+                    "description": "Actor input: Minimum search-traffic share (%)",
                     "type": "number",
                     "default": 0,
                     "typeOptions": {
                         "minValue": 0,
                         "maxValue": 100
+                    },
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
                     }
                 },
                 {
                     "displayName": "Only sites with AI/LLM traffic",
                     "name": "hasAiTraffic",
-                    "description": "Keep only sites that get visits from AI assistants (ChatGPT, Perplexity, etc.).",
+                    "description": "Actor input: Only sites with AI/LLM traffic",
                     "type": "boolean",
-                    "default": false
+                    "default": false,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Only growing sites",
                     "name": "onlyGrowing",
-                    "description": "Keep only sites whose most recent month is higher than their earliest tracked month (positive trend).",
+                    "description": "Actor input: Only growing sites",
                     "type": "boolean",
-                    "default": false
+                    "default": false,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Minimum growth (%)",
                     "name": "minGrowthPercent",
-                    "description": "Keep only sites growing at least this % from their earliest to most recent tracked month (e.g. 20 = fast-growing / trending sites). Leave empty to ignore.",
+                    "description": "Actor input: Minimum growth (%)",
                     "type": "number",
-                    "default": 0
+                    "default": 0,
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Ranks for keyword",
                     "name": "keyword",
-                    "description": "Keep only sites that have this keyword among their top search keywords (reverse keyword lookup, e.g. 'crypto wallet'). Best combined with other filters. Leave empty to ignore.",
+                    "description": "Actor input: Ranks for keyword",
                     "type": "string",
-                    "default": ""
+                    "default": "",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Traffic channel",
                     "name": "trafficSource",
-                    "description": "Which traffic channel to filter by (used together with 'Minimum channel share' below). E.g. pick 'social' + 40 to find sites where social is 40%+ of traffic.",
+                    "description": "Actor input: Traffic channel",
                     "type": "options",
                     "options": [
                         {
@@ -162,65 +260,107 @@ class WebsiteTrafficDatabase {
                             "value": "ai"
                         }
                     ],
-                    "default": "search"
+                    "default": "search",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Minimum channel share (%)",
                     "name": "minSourceShare",
-                    "description": "Keep only sites where the chosen 'Traffic channel' is at least this % of total traffic (e.g. 40). Leave empty to ignore this filter.",
+                    "description": "Actor input: Minimum channel share (%)",
                     "type": "number",
                     "default": 0,
                     "typeOptions": {
                         "minValue": 0,
                         "maxValue": 100
+                    },
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
                     }
                 },
                 {
                     "displayName": "Maximum bounce rate (%)",
                     "name": "maxBounce",
-                    "description": "Keep only sites with a bounce rate at or below this % (lower = more engaged visitors, e.g. 40). Leave empty to ignore.",
+                    "description": "Actor input: Maximum bounce rate (%)",
                     "type": "number",
                     "default": 0,
                     "typeOptions": {
                         "minValue": 0,
                         "maxValue": 100
+                    },
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
                     }
                 },
                 {
                     "displayName": "Minimum pages per visit",
                     "name": "minPagesPerVisit",
-                    "description": "Keep only sites where visitors view at least this many pages per visit (engagement, e.g. 3). Leave empty to ignore.",
+                    "description": "Actor input: Minimum pages per visit",
                     "type": "number",
                     "default": 0,
                     "typeOptions": {
                         "minValue": 0
+                    },
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
                     }
                 },
                 {
                     "displayName": "Minimum time on site (seconds)",
                     "name": "minTimeOnSite",
-                    "description": "Keep only sites with an average visit duration of at least this many seconds (e.g. 120 = 2 min). Leave empty to ignore.",
+                    "description": "Actor input: Minimum time on site (seconds)",
                     "type": "number",
                     "default": 0,
                     "typeOptions": {
                         "minValue": 0
+                    },
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
                     }
                 },
                 {
                     "displayName": "Max results",
                     "name": "maxResults",
-                    "description": "Maximum number of websites to return — this is also your cost control, since you pay per result. Up to 50,000 are returned as an accurate global top-N; larger values (up to 1,000,000) switch to a streaming bulk export for full-list pulls.",
+                    "description": "Actor input: Max results",
                     "type": "number",
                     "default": 25,
                     "typeOptions": {
                         "minValue": 1,
                         "maxValue": 1000000
+                    },
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
                     }
                 },
                 {
                     "displayName": "Sort by",
                     "name": "sortBy",
-                    "description": "Which field to sort results by.",
+                    "description": "Actor input: Sort by",
                     "type": "options",
                     "options": [
                         {
@@ -256,12 +396,19 @@ class WebsiteTrafficDatabase {
                             "value": "ai_visits"
                         }
                     ],
-                    "default": "visits"
+                    "default": "visits",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Sort order",
                     "name": "sortOrder",
-                    "description": "Highest first (descending) or lowest first (ascending).",
+                    "description": "Actor input: Sort order",
                     "type": "options",
                     "options": [
                         {
@@ -273,12 +420,19 @@ class WebsiteTrafficDatabase {
                             "value": "asc"
                         }
                     ],
-                    "default": "desc"
+                    "default": "desc",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Output detail",
                     "name": "outputPreset",
-                    "description": "Compact returns core traffic and ranking facts. Outreach adds engagement, growth and channel mix. Full keeps monthly history, countries, keywords and every available field. Calls that omit this field retain the legacy full output.",
+                    "description": "Actor input: Output detail",
                     "type": "options",
                     "options": [
                         {
@@ -294,101 +448,93 @@ class WebsiteTrafficDatabase {
                             "value": "full"
                         }
                     ],
-                    "default": "outreach"
+                    "default": "outreach",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Domains to look up",
                     "name": "domains",
-                    "description": "Enter one or more domains (e.g. 'stripe.com', 'https://www.nike.com/') to get their traffic data directly. Only domains already tracked in the database return a row. When you fill this, the filter fields above are ignored. (comma or new-line separated)",
+                    "description": "Actor input: Domains to look up",
                     "type": "string",
-                    "default": ""
+                    "default": "",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 },
                 {
                     "displayName": "Find competitors of this domain",
                     "name": "similarTo",
-                    "description": "Enter ONE domain (e.g. 'stripe.com') to get its competitors: other sites in the same category with comparable monthly traffic. The domain must be in the database and have a known category. When you fill this, everything above is ignored.",
+                    "description": "Actor input: Find competitors of this domain",
                     "type": "string",
-                    "default": ""
+                    "default": "",
+                    "displayOptions": {
+                        "show": {
+                            "apivaultMode": [
+                                "run"
+                            ]
+                        }
+                    }
                 }
-            ],
-        };
-    }
+            ]]
+    };
     async execute() {
-        var _b;
-        const items = this.getInputData();
-        const returnData = [];
-        for (let i = 0; i < items.length; i++) {
+        const output = [];
+        for (let i = 0; i < this.getInputData().length; i++) {
             try {
-                const body = {};
-                body["workflow"] = this.getNodeParameter("workflow", i);
-                body["minVisits"] = this.getNodeParameter("minVisits", i);
-                body["maxVisits"] = this.getNodeParameter("maxVisits", i);
-                body["topGlobalRank"] = this.getNodeParameter("topGlobalRank", i);
-                body["category"] = this.getNodeParameter("category", i);
-                body["country"] = this.getNodeParameter("country", i);
-                body["minSearchShare"] = this.getNodeParameter("minSearchShare", i);
-                body["hasAiTraffic"] = this.getNodeParameter("hasAiTraffic", i);
-                body["onlyGrowing"] = this.getNodeParameter("onlyGrowing", i);
-                body["minGrowthPercent"] = this.getNodeParameter("minGrowthPercent", i);
-                body["keyword"] = this.getNodeParameter("keyword", i);
-                body["trafficSource"] = this.getNodeParameter("trafficSource", i);
-                body["minSourceShare"] = this.getNodeParameter("minSourceShare", i);
-                body["maxBounce"] = this.getNodeParameter("maxBounce", i);
-                body["minPagesPerVisit"] = this.getNodeParameter("minPagesPerVisit", i);
-                body["minTimeOnSite"] = this.getNodeParameter("minTimeOnSite", i);
-                body["maxResults"] = this.getNodeParameter("maxResults", i);
-                body["sortBy"] = this.getNodeParameter("sortBy", i);
-                body["sortOrder"] = this.getNodeParameter("sortOrder", i);
-                body["outputPreset"] = this.getNodeParameter("outputPreset", i);
-                {
-                    const _v = this.getNodeParameter("domains", i, '');
-                    const _a = _v.split(/[,\n]/).map(s => s.trim()).filter(s => s.length > 0);
-                    if (_a.length)
-                        body["domains"] = _a;
-                }
-                body["similarTo"] = this.getNodeParameter("similarTo", i);
-                const options = {
-                    method: 'POST',
-                    url: `https://api.apify.com/v2/acts/${ACTOR_ID}/runs`,
-                    body,
-                    json: true,
-                };
-                const started = await this.helpers.requestWithAuthentication.call(this, 'apifyApi', options);
-                const runId = (_b = started === null || started === void 0 ? void 0 : started.data) === null || _b === void 0 ? void 0 : _b.id;
-                if (!runId)
-                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Apify did not return a run ID', { itemIndex: i });
-                let run = started.data;
-                const deadline = Date.now() + 60 * 60 * 1000;
-                while (!['SUCCEEDED', 'FAILED', 'ABORTED', 'TIMED-OUT'].includes(run.status)) {
-                    if (Date.now() >= deadline)
-                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Waiting timed out; check the existing run in Apify before retrying', { itemIndex: i });
-                    const polled = await this.helpers.requestWithAuthentication.call(this, 'apifyApi', { method: 'GET', url: `https://api.apify.com/v2/actor-runs/${runId}?waitForFinish=20`, json: true });
-                    run = polled.data;
-                }
-                if (run.status !== 'SUCCEEDED')
-                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Apify run ended with status ' + run.status, { itemIndex: i });
-                let offset = 0;
-                while (true) {
-                    const page = await this.helpers.requestWithAuthentication.call(this, 'apifyApi', { method: 'GET', url: `https://api.apify.com/v2/datasets/${run.defaultDatasetId}/items?clean=1&limit=1000&offset=${offset}`, json: true });
-                    if (!Array.isArray(page))
-                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Unexpected Dataset response', { itemIndex: i });
-                    for (const result of page)
-                        returnData.push({ json: result, pairedItem: { item: i } });
-                    offset += page.length;
-                    if (page.length < 1000)
-                        break;
-                }
+                const body = this.getNodeParameter('apivaultMode', i, 'run') === 'read' ? {} : (() => {
+                    const body = {};
+                    body["workflow"] = this.getNodeParameter("workflow", i);
+                    body["minVisits"] = this.getNodeParameter("minVisits", i);
+                    body["maxVisits"] = this.getNodeParameter("maxVisits", i);
+                    body["topGlobalRank"] = this.getNodeParameter("topGlobalRank", i);
+                    body["category"] = this.getNodeParameter("category", i);
+                    body["country"] = this.getNodeParameter("country", i);
+                    body["minSearchShare"] = this.getNodeParameter("minSearchShare", i);
+                    body["hasAiTraffic"] = this.getNodeParameter("hasAiTraffic", i);
+                    body["onlyGrowing"] = this.getNodeParameter("onlyGrowing", i);
+                    body["minGrowthPercent"] = this.getNodeParameter("minGrowthPercent", i);
+                    body["keyword"] = this.getNodeParameter("keyword", i);
+                    body["trafficSource"] = this.getNodeParameter("trafficSource", i);
+                    body["minSourceShare"] = this.getNodeParameter("minSourceShare", i);
+                    body["maxBounce"] = this.getNodeParameter("maxBounce", i);
+                    body["minPagesPerVisit"] = this.getNodeParameter("minPagesPerVisit", i);
+                    body["minTimeOnSite"] = this.getNodeParameter("minTimeOnSite", i);
+                    body["maxResults"] = this.getNodeParameter("maxResults", i);
+                    body["sortBy"] = this.getNodeParameter("sortBy", i);
+                    body["sortOrder"] = this.getNodeParameter("sortOrder", i);
+                    body["outputPreset"] = this.getNodeParameter("outputPreset", i);
+                    {
+                        const _v = this.getNodeParameter("domains", i, '');
+                        const _a = _v.split(/[,\n]/).map(s => s.trim()).filter(s => s.length > 0);
+                        if (_a.length)
+                            body["domains"] = _a;
+                    }
+                    body["similarTo"] = this.getNodeParameter("similarTo", i);
+                    return body;
+                })();
+                const results = await (0, actorTransport_1.runActor)(this, i, ACTOR_ID, body);
+                for (const result of results)
+                    output.push({ json: result, pairedItem: { item: i } });
             }
             catch (error) {
-                if (this.continueOnFail()) {
-                    returnData.push({ json: { error: error.message }, pairedItem: { item: i } });
-                    continue;
-                }
-                throw new n8n_workflow_1.NodeOperationError(this.getNode(), error, { itemIndex: i });
+                const message = error instanceof actorTransport_1.SafeActorError ? error.message : 'Could not finish the Actor request. Check inputs and credentials; use Read Existing Run if a run was already started';
+                if (this.continueOnFail())
+                    output.push({ json: { error: message }, pairedItem: { item: i } });
+                else
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), message, { itemIndex: i });
             }
         }
-        return [returnData];
+        return [output];
     }
 }
 exports.WebsiteTrafficDatabase = WebsiteTrafficDatabase;
-//# sourceMappingURL=WebsiteTrafficDatabase.node.js.map

package/dist/nodes/helpers/actorTransport.d.ts

@@ -0,0 +1,9 @@
+import type { IExecuteFunctions, INodeProperties, IDataObject } from 'n8n-workflow';
+import { NodeOperationError } from 'n8n-workflow';
+export declare class SafeActorError extends NodeOperationError {
+    readonly runId: string;
+    constructor(context: IExecuteFunctions, runId: string, item: number);
+}
+export declare const executionProperties: INodeProperties[];
+export declare function runActor(context: IExecuteFunctions, item: number, actorId: string, body: Record<string, unknown>): Promise<IDataObject[]>;
+export declare function legacyRequest(context: IExecuteFunctions, item: number, raw: unknown): Promise<any>;

package/dist/nodes/helpers/actorTransport.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executionProperties = exports.SafeActorError = void 0;
+exports.runActor = runActor;
+exports.legacyRequest = legacyRequest;
+const n8n_workflow_1 = require("n8n-workflow");
+const API = 'https://api.apify.com/v2';
+const id = (value) => {
+    if (typeof value !== 'string' || !/^[A-Za-z0-9_-]{1,100}$/.test(value))
+        throw new Error('Invalid Apify identifier');
+    return value;
+};
+class SafeActorError extends n8n_workflow_1.NodeOperationError {
+    runId;
+    constructor(context, runId, item) {
+        super(context.getNode(), runId ? `Could not finish reading run ${runId}; select Read Existing Run to resume` : 'Could not start or read the Actor. Check inputs and credentials before retrying', { itemIndex: item });
+        this.runId = runId;
+    }
+}
+exports.SafeActorError = SafeActorError;
+exports.executionProperties = [
+    { displayName: 'Run Mode', name: 'apivaultMode', type: 'options', noDataExpression: true,
+        options: [{ name: 'Run Actor', value: 'run', action: 'Run the actor' }, { name: 'Read Existing Run', value: 'read', action: 'Read an existing run' }], default: 'run' },
+    { displayName: 'Execution Options', name: 'apivaultExecution', type: 'collection', placeholder: 'Add Option', default: {}, options: [
+            { displayName: 'Run ID', name: 'runId', type: 'string', default: '', description: 'Existing Apify run to resume without starting a paid duplicate' },
+            { displayName: 'Maximum Event Charge (USD)', name: 'maxTotalChargeUsd', type: 'number', default: 0.05,
+                typeOptions: { minValue: 0.001, maxValue: 1000, numberPrecision: 3 }, description: 'Event charge cap. Platform usage may be billed separately.' },
+            { displayName: 'Maximum Rows to Read', name: 'maxRows', type: 'number', default: 1000,
+                typeOptions: { minValue: 1, maxValue: 100000, numberPrecision: 0 }, description: 'Download cap only. Actor input limits control paid collection.' },
+            { displayName: 'Output', name: 'output', type: 'options', default: 'rows',
+                options: [{ name: 'Dataset Rows', value: 'rows' }, { name: 'Run, Rows and Diagnostics', value: 'full' }], description: 'Include SUMMARY and ERRORS to inspect partial or empty results' },
+        ] },
+];
+async function runActor(context, item, actorId, body) {
+    let runId = '';
+    try {
+        const mode = context.getNodeParameter('apivaultMode', item, 'run');
+        const options = context.getNodeParameter('apivaultExecution', item, {});
+        const legacy = context.getNode().typeVersion < 2;
+        const maxRows = options.maxRows ?? (legacy ? 100000 : 1000);
+        if (!Number.isInteger(maxRows) || maxRows < 1 || maxRows > 100000)
+            throw new Error('Invalid row limit');
+        const request = async (requestOptions) => context.helpers.httpRequestWithAuthentication.call(context, 'apifyApi', requestOptions);
+        if (mode === 'run') {
+            const cap = options.maxTotalChargeUsd ?? (legacy ? undefined : 0.05);
+            if (cap !== undefined && (!Number.isFinite(cap) || cap <= 0 || cap > 1000))
+                throw new Error('Invalid event charge cap');
+            // Legacy workflows retain their existing charge behavior unless a cap is selected.
+            const qs = { build: 'latest' };
+            if (cap !== undefined)
+                qs.maxTotalChargeUsd = cap;
+            // Never retry POST: a duplicate could create a second paid Actor run.
+            const started = await request({ method: 'POST', url: `${API}/acts/${id(actorId)}/runs`, body: body, qs, json: true });
+            runId = id(started?.data?.id);
+        }
+        else if (mode === 'read')
+            runId = id(options.runId);
+        else
+            throw new Error('Unsupported run mode');
+        const deadline = Date.now() + 10 * 60 * 1000;
+        let run;
+        while (true) {
+            if (Date.now() >= deadline)
+                throw new Error('Waiting timed out');
+            const response = await request({ method: 'GET', url: `${API}/actor-runs/${runId}`, qs: { waitForFinish: 20 }, json: true });
+            run = response.data;
+            if (run.status === 'SUCCEEDED')
+                break;
+            if (['FAILED', 'TIMED-OUT', 'ABORTED'].includes(run.status))
+                throw new Error('Run did not succeed');
+        }
+        const datasetId = id(run.defaultDatasetId);
+        const dataset = await request({ method: 'GET', url: `${API}/datasets/${datasetId}`, json: true });
+        const rows = [];
+        while (rows.length < maxRows) {
+            const limit = Math.min(1000, maxRows - rows.length);
+            const page = await request({ method: 'GET', url: `${API}/datasets/${datasetId}/items`, qs: { clean: true, offset: rows.length, limit }, json: true });
+            if (!Array.isArray(page) || page.length > limit)
+                throw new Error('Invalid Dataset response');
+            rows.push(...page);
+            if (page.length < limit)
+                break;
+        }
+        const truncated = (dataset.data?.itemCount ?? rows.length) > rows.length;
+        if (options.output === 'full') {
+            const storeId = id(run.defaultKeyValueStoreId);
+            const records = {};
+            for (const key of ['SUMMARY', 'ERRORS']) {
+                try {
+                    records[key] = await request({ method: 'GET', url: `${API}/key-value-stores/${storeId}/records/${key}`, json: true });
+                }
+                catch (error) {
+                    const e = error;
+                    if (e.statusCode === 404 || e.response?.status === 404)
+                        records[key] = null;
+                    else
+                        throw new n8n_workflow_1.NodeOperationError(context.getNode(), 'Diagnostics unavailable');
+                }
+            }
+            return [{ runId, datasetId, status: run.status, rows, summary: records.SUMMARY ?? null, errors: records.ERRORS ?? null, truncated }];
+        }
+        return rows.map(row => ({ ...row, _apifyRunId: runId, _apifyTruncated: truncated }));
+    }
+    catch {
+        const safeError = new SafeActorError(context, runId, item);
+        throw safeError;
+    }
+}
+// Keep specialized legacy output modes (including asynchronous start and MCP_RESPONSE).
+async function legacyRequest(context, item, raw) {
+    const options = raw;
+    const controls = context.getNodeParameter('apivaultExecution', item, {});
+    const request = async (value) => context.helpers.httpRequestWithAuthentication.call(context, 'apifyApi', value);
+    if (options.method === 'POST' && options.url.endsWith('/runs')) {
+        const qs = { ...(options.qs ?? {}) };
+        const wait = qs.waitForFinish;
+        delete qs.waitForFinish;
+        const cap = controls.maxTotalChargeUsd ?? (context.getNode().typeVersion < 2 ? undefined : 0.05);
+        if (cap !== undefined) {
+            if (!Number.isFinite(cap) || cap <= 0 || cap > 1000)
+                throw new Error('Invalid event charge cap');
+            qs.maxTotalChargeUsd = cap;
+        }
+        const started = await request({ ...options, qs });
+        if (!wait)
+            return started;
+        const runId = id(started?.data?.id);
+        const deadline = Date.now() + 10 * 60 * 1000;
+        while (Date.now() < deadline) {
+            const result = await request({ method: 'GET', url: `${API}/actor-runs/${runId}`, qs: { waitForFinish: 20 }, json: true });
+            if (result.data.status === 'SUCCEEDED')
+                return result;
+            if (['FAILED', 'TIMED-OUT', 'ABORTED'].includes(result.data.status))
+                throw new Error('Run did not succeed');
+        }
+        throw new Error('Waiting timed out');
+    }
+    if (options.method === 'GET' && /\/datasets\/[A-Za-z0-9_-]+\/items$/.test(options.url)) {
+        const maxRows = controls.maxRows ?? (context.getNode().typeVersion < 2 ? 100000 : 1000);
+        if (!Number.isInteger(maxRows) || maxRows < 1 || maxRows > 100000)
+            throw new Error('Invalid row limit');
+        const rows = [];
+        while (rows.length < maxRows) {
+            const limit = Math.min(1000, maxRows - rows.length);
+            const page = await request({ ...options, qs: { ...(options.qs ?? {}), offset: rows.length, limit } });
+            if (!Array.isArray(page) || page.length > limit)
+                throw new Error('Invalid Dataset response');
+            rows.push(...page);
+            if (page.length < limit)
+                break;
+        }
+        return rows;
+    }
+    return request(options);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "n8n-nodes-apivault-website-traffic-database",
-  "version": "0.2.1",
-  "description": "n8n community node for Websites by Traffic Volume 2026 — backed by the Apify Actor apivault_labs/website-traffic-database. No login. Pay-as-you-go via Apify.",
+  "version": "0.3.0",
+  "description": "Run Website Traffic Database through the hosted Apify Actor and read its results",
   "license": "MIT",
   "homepage": "https://apify.com/apivault_labs/website-traffic-database",
   "keywords": [
@@ -15,16 +15,19 @@
     "workflow-automation"
   ],
   "author": {
-    "name": "apivault_labs"
+    "name": "ApiVault Labs",
+    "email": "68965192+apivault-labs@users.noreply.github.com"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/apivault-labs/n8n-nodes-apivault-website-traffic-database.git"
+    "url": "git+https://github.com/apivault-labs/apivault-labs.git",
+    "directory": "community-nodes/n8n-nodes-apivault-website-traffic-database"
   },
   "main": "index.js",
   "scripts": {
-    "build": "tsc && copyfiles \"nodes/**/*.svg\" dist",
-    "dev": "tsc --watch",
+    "build": "tsc && node scripts/copy-icons.cjs",
+    "lint": "n8n-node lint",
+    "test": "node test/contract.cjs",
     "prepublishOnly": "npm run build"
   },
   "files": [
@@ -41,12 +44,12 @@
     ]
   },
   "devDependencies": {
-    "@types/node": "^20.10.0",
-    "copyfiles": "^2.4.1",
-    "n8n-workflow": "*",
-    "typescript": "^5.4.0"
+    "@n8n/node-cli": "0.52.2",
+    "n8n-workflow": "2.16.0",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "@types/node": "^22.0.0"
   },
   "peerDependencies": {
     "n8n-workflow": "*"
   }
-}
+}

package/dist/credentials/ApifyApi.credentials.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ApifyApi.credentials.js","sourceRoot":"","sources":["../../credentials/ApifyApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,QAAQ;IAArB;QACC,SAAI,GAAG,UAAU,CAAC;QAClB,gBAAW,GAAG,WAAW,CAAC;QAC1B,qBAAgB,GAAG,kDAAkD,CAAC;QACtE,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,4EAA4E;aACzF;SACD,CAAC;QACF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,mCAAmC,EAAE,EAAE;SAC/E,CAAC;QACF,SAAI,GAA2B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,CAAC;IACvG,CAAC;CAAA;AApBD,4BAoBC"}

package/dist/nodes/WebsiteTrafficDatabase/WebsiteTrafficDatabase.node.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"WebsiteTrafficDatabase.node.js","sourceRoot":"","sources":["../../../nodes/WebsiteTrafficDatabase/WebsiteTrafficDatabase.node.ts"],"names":[],"mappings":"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"}

package/examples/quickstart-workflow.json

@@ -1,96 +0,0 @@
-{
-  "id": "c9dbde90-2805-5cc9-a851-9aca0851dbd6",
-  "name": "Website Traffic → Lead priority",
-  "nodes": [
-    {
-      "parameters": {},
-      "id": "917666b4-94b1-5fa6-9de3-2263936c9b73",
-      "name": "When clicking Execute workflow",
-      "type": "n8n-nodes-base.manualTrigger",
-      "typeVersion": 1,
-      "position": [
-        0,
-        120
-      ]
-    },
-    {
-      "parameters": {
-        "content": "## Setup\n1. Select your Apify API credential.\n2. Set traffic, country and category filters.\n3. The workflow assigns a simple outreach priority from the returned business signals.",
-        "height": 260,
-        "width": 440
-      },
-      "id": "d55d27c8-5665-5893-8b2e-5f8ba3b120de",
-      "name": "How to use this workflow",
-      "type": "n8n-nodes-base.stickyNote",
-      "typeVersion": 1,
-      "position": [
-        -40,
-        -220
-      ]
-    },
-    {
-      "parameters": {
-        "workflow": "traffic",
-        "minVisits": 10000,
-        "onlyGrowing": true,
-        "maxResults": 200,
-        "sortBy": "visits",
-        "sortOrder": "desc",
-        "outputPreset": "outreach"
-      },
-      "id": "9c9705ed-0b23-5fb5-8c09-0d9d35ff7bdb",
-      "name": "Find websites by traffic with Apify",
-      "type": "n8n-nodes-apivault-website-traffic-database.websiteTrafficDatabase",
-      "typeVersion": 1,
-      "position": [
-        260,
-        120
-      ]
-    },
-    {
-      "parameters": {
-        "mode": "runOnceForEachItem",
-        "jsCode": "const j = $json; const visits = Number(j.latestMonthVisits ?? j.monthlyVisits ?? j.visits ?? 0); const growth = Number(j.monthlyGrowthPercent ?? j.growthPercent ?? 0); const priority = visits >= 100000 && growth > 0 ? 'high' : visits >= 10000 ? 'medium' : 'low'; return { json: { ...j, outreachPriority: priority, priorityReason: `${visits} estimated monthly visits; ${growth}% growth.` } };"
-      },
-      "id": "77d43f03-ee54-5c4c-950b-6f36983ed71f",
-      "name": "Assign outreach priority",
-      "type": "n8n-nodes-base.code",
-      "typeVersion": 2,
-      "position": [
-        560,
-        120
-      ]
-    }
-  ],
-  "connections": {
-    "When clicking Execute workflow": {
-      "main": [
-        [
-          {
-            "node": "Find websites by traffic with Apify",
-            "type": "main",
-            "index": 0
-          }
-        ]
-      ]
-    },
-    "Find websites by traffic with Apify": {
-      "main": [
-        [
-          {
-            "node": "Assign outreach priority",
-            "type": "main",
-            "index": 0
-          }
-        ]
-      ]
-    }
-  },
-  "pinData": {},
-  "settings": {
-    "executionOrder": "v1"
-  },
-  "active": false,
-  "versionId": "89c6616c-2b95-5d6a-9580-c9eef47c6c94",
-  "tags": []
-}