n8n-nodes-google-ads-transparency-api 0.1.0

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright 2026 John Cole
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+# n8n-nodes-google-ads-transparency-api
+
+An [n8n](https://n8n.io/) community node that pulls an advertiser's ads from the Google Ads Transparency Center and returns structured records: advertiser, ad creative ID, format, and run dates. It is backed by the [Google Ads Transparency API](https://apify.com/johnvc/google-ads-transparency-api?fpr=9n7kx3) on [Apify](https://apify.com?fpr=9n7kx3) and bills per result, so there are no subscriptions and no minimums.
+
+[Installation](#installation) · [Credentials](#credentials) · [Operations](#operations) · [Output](#output) · [Example workflows](#example-workflows) · [Pricing](#pricing) · [Resources](#resources)
+
+## What it does
+
+Give the node an advertiser ID, and it returns one item per ad with the advertiser name, ad creative ID, format, first- and last-shown dates, total days shown, and a details link. It also works as an **AI Agent tool**, so an agent can research competitor advertising on demand.
+
+- Pull the ad library for any advertiser by ID
+- Optionally filter by region
+- Choose how much data to return per ad: Simplified, Raw, or Selected Fields
+
+## Installation
+
+Follow the n8n [community nodes installation guide](https://docs.n8n.io/integrations/community-nodes/installation/):
+
+1. In n8n, open **Settings > Community Nodes**.
+2. Select **Install**.
+3. Enter `n8n-nodes-google-ads-transparency-api` as the npm package name.
+4. Agree to the risks of using community nodes, then select **Install**.
+
+After it installs, the **Google Ads Transparency** node appears in the nodes panel.
+
+> n8n Cloud only allows verified community nodes. Until this node is verified, install it on a self-hosted n8n instance.
+
+## Credentials
+
+You need a free [Apify account](https://apify.com?fpr=9n7kx3) and an API token.
+
+1. Sign in to the [Apify Console](https://console.apify.com?fpr=9n7kx3).
+2. Open **Settings > Integrations** and copy your **Personal API token**.
+3. In n8n, create a new **Apify API** credential and paste the token.
+4. Use the credential's **Test** button to confirm it works.
+
+The node also supports **Apify OAuth2** if you prefer to connect that way.
+
+## Operations
+
+**Ad > Get** returns ads run by an advertiser.
+
+| Parameter | Description |
+| --- | --- |
+| Advertiser ID | The Google Ads Transparency advertiser ID. Required. |
+| Region | Region code to filter by. Optional. |
+| Maximum Results per Advertiser | How many ads to return. |
+| Output | How much data to return: Simplified, Raw, or Selected Fields. |
+
+## Output
+
+Each ad is returned as its own n8n item. The **Output** parameter lets you choose how much to return:
+
+- **Simplified** (default): a compact object with `advertiser`, `advertiserId`, `adCreativeId`, `format`, `firstShown`, `lastShown`, `totalDaysShown`, and `detailsLink`. This mode is also used automatically when the node runs as an AI Agent tool, to keep responses small.
+- **Raw**: every field the API returns for each ad, using the original field names below.
+- **Selected Fields**: pick exactly which fields to include.
+
+### Fields (Raw and Selected Fields)
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `position` | integer | Rank in the results |
+| `ad_creative_id` | string | Ad creative identifier |
+| `advertiser` | string | Advertiser name |
+| `advertiser_id` | string | Advertiser identifier |
+| `format` | string | Ad format, for example `text`, `image`, or `video` |
+| `first_shown` | integer | First-shown timestamp (Unix) |
+| `last_shown` | integer | Last-shown timestamp (Unix) |
+| `total_days_shown` | integer | Total days the ad has been shown |
+| `details_link` | string | Link to the ad in the Transparency Center |
+| `result_type` | string | Record type, for example `ad` |
+| `fetched_at` | string | When the ad was fetched (ISO 8601) |
+
+## Example workflows
+
+### 1. Track a competitor's ad activity
+
+1. **Schedule Trigger**: run weekly.
+2. **Google Ads Transparency**: Advertiser ID a competitor, Output `Simplified`.
+3. **Google Sheets**: append `adCreativeId`, `format`, and `totalDaysShown`.
+
+### 2. Alert on new ad creatives
+
+1. **Schedule Trigger**: run daily.
+2. **Google Ads Transparency**: an advertiser.
+3. **Remove Duplicates** then **Slack**: alert on new `adCreativeId` values.
+
+### 3. Let an AI Agent research ads
+
+1. **AI Agent** node.
+2. Attach **Google Ads Transparency** as a tool.
+3. Ask "What ads is this advertiser currently running?" The agent calls the node (in Simplified mode) and answers.
+
+## Pricing
+
+This node calls the [Google Ads Transparency API](https://apify.com/johnvc/google-ads-transparency-api?fpr=9n7kx3) on Apify, which is billed **pay-per-result**, with no subscription and no minimums. Apify also includes a free monthly usage tier that covers typical volumes. See the [Actor page](https://apify.com/johnvc/google-ads-transparency-api?fpr=9n7kx3) for current rates.
+
+## Resources
+
+- [Google Ads Transparency API on Apify](https://apify.com/johnvc/google-ads-transparency-api?fpr=9n7kx3)
+- [npm package](https://www.npmjs.com/package/n8n-nodes-google-ads-transparency-api)
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+- [Apify n8n integration guide](https://docs.apify.com/platform/integrations/n8n)
+
+## License
+
+[MIT](LICENSE.md)

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

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

package/dist/credentials/ApifyApi.credentials.js

@@ -0,0 +1,36 @@
+"use strict";
+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#api-token';
+        this.icon = "file:../nodes/ApifyAdsTransparency/logo.svg";
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                method: 'GET',
+                url: 'https://api.apify.com/v2/me',
+            },
+        };
+    }
+}
+exports.ApifyApi = ApifyApi;
+//# sourceMappingURL=ApifyApi.credentials.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApifyApi.credentials.js","sourceRoot":"","sources":["../../credentials/ApifyApi.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAa,QAAQ;IAArB;QACC,SAAI,GAAG,UAAU,CAAC;QAElB,gBAAW,GAAG,WAAW,CAAC;QAE1B,qBAAgB,GAAG,4DAA4D,CAAC;QAEhF,SAAI,GAAS,6CAA6C,CAAA;QAE1D,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;aACX;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,iCAAiC;iBAChD;aACD;SACD,CAAC;QAKF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,6BAA6B;aAClC;SACD,CAAC;IACH,CAAC;CAAA;AArCD,4BAqCC"}

package/dist/credentials/ApifyOAuth2Api.credentials.d.ts

@@ -0,0 +1,9 @@
+import type { Icon, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ApifyOAuth2Api implements ICredentialType {
+    name: string;
+    extends: string[];
+    displayName: string;
+    icon: Icon;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/ApifyOAuth2Api.credentials.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApifyOAuth2Api = void 0;
+const scopes = ['profile', 'full_api_access'];
+class ApifyOAuth2Api {
+    constructor() {
+        this.name = 'apifyOAuth2Api';
+        this.extends = ['oAuth2Api'];
+        this.displayName = 'Apify OAuth2 API';
+        this.icon = "file:../nodes/ApifyAdsTransparency/logo.svg";
+        this.documentationUrl = 'https://docs.apify.com/api/v2';
+        this.properties = [
+            {
+                displayName: 'Grant Type',
+                name: 'grantType',
+                type: 'hidden',
+                default: 'pkce',
+            },
+            {
+                displayName: 'Authorization URL',
+                name: 'authUrl',
+                type: 'hidden',
+                default: 'https://console.apify.com/authorize/oauth',
+            },
+            {
+                displayName: 'Access Token URL',
+                name: 'accessTokenUrl',
+                type: 'hidden',
+                default: 'https://console-backend.apify.com/oauth/apps/token',
+            },
+            {
+                displayName: 'Scope',
+                name: 'scope',
+                type: 'hidden',
+                default: `${scopes.join(' ')}`,
+            },
+            {
+                displayName: 'Auth URI Query Parameters',
+                name: 'authQueryParameters',
+                type: 'hidden',
+                default: '',
+            },
+            {
+                displayName: 'Authentication',
+                name: 'authentication',
+                type: 'hidden',
+                default: 'header',
+            },
+            {
+                displayName: 'Client ID',
+                name: 'clientId',
+                type: 'hidden',
+                default: '',
+            },
+            {
+                displayName: 'Client Secret',
+                name: 'clientSecret',
+                type: 'hidden',
+                default: '',
+                typeOptions: { password: true },
+            },
+        ];
+    }
+}
+exports.ApifyOAuth2Api = ApifyOAuth2Api;
+//# sourceMappingURL=ApifyOAuth2Api.credentials.js.map

package/dist/credentials/ApifyOAuth2Api.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApifyOAuth2Api.credentials.js","sourceRoot":"","sources":["../../credentials/ApifyOAuth2Api.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;AAE9C,MAAa,cAAc;IAA3B;QACC,SAAI,GAAG,gBAAgB,CAAC;QAExB,YAAO,GAAG,CAAC,WAAW,CAAC,CAAC;QAExB,gBAAW,GAAG,kBAAkB,CAAC;QAEjC,SAAI,GAAS,6CAA6C,CAAA;QAG1D,qBAAgB,GAAG,+BAA+B,CAAC;QAEnD,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,MAAM;aACf;YACD;gBACC,WAAW,EAAE,mBAAmB;gBAChC,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,2CAA2C;aACpD;YACD;gBACC,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,oDAAoD;aAC7D;YACD;gBACC,WAAW,EAAE,OAAO;gBACpB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;aAC9B;YACD;gBACC,WAAW,EAAE,2BAA2B;gBACxC,IAAI,EAAE,qBAAqB;gBAC3B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;aACX;YACD;gBACC,WAAW,EAAE,gBAAgB;gBAC7B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,QAAQ;aACjB;YACD;gBACC,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;aACX;YACD;gBACC,WAAW,EAAE,eAAe;gBAC5B,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC/B;SACD,CAAC;IACH,CAAC;CAAA;AA/DD,wCA+DC"}

package/dist/nodes/ApifyAdsTransparency/ApifyAdsTransparency.node.d.ts

@@ -0,0 +1,13 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare const ACTOR_ID: string;
+export declare const PACKAGE_NAME: string;
+export declare const CLASS_NAME: string;
+export declare const ClassNameCamel: string;
+export declare const X_PLATFORM_HEADER_ID: string;
+export declare const X_PLATFORM_APP_HEADER_ID: string;
+export declare const DISPLAY_NAME: string;
+export declare const DESCRIPTION: string;
+export declare class ApifyAdsTransparency implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/ApifyAdsTransparency/ApifyAdsTransparency.node.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApifyAdsTransparency = exports.DESCRIPTION = exports.DISPLAY_NAME = exports.X_PLATFORM_APP_HEADER_ID = exports.X_PLATFORM_HEADER_ID = exports.ClassNameCamel = exports.CLASS_NAME = exports.PACKAGE_NAME = exports.ACTOR_ID = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const ApifyAdsTransparency_properties_1 = require("./ApifyAdsTransparency.properties");
+const executeActor_1 = require("./helpers/executeActor");
+exports.ACTOR_ID = '1SOrTCb3mzaT2TXHK';
+exports.PACKAGE_NAME = 'n8n-nodes-google-ads-transparency-api';
+exports.CLASS_NAME = 'ApifyAdsTransparency';
+exports.ClassNameCamel = exports.CLASS_NAME.charAt(0).toLowerCase() + exports.CLASS_NAME.slice(1);
+exports.X_PLATFORM_HEADER_ID = 'n8n';
+exports.X_PLATFORM_APP_HEADER_ID = 'google-ads-transparency-app';
+exports.DISPLAY_NAME = 'Google Ads Transparency';
+exports.DESCRIPTION = 'Get an advertiser\'s ads from the Google Ads Transparency Center with formats and run dates';
+class ApifyAdsTransparency {
+    constructor() {
+        this.description = {
+            displayName: exports.DISPLAY_NAME,
+            name: exports.ClassNameCamel,
+            icon: 'file:logo.svg',
+            group: ['transform'],
+            version: [1],
+            defaultVersion: 1,
+            subtitle: 'Get Ads',
+            description: exports.DESCRIPTION,
+            defaults: {
+                name: exports.DISPLAY_NAME,
+            },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            usableAsTool: true,
+            credentials: [
+                {
+                    displayName: 'Apify API key connection',
+                    name: 'apifyApi',
+                    required: false,
+                    displayOptions: {
+                        show: {
+                            authentication: ['apifyApi'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Apify OAuth2 connection',
+                    name: 'apifyOAuth2Api',
+                    required: false,
+                    displayOptions: {
+                        show: {
+                            authentication: ['apifyOAuth2Api'],
+                        },
+                    },
+                },
+            ],
+            properties: ApifyAdsTransparency_properties_1.properties,
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const data = await executeActor_1.runActor.call(this, i);
+                for (const item of data) {
+                    returnData.push({ ...item, pairedItem: { item: i } });
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: error.message },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeApiError(this.getNode(), error, { itemIndex: i });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.ApifyAdsTransparency = ApifyAdsTransparency;
+//# sourceMappingURL=ApifyAdsTransparency.node.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApifyAdsTransparency.node.js","sourceRoot":"","sources":["../../../nodes/ApifyAdsTransparency/ApifyAdsTransparency.node.ts"],"names":[],"mappings":";;;AAAA,+CAQsB;AACtB,uFAA+D;AAC/D,yDAAkD;AAGrC,QAAA,QAAQ,GAAG,mBAA6B,CAAC;AAEzC,QAAA,YAAY,GAAG,uCAAiD,CAAC;AACjE,QAAA,UAAU,GAAG,sBAAgC,CAAC;AAC9C,QAAA,cAAc,GAAG,kBAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,kBAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE1E,QAAA,oBAAoB,GAAG,KAAe,CAAC;AACvC,QAAA,wBAAwB,GAAG,6BAAuC,CAAC;AAEnE,QAAA,YAAY,GAAG,yBAAmC,CAAC;AACnD,QAAA,WAAW,GACvB,6FAAuG,CAAC;AAEzG,MAAa,oBAAoB;IAAjC;QACC,gBAAW,GAAyB;YACnC,WAAW,EAAE,oBAAY;YACzB,IAAI,EAAE,sBAAc;YAGpB,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,CAAC,WAAW,CAAC;YAEpB,OAAO,EAAE,CAAC,CAAC,CAAC;YACZ,cAAc,EAAE,CAAC;YAGjB,QAAQ,EAAE,SAAS;YAGnB,WAAW,EAAE,mBAAW;YACxB,QAAQ,EAAE;gBACT,IAAI,EAAE,oBAAY;aAClB;YACD,MAAM,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YAClC,OAAO,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YACnC,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE;gBACZ;oBACC,WAAW,EAAE,0BAA0B;oBACvC,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE,KAAK;oBACf,cAAc,EAAE;wBACf,IAAI,EAAE;4BACL,cAAc,EAAE,CAAC,UAAU,CAAC;yBAC5B;qBACD;iBACD;gBACD;oBACC,WAAW,EAAE,yBAAyB;oBACtC,IAAI,EAAE,gBAAgB;oBACtB,QAAQ,EAAE,KAAK;oBACf,cAAc,EAAE;wBACf,IAAI,EAAE;4BACL,cAAc,EAAE,CAAC,gBAAgB,CAAC;yBAClC;qBACD;iBACD;aACD;YAED,UAAU,EAAV,4CAAU;SACV,CAAC;IA0BH,CAAC;IAxBA,KAAK,CAAC,OAAO;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,UAAU,GAAyB,EAAE,CAAC;QAE5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC;gBACJ,MAAM,IAAI,GAAG,MAAM,uBAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC1C,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;oBACzB,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvD,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;oBAC3B,UAAU,CAAC,IAAI,CAAC;wBACf,IAAI,EAAE,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE;wBACzC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;qBACvB,CAAC,CAAC;oBACH,SAAS;gBACV,CAAC;gBACD,MAAM,IAAI,2BAAY,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAmB,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/E,CAAC;QACF,CAAC;QAED,OAAO,CAAC,UAAU,CAAC,CAAC;IACrB,CAAC;CACD;AAzED,oDAyEC"}

package/dist/nodes/ApifyAdsTransparency/ApifyAdsTransparency.node.json

@@ -0,0 +1,34 @@
+{
+    "node": "n8n-nodes-google-ads-transparency-api",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": [
+        "Data & Storage",
+        "Analytics",
+        "Marketing"
+    ],
+    "resources": {
+        "credentialDocumentation": [
+            {
+                "url": "https://docs.apify.com/platform/integrations/n8n"
+            }
+        ],
+        "primaryDocumentation": [
+            {
+                "url": "https://apify.com/johnvc/google-ads-transparency-api?fpr=9n7kx3"
+            }
+        ]
+    },
+    "alias": [
+        "google ads transparency",
+        "ads transparency",
+        "ad library",
+        "competitor ads",
+        "advertising",
+        "ad intelligence",
+        "ads",
+        "marketing",
+        "ad creatives",
+        "apify"
+    ]
+}

package/dist/nodes/ApifyAdsTransparency/ApifyAdsTransparency.properties.d.ts

@@ -0,0 +1,3 @@
+import { IExecuteFunctions, INodeProperties } from 'n8n-workflow';
+export declare function buildActorInput(context: IExecuteFunctions, itemIndex: number, defaultInput: Record<string, any>): Record<string, any>;
+export declare const properties: INodeProperties[];

package/dist/nodes/ApifyAdsTransparency/ApifyAdsTransparency.properties.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.properties = void 0;
+exports.buildActorInput = buildActorInput;
+function buildActorInput(context, itemIndex, defaultInput) {
+    const input = {
+        ...defaultInput,
+        advertiserId: context.getNodeParameter('advertiserId', itemIndex),
+        maxResultsPerAdvertiser: context.getNodeParameter('maxResultsPerAdvertiser', itemIndex),
+    };
+    const region = context.getNodeParameter('region', itemIndex, '');
+    if (region)
+        input.region = region;
+    return input;
+}
+const resourceProperties = [
+    {
+        displayName: 'Resource',
+        name: 'resource',
+        type: 'options',
+        noDataExpression: true,
+        options: [
+            {
+                name: 'Ad',
+                value: 'ad',
+            },
+        ],
+        default: 'ad',
+    },
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['ad'],
+            },
+        },
+        options: [
+            {
+                name: 'Get',
+                value: 'get',
+                action: 'Get ads for an advertiser',
+                description: 'Get ads run by an advertiser, one item per ad',
+            },
+        ],
+        default: 'get',
+    },
+];
+const actorProperties = [
+    {
+        displayName: 'Advertiser ID',
+        name: 'advertiserId',
+        type: 'string',
+        required: true,
+        default: '',
+        placeholder: 'e.g. AR03136609393588568065',
+        description: 'The Google Ads Transparency advertiser ID',
+        displayOptions: { show: { resource: ['ad'], operation: ['get'] } },
+    },
+    {
+        displayName: 'Region',
+        name: 'region',
+        type: 'string',
+        default: '',
+        placeholder: 'e.g. US',
+        description: 'Region code to filter ads by where they ran. Optional.',
+        displayOptions: { show: { resource: ['ad'], operation: ['get'] } },
+    },
+    {
+        displayName: 'Maximum Results per Advertiser',
+        name: 'maxResultsPerAdvertiser',
+        type: 'number',
+        default: 50,
+        typeOptions: { minValue: 1 },
+        description: 'How many ads to return',
+        displayOptions: { show: { resource: ['ad'], operation: ['get'] } },
+    },
+];
+const outputProperties = [
+    {
+        displayName: 'Output',
+        name: 'output',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: { show: { resource: ['ad'], operation: ['get'] } },
+        options: [
+            {
+                name: 'Raw',
+                value: 'raw',
+                description: 'Return every field the API produces for each ad',
+            },
+            {
+                name: 'Selected Fields',
+                value: 'selected',
+                description: 'Choose exactly which fields to return',
+            },
+            {
+                name: 'Simplified',
+                value: 'simplified',
+                description: 'Return a compact set of the most useful ad fields',
+            },
+        ],
+        default: 'simplified',
+        description: 'How much data to return for each ad',
+    },
+    {
+        displayName: 'Fields to Include',
+        name: 'fields',
+        type: 'multiOptions',
+        displayOptions: {
+            show: { resource: ['ad'], operation: ['get'], output: ['selected'] },
+        },
+        options: [
+            { name: 'Ad Creative ID', value: 'ad_creative_id' },
+            { name: 'Advertiser', value: 'advertiser' },
+            { name: 'Advertiser ID', value: 'advertiser_id' },
+            { name: 'Details Link', value: 'details_link' },
+            { name: 'Fetched At', value: 'fetched_at' },
+            { name: 'First Shown', value: 'first_shown' },
+            { name: 'Format', value: 'format' },
+            { name: 'Last Shown', value: 'last_shown' },
+            { name: 'Position', value: 'position' },
+            { name: 'Result Type', value: 'result_type' },
+            { name: 'Total Days Shown', value: 'total_days_shown' },
+        ],
+        default: ['advertiser', 'ad_creative_id', 'format', 'first_shown', 'last_shown'],
+        description: 'Which fields to return when Output is set to Selected Fields',
+    },
+];
+const authenticationProperties = [
+    {
+        displayName: 'Authentication',
+        name: 'authentication',
+        type: 'options',
+        options: [
+            {
+                name: 'API Key',
+                value: 'apifyApi',
+            },
+            {
+                name: 'OAuth2',
+                value: 'apifyOAuth2Api',
+            },
+        ],
+        default: 'apifyApi',
+        description: 'Choose which authentication method to use',
+    },
+];
+exports.properties = [
+    ...resourceProperties,
+    ...actorProperties,
+    ...outputProperties,
+    ...authenticationProperties,
+];
+//# sourceMappingURL=ApifyAdsTransparency.properties.js.map

package/dist/nodes/ApifyAdsTransparency/ApifyAdsTransparency.properties.js.map

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

package/dist/nodes/ApifyAdsTransparency/helpers/executeActor.d.ts

@@ -0,0 +1,5 @@
+import { IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+export declare function getDefaultBuild(this: IExecuteFunctions, actorId: string): Promise<any>;
+export declare function getDefaultInputsFromBuild(build: any): Record<string, any>;
+export declare function runActorApi(this: IExecuteFunctions, actorId: string, mergedInput: Record<string, any>, qs: Record<string, any>): Promise<any>;
+export declare function runActor(this: IExecuteFunctions, i: number): Promise<INodeExecutionData[]>;

package/dist/nodes/ApifyAdsTransparency/helpers/executeActor.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultBuild = getDefaultBuild;
+exports.getDefaultInputsFromBuild = getDefaultInputsFromBuild;
+exports.runActorApi = runActorApi;
+exports.runActor = runActor;
+const n8n_workflow_1 = require("n8n-workflow");
+const genericFunctions_1 = require("./genericFunctions");
+const ApifyAdsTransparency_node_1 = require("../ApifyAdsTransparency.node");
+const ApifyAdsTransparency_properties_1 = require("../ApifyAdsTransparency.properties");
+async function getDefaultBuild(actorId) {
+    const defaultBuildResp = await genericFunctions_1.apiRequest.call(this, {
+        method: 'GET',
+        uri: `/v2/acts/${actorId}/builds/default`,
+    });
+    if (!(defaultBuildResp === null || defaultBuildResp === void 0 ? void 0 : defaultBuildResp.data)) {
+        throw new n8n_workflow_1.NodeApiError(this.getNode(), {
+            message: `Could not fetch default build for Actor ${actorId}`,
+        });
+    }
+    return defaultBuildResp.data;
+}
+function getDefaultInputsFromBuild(build) {
+    var _a, _b;
+    const buildInputProperties = (_b = (_a = build === null || build === void 0 ? void 0 : build.actorDefinition) === null || _a === void 0 ? void 0 : _a.input) === null || _b === void 0 ? void 0 : _b.properties;
+    const defaultInput = {};
+    if (buildInputProperties && typeof buildInputProperties === 'object') {
+        for (const [key, property] of Object.entries(buildInputProperties)) {
+            if (property &&
+                typeof property === 'object' &&
+                'prefill' in property &&
+                property.prefill !== undefined &&
+                property.prefill !== null) {
+                defaultInput[key] = property.prefill;
+            }
+        }
+    }
+    return defaultInput;
+}
+async function runActorApi(actorId, mergedInput, qs) {
+    return await genericFunctions_1.apiRequest.call(this, {
+        method: 'POST',
+        uri: `/v2/acts/${actorId}/runs`,
+        body: mergedInput,
+        qs,
+    });
+}
+function shapeItem(item, mode, fields) {
+    if (mode === 'raw') {
+        return item;
+    }
+    if (mode === 'selected') {
+        const picked = {};
+        for (const field of fields) {
+            if (field in item) {
+                picked[field] = item[field];
+            }
+        }
+        return picked;
+    }
+    return {
+        advertiser: item.advertiser,
+        advertiserId: item.advertiser_id,
+        adCreativeId: item.ad_creative_id,
+        format: item.format,
+        firstShown: item.first_shown,
+        lastShown: item.last_shown,
+        totalDaysShown: item.total_days_shown,
+        detailsLink: item.details_link,
+    };
+}
+async function runActor(i) {
+    var _a, _b;
+    const build = await getDefaultBuild.call(this, ApifyAdsTransparency_node_1.ACTOR_ID);
+    const defaultInput = getDefaultInputsFromBuild(build);
+    const mergedInput = (0, ApifyAdsTransparency_properties_1.buildActorInput)(this, i, defaultInput);
+    const run = await runActorApi.call(this, ApifyAdsTransparency_node_1.ACTOR_ID, mergedInput, { waitForFinish: 0 });
+    if (!((_a = run === null || run === void 0 ? void 0 : run.data) === null || _a === void 0 ? void 0 : _a.id)) {
+        throw new n8n_workflow_1.NodeApiError(this.getNode(), {
+            message: 'Run ID not found after starting the Actor',
+        });
+    }
+    const runId = run.data.id;
+    const datasetId = run.data.defaultDatasetId;
+    await genericFunctions_1.pollRunStatus.call(this, runId);
+    const items = await genericFunctions_1.getResults.call(this, datasetId);
+    let mode = this.getNodeParameter('output', i, 'simplified');
+    if ((0, genericFunctions_1.isUsedAsAiTool)(this.getNode().type)) {
+        mode = 'simplified';
+    }
+    const fields = (_b = this.getNodeParameter('fields', i, [])) !== null && _b !== void 0 ? _b : [];
+    const shaped = items.map((item) => shapeItem(item, mode, fields));
+    return this.helpers.returnJsonArray(shaped);
+}
+//# sourceMappingURL=executeActor.js.map

package/dist/nodes/ApifyAdsTransparency/helpers/executeActor.js.map

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

package/dist/nodes/ApifyAdsTransparency/helpers/genericFunctions.d.ts

@@ -0,0 +1,10 @@
+import { type IExecuteFunctions, type IHookFunctions, type ILoadOptionsFunctions, type IHttpRequestOptions } from 'n8n-workflow';
+type IApiRequestOptions = Omit<IHttpRequestOptions, 'url'> & {
+    uri?: string;
+    url?: string;
+};
+export declare function apiRequest(this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions, requestOptions: IApiRequestOptions): Promise<any>;
+export declare function isUsedAsAiTool(nodeType: string): boolean;
+export declare function pollRunStatus(this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions, runId: string): Promise<any>;
+export declare function getResults(this: IExecuteFunctions, datasetId: string): Promise<any[]>;
+export {};

package/dist/nodes/ApifyAdsTransparency/helpers/genericFunctions.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiRequest = apiRequest;
+exports.isUsedAsAiTool = isUsedAsAiTool;
+exports.pollRunStatus = pollRunStatus;
+exports.getResults = getResults;
+const n8n_workflow_1 = require("n8n-workflow");
+const ApifyAdsTransparency_node_1 = require("../ApifyAdsTransparency.node");
+async function apiRequest(requestOptions) {
+    var _a;
+    const { method = 'GET', qs, uri, ...rest } = requestOptions;
+    const query = qs || {};
+    const endpoint = `https://api.apify.com${uri !== null && uri !== void 0 ? uri : ''}`;
+    const headers = {
+        'x-apify-integration-platform': ApifyAdsTransparency_node_1.X_PLATFORM_HEADER_ID,
+        ...(ApifyAdsTransparency_node_1.X_PLATFORM_APP_HEADER_ID && { 'x-apify-integration-app-id': ApifyAdsTransparency_node_1.X_PLATFORM_APP_HEADER_ID }),
+    };
+    if (isUsedAsAiTool(this.getNode().type)) {
+        headers['x-apify-integration-ai-tool'] = 'true';
+    }
+    const options = {
+        ...rest,
+        method,
+        qs: query,
+        url: endpoint,
+        headers,
+        json: true,
+    };
+    if (method === 'GET' && 'body' in options) {
+        delete options.body;
+    }
+    try {
+        const authenticationMethod = this.getNodeParameter('authentication', 0);
+        try {
+            await this.getCredentials(authenticationMethod);
+        }
+        catch {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `No valid credentials found for ${authenticationMethod}. Please configure them first.`);
+        }
+        return await this.helpers.httpRequestWithAuthentication.call(this, authenticationMethod, options);
+    }
+    catch (error) {
+        const apiError = error;
+        const body = (_a = apiError.response) === null || _a === void 0 ? void 0 : _a.body;
+        if (body) {
+            throw new n8n_workflow_1.NodeApiError(this.getNode(), apiError, {
+                message: typeof body === 'string' ? body : JSON.stringify(body),
+                description: apiError.message,
+            });
+        }
+        throw new n8n_workflow_1.NodeApiError(this.getNode(), apiError);
+    }
+}
+function isUsedAsAiTool(nodeType) {
+    const parts = nodeType.split('.');
+    return parts[parts.length - 1] === `${ApifyAdsTransparency_node_1.ClassNameCamel}Tool`;
+}
+async function pollRunStatus(runId) {
+    var _a;
+    let lastRunData;
+    while (true) {
+        try {
+            const pollResult = await apiRequest.call(this, {
+                method: 'GET',
+                uri: `/v2/actor-runs/${runId}`,
+            });
+            const status = (_a = pollResult === null || pollResult === void 0 ? void 0 : pollResult.data) === null || _a === void 0 ? void 0 : _a.status;
+            lastRunData = pollResult === null || pollResult === void 0 ? void 0 : pollResult.data;
+            if (['SUCCEEDED', 'FAILED', 'TIMED-OUT', 'ABORTED'].includes(status))
+                break;
+        }
+        catch (err) {
+            throw new n8n_workflow_1.NodeApiError(this.getNode(), {
+                message: `Error polling run status: ${err}`,
+            });
+        }
+        await (0, n8n_workflow_1.sleep)(1000);
+    }
+    return lastRunData;
+}
+async function getResults(datasetId) {
+    const results = await apiRequest.call(this, {
+        method: 'GET',
+        uri: `/v2/datasets/${datasetId}/items`,
+    });
+    if (Array.isArray(results)) {
+        return results;
+    }
+    return results ? [results] : [];
+}
+//# sourceMappingURL=genericFunctions.js.map

package/dist/nodes/ApifyAdsTransparency/helpers/genericFunctions.js.map

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

package/dist/nodes/ApifyAdsTransparency/logo.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 64 64" fill="none">
+  <!-- badge -->
+  <rect x="4" y="4" width="56" height="56" rx="14" fill="#2563EB"/>
+  <!-- megaphone -->
+  <path d="M16 28 L40 20 V44 L16 36 Z" fill="#DBEAFE"/>
+  <rect x="40" y="22" width="6" height="20" rx="3" fill="#93C5FD"/>
+  <path d="M20 36 v6 a4 4 0 0 0 8 0 v-3" fill="none" stroke="#DBEAFE" stroke-width="3"/>
+  <!-- sound -->
+  <path d="M50 26 q4 6 0 12" fill="none" stroke="#DBEAFE" stroke-width="3" stroke-linecap="round"/>
+</svg>

package/dist/package.json

@@ -0,0 +1,74 @@
+{
+    "name": "n8n-nodes-google-ads-transparency-api",
+    "version": "0.1.0",
+    "description": "Get an advertiser's ads from the Google Ads Transparency Center with formats and run dates. Apify-backed n8n community node, pay-per-result, and usable as an AI agent tool.",
+    "keywords": [
+        "n8n-community-node-package",
+        "n8n-nodes",
+        "n8n",
+        "google-ads-transparency",
+        "ad-library",
+        "competitor-ads",
+        "advertising",
+        "ad-intelligence",
+        "marketing",
+        "apify",
+        "ai-tool"
+    ],
+    "license": "MIT",
+    "author": {
+        "name": "John Cole",
+        "email": "tirade.charge_4v@icloud.com"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/johnisanerd/n8n-nodes-google-ads-transparency-api.git"
+    },
+    "homepage": "https://github.com/johnisanerd/n8n-nodes-google-ads-transparency-api#readme",
+    "bugs": {
+        "url": "https://github.com/johnisanerd/n8n-nodes-google-ads-transparency-api/issues"
+    },
+    "engines": {
+        "node": ">=18.10"
+    },
+    "packageManager": "npm@10.8.2",
+    "main": "index.js",
+    "scripts": {
+        "build": "n8n-node build",
+        "dev": "n8n-node dev",
+        "lint": "n8n-node lint",
+        "lint:fix": "n8n-node lint --fix"
+    },
+    "files": [
+        "dist"
+    ],
+    "n8n": {
+        "n8nNodesApiVersion": 1,
+        "credentials": [
+            "dist/credentials/ApifyApi.credentials.js",
+            "dist/credentials/ApifyOAuth2Api.credentials.js"
+        ],
+        "nodes": [
+            "dist/nodes/ApifyAdsTransparency/ApifyAdsTransparency.node.js"
+        ]
+    },
+    "peerDependencies": {
+        "n8n-workflow": "*"
+    },
+    "devDependencies": {
+        "@n8n/node-cli": "0.32.1",
+        "@types/jest": "^29.5.14",
+        "@types/node": "^24.0.1",
+        "apify-client": "^2.16.0",
+        "chalk": "^5.6.0",
+        "eslint": "9.29.0",
+        "glob": "^11.0.3",
+        "gulp": "^4.0.2",
+        "jest": "^29.7.0",
+        "nock": "^14.0.5",
+        "prettier": "^3.6.2",
+        "sharp": "^0.34.2",
+        "ts-jest": "^29.3.2",
+        "typescript": "5.9.2"
+    }
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+	"name": "n8n-nodes-google-ads-transparency-api",
+	"version": "0.1.0",
+	"description": "Get an advertiser's ads from the Google Ads Transparency Center with formats and run dates. Apify-backed n8n community node, pay-per-result, and usable as an AI agent tool.",
+	"keywords": [
+		"n8n-community-node-package",
+		"n8n-nodes",
+		"n8n",
+		"google-ads-transparency",
+		"ad-library",
+		"competitor-ads",
+		"advertising",
+		"ad-intelligence",
+		"marketing",
+		"apify",
+		"ai-tool"
+	],
+	"license": "MIT",
+	"author": {
+		"name": "John Cole",
+		"email": "tirade.charge_4v@icloud.com"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/johnisanerd/n8n-nodes-google-ads-transparency-api.git"
+	},
+	"homepage": "https://github.com/johnisanerd/n8n-nodes-google-ads-transparency-api#readme",
+	"bugs": {
+		"url": "https://github.com/johnisanerd/n8n-nodes-google-ads-transparency-api/issues"
+	},
+	"engines": {
+		"node": ">=18.10"
+	},
+	"packageManager": "npm@10.8.2",
+	"main": "index.js",
+	"scripts": {
+		"build": "n8n-node build",
+		"dev": "n8n-node dev",
+		"lint": "n8n-node lint",
+		"lint:fix": "n8n-node lint --fix"
+	},
+	"files": [
+		"dist"
+	],
+	"n8n": {
+		"n8nNodesApiVersion": 1,
+		"credentials": [
+			"dist/credentials/ApifyApi.credentials.js",
+			"dist/credentials/ApifyOAuth2Api.credentials.js"
+		],
+		"nodes": [
+			"dist/nodes/ApifyAdsTransparency/ApifyAdsTransparency.node.js"
+		]
+	},
+	"peerDependencies": {
+		"n8n-workflow": "*"
+	},
+	"devDependencies": {
+		"@n8n/node-cli": "0.32.1",
+		"@types/jest": "^29.5.14",
+		"@types/node": "^24.0.1",
+		"apify-client": "^2.16.0",
+		"chalk": "^5.6.0",
+		"eslint": "9.29.0",
+		"glob": "^11.0.3",
+		"gulp": "^4.0.2",
+		"jest": "^29.7.0",
+		"nock": "^14.0.5",
+		"prettier": "^3.6.2",
+		"sharp": "^0.34.2",
+		"ts-jest": "^29.3.2",
+		"typescript": "5.9.2"
+	}
+}