{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Center Scraper by Domain", "description": "Every Google ad a company runs, by domain or advertiser name, from the Ads Transparency Center. Batch domains, export to CSV or Clay.", "version": "0.1", "x-build-id": "Yjo0lTaRgPaDcxET1" }, "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" }, "only_new_ads": { "title": "Only new ads", "enum": [ "false", "true" ], "type": "string", "description": "Off by default. Choose Yes on a scheduled run to return only ads not delivered by an earlier run with the same state key, input, region, and formats. Only new ad rows are charged. The first run returns every ad and records them. The summary row then carries new_ads.", "default": "false" }, "state_key": { "title": "State key", "type": "string", "description": "Optional. Names the saved list of delivered ads for Only new ads, so two schedules on the same company keep separate lists. Letters, digits, dot, dash, and underscore." }, "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 } } } } } } } } } }