{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper + New Ads Monitor", "description": "All Google ads an advertiser or domain runs, from the Google Ads Transparency Center: format, first/last shown, image or YouTube link, and optionally headline, body, landing page and per-country reach. Monitoring mode outputs only new ads.", "version": "1.0", "x-build-id": "B1jdvI5p34qdRgfrE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ninoventures~google-ads-transparency-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ninoventures-google-ads-transparency-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ninoventures~google-ads-transparency-monitor/runs": { "post": { "operationId": "runs-sync-ninoventures-google-ads-transparency-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ninoventures~google-ads-transparency-monitor/run-sync": { "post": { "operationId": "run-sync-ninoventures-google-ads-transparency-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "queries" ], "properties": { "queries": { "title": "Advertisers or domains", "type": "array", "description": "One per line. Accepts an advertiser name (\"Gymshark\"), a website domain (\"gymshark.com\"), an advertiser ID (AR05501100765344694273) or a Transparency Center URL. Names are matched to the advertiser with the most ads; the other matches are listed in the SUMMARY record.", "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Two-letter country code (US, GB, NL, DE, AU...) or \"anywhere\". Same as the region picker on adstransparency.google.com.", "default": "anywhere" }, "maxAdsPerQuery": { "title": "Max ads per advertiser/domain", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Newest ads come first. Large brands have 10,000+ ads, so keep this low for a first test.", "default": 100 }, "includeAdDetails": { "title": "Add ad copy, landing page and per-country reach", "type": "boolean", "description": "Opens each ad to read its headline, body text, call to action, landing page URL, YouTube video ID, variation count and per-country impression ranges and dates. Billed as an extra event per ad. Search text ads are shown by Google as images only, so they get an image URL but no headline.", "default": false }, "onlyNewAds": { "title": "Only output ads not seen in earlier runs", "type": "boolean", "description": "Monitoring mode. The actor remembers creative IDs per query list and region. The first run outputs everything and sets the baseline; later runs output only ads that appeared since. Schedule it daily to get a competitor ad feed.", "default": false }, "monitorName": { "title": "Monitor name (optional)", "type": "string", "description": "Keeps separate memory for separate monitors, e.g. \"client-a\". Leave empty if you run one monitor." }, "lastShownWithinDays": { "title": "Only ads shown in the last N days", "minimum": 0, "type": "integer", "description": "0 = no filter. 30 gives you roughly what is running now.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy (datacenter) is on by default. Google rate-limits single IPs after a few hundred detail lookups; with the proxy the actor switches IP and keeps going. Datacenter proxy is included in Apify's free plan.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }