{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Monitor: New Ad Alerts", "description": "New ads from Google's Ads Transparency Center for any advertiser — creative ID, format, first/last shown dates, days shown and the ad creative itself. Monitor mode delivers only ads that are new since your last run. $0.01 per new ad, no start fee, runs with no new ads are free.", "version": "0.0", "x-build-id": "rSKVDe2g5Hg23vIjA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/magnova~google-ads-transparency-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-magnova-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/magnova~google-ads-transparency-monitor/runs": { "post": { "operationId": "runs-sync-magnova-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/magnova~google-ads-transparency-monitor/run-sync": { "post": { "operationId": "run-sync-magnova-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": [ "advertisers" ], "properties": { "adsPerAdvertiser": { "title": "Ads checked per advertiser per run", "minimum": 10, "maximum": 200, "type": "integer", "description": "How many of each advertiser's current ads are fetched and compared against the monitor store on every run (the diffing window). Only ads inside this window can be detected as new, so size it above the most ads an advertiser could launch between two runs: 40 suits daily checks of most advertisers; raise it (up to 200) for weekly checks of very active advertisers. Checking itself is free — you only pay for new ads actually delivered." }, "advertisers": { "title": "Advertisers to monitor", "type": "array", "description": "The advertisers to watch in Google's Ads Transparency Center — your competitors, your clients, or your own brands. Give each advertiser in ONE of these forms (AR ID or URL is best): (1) its AR advertiser ID, e.g. \"AR12815412684405080065\" (Amazon US); (2) its Ads Transparency Center URL, e.g. \"https://adstransparency.google.com/advertiser/AR12815412684405080065\" (a creative URL works too — its advertiser is monitored); (3) a name or domain, which is resolved by search. Name search is only an assist: regional namesakes are common (\"Nike\" first matches a Kenyan namesake), so a resolved name is reported as a warning in the run SUMMARY, and a name with several plausible matches produces an ERROR record listing the candidate AR IDs instead of guessing. Up to 50 advertisers per run.", "items": { "type": "string" } }, "maxTotalChargeUsd": { "title": "Maximum total charge per run (USD)", "minimum": 0.01, "type": "number", "description": "Optional hard stop for this run's charges: delivery stops as soon as the charged ads reach this amount (checked conservatively at the highest per-ad price, so the run may stop slightly early on discounted tiers), and the SUMMARY record reports stoppedByMaxCharge. Leave empty for no cap. The run-level maximum charge in the run options is also honoured exactly." }, "monitorOnlyNew": { "title": "Start monitoring silently (skip the first baseline)", "type": "boolean", "description": "Off (default): the first run for an advertiser delivers its current ads as a baseline batch (charged), later runs deliver only new ones. On: the first run silently remembers the current ads without delivering or charging anything, and only ads launched afterwards are ever delivered. Only applies when a monitor store is selected; without a store every run is a baseline run." }, "monitorStore": { "title": "Monitor state store (for only-new delivery)", "type": "string", "description": "A key-value store this Actor may read and write to remember which ads it has already seen for each advertiser — this is what makes only-new delivery work across runs. Pick any store you own; the Actor keeps one small state record in it. Without a store, every run delivers all checked ads as a NEW baseline and remembers nothing. If the store is missing or cannot be opened, the run continues in baseline mode and the SUMMARY record says so — it never crashes." } } }, "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 } } } } } } } } } }