{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Monitor", "description": "See every Google ad a company runs. Enter a domain or advertiser name and get one row per ad from the Ads Transparency Center: format, first and last shown dates, creative link, and permalink, plus a company summary row with the total ad count band. Batch domains, export to CSV or Clay.", "version": "0.1", "x-build-id": "fhG2tNrkwB9b72WsA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mambalabs~google-ads-transparency-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mambalabs-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/mambalabs~google-ads-transparency-monitor/runs": { "post": { "operationId": "runs-sync-mambalabs-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/mambalabs~google-ads-transparency-monitor/run-sync": { "post": { "operationId": "run-sync-mambalabs-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", "properties": { "company_domain": { "title": "Company domain", "type": "string", "description": "The company website domain, for example stripe.com. Returns ads that Google lists for that domain. Use this or Advertiser name." }, "advertiser_name": { "title": "Advertiser name", "type": "string", "description": "The advertiser's name as Google verifies it, for example Stripe, Inc. Exact name matches are used, up to 5 advertisers; otherwise the closest suggestion, labeled closest on each row." }, "domains": { "title": "Company domains (batch)", "type": "array", "description": "Several company domains, one per line. Each gets its own ad rows and summary row. Up to 500 inputs per run.", "items": { "type": "string" } }, "advertiser_names": { "title": "Advertiser names (batch)", "type": "array", "description": "Several advertiser names, one per line.", "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Where the ads were shown: anywhere, or a two letter country code such as US, GB, DE, or FR. The README lists every supported code.", "default": "anywhere" }, "formats": { "title": "Ad formats", "type": "array", "description": "Limit to text, image, or video ads. Leave empty for all formats.", "items": { "type": "string", "enum": [ "text", "image", "video" ], "enumTitles": [ "Text", "Image", "Video" ] } }, "max_ads": { "title": "Maximum ads per input", "type": "string", "description": "How many ad rows to return per domain or advertiser, 1 to 1,000. Each ad row is billed, so this is also your cost control per input.", "default": "50" }, "since_days": { "title": "Last shown within (days)", "type": "string", "description": "Only return ads last shown in this many days. 0 returns every ad Google lists, however old.", "default": "90" }, "include_summary": { "title": "Include company summary row", "enum": [ "true", "false" ], "type": "string", "description": "One extra row per input with the total ad count band, formats seen, and the first and last dates seen. The summary row is billed only when ads were found.", "default": "true" }, "max_charge_usd": { "title": "Maximum charge for this run (USD)", "type": "string", "description": "Optional. The run stops before any row that would take its charges over this amount. Leave empty to rely only on the maximum cost per run you set in Apify." }, "skipCache": { "title": "Skip the 24 hour cache", "enum": [ "false", "true" ], "type": "string", "description": "Results for the same input and filters are kept for 24 hours in your own account and returned free. Choose Yes to read fresh results.", "default": "false" }, "proxy_mode": { "title": "Connection", "enum": [ "auto", "direct", "residential" ], "type": "string", "description": "auto (default): connect directly, and if Google refuses a request, switch to the Apify proxy default pool for the rest of the run. direct: the off switch, never use a proxy; a refused request returns a free blocked row. residential: use Apify residential proxy from the start. Proxy use adds nothing to your price; this is a reliability choice.", "default": "auto" }, "source_tag": { "title": "Source Tag", "type": "string", "description": "Internal attribution tag set by Mamba Labs on published task examples. Not required, and nothing depends on it. Leave it empty." } } }, "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 } } } } } } } } } }