{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper by Advertiser Name", "description": "Find any advertiser by name, no domain needed, then pull every ad they run from Google Ads Transparency Center. Worldwide by default, full pagination, image and video creatives, first and last shown dates.", "version": "0.1", "x-build-id": "ZwkoTqp1Y6w0DQ7Vw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sourcedirect~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sourcedirect-google-ads-transparency-scraper", "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/sourcedirect~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-sourcedirect-google-ads-transparency-scraper", "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/sourcedirect~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-sourcedirect-google-ads-transparency-scraper", "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": { "domains": { "title": "Advertiser domains", "type": "array", "description": "Domains to look up, e.g. `nike.com`. Returns every ad Google is showing for the advertiser that owns the domain.", "items": { "type": "string" } }, "advertiserNames": { "title": "Advertiser names", "type": "array", "description": "Search for an advertiser by **name** instead of hunting for their domain or ID, e.g. `Nike`. You get back every matching advertiser with its ID, its country and roughly how many ads it is running, plus any matching domains. Take the ID you want and put it in **Advertiser IDs** to pull that advertiser's ads. Matches are ranked for the first country in **Countries**, or the United States if you leave that empty.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Google advertiser IDs (they start with `AR`). Use these instead of, or as well as, domains. Every result row includes the `advertiserId` it came from, so you can feed IDs back in later.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "ISO-3166 alpha-2 country codes, e.g. `US`, `GB`, `AU`. **Leave empty to search worldwide, which is what you usually want.** The worldwide result set contains every ad from every country. Only narrow this if you specifically want the ads Google serves in one market. Numeric Google geo-target IDs also work.", "items": { "type": "string" } }, "maxAdsPerAdvertiser": { "title": "Max ads per target", "minimum": 0, "type": "integer", "description": "Stop after this many ads for each domain or advertiser ID. Set to 0 for no limit, which follows pagination until the advertiser is exhausted. Large advertisers run tens of thousands of ads, so the default of 50 keeps a first run fast and cheap. Raise it once you know the shape of the data you are getting.", "default": 50 }, "delayBetweenPages": { "title": "Delay between pages", "minimum": 0, "maximum": 60, "type": "number", "description": "Politeness delay between paginated requests. Half a second costs about 12 seconds per 1,000 ads and keeps a single IP well under Google's throttle. Set it to 0 for maximum speed on small jobs, or raise it for very large ones.", "default": 0.5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "**Leave this on.** Google throttles the Ads Transparency endpoint per source IP, and it throttles shared cloud IP ranges hard. Measured on the Apify platform: with the proxy off, a nike.com lookup returned HTTP 429 and zero ads after 4 minutes 45 seconds. With the proxy on, the same lookup returned 40 ads in under a second. Turning this off is only sensible if you are running the Actor somewhere with its own clean IP.", "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 } } }, "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 } } } } } } } } } }