{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Center Scraper: Any Advertiser's Ads", "description": "Competitive ad intelligence without a login: resolve an advertiser by name or domain, then pull their creatives with preview images, ad text, YouTube video IDs, formats, regions and run dates. Filter by format, platform and date. Built for ad-spy research, agencies and sales prospecting.", "version": "0.1", "x-build-id": "9HZe1zppXe3NbETdR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/everyotherfriday~google-ads-transparency/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-everyotherfriday-google-ads-transparency", "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/everyotherfriday~google-ads-transparency/runs": { "post": { "operationId": "runs-sync-everyotherfriday-google-ads-transparency", "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/everyotherfriday~google-ads-transparency/run-sync": { "post": { "operationId": "run-sync-everyotherfriday-google-ads-transparency", "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": { "advertisers": { "title": "advertisers", "type": "array", "description": "Advertiser IDs, names or domains. Names select the largest matching suggestion; domains can resolve multiple advertisers.", "items": { "type": "string" } }, "region": { "title": "region", "type": "string", "description": "ISO alpha-2 country code, or anywhere.", "default": "anywhere" }, "formats": { "title": "formats", "type": "array", "description": "formats", "items": { "type": "string", "enum": [ "text", "image", "video" ] }, "default": [ "text", "image", "video" ] }, "platforms": { "title": "platforms", "type": "array", "description": "Optional platforms. Display has no current RPC enum and returns an uncharged warning; use no filter for all surfaces.", "items": { "type": "string", "enum": [ "youtube", "search", "display", "maps", "shopping" ] } }, "dateFrom": { "title": "dateFrom", "type": "string", "description": "Inclusive YYYY-MM-DD filter on lastShown; missing dates excluded when filtering." }, "dateTo": { "title": "dateTo", "type": "string", "description": "Inclusive YYYY-MM-DD filter on lastShown; missing dates excluded when filtering." }, "maxCreativesPerAdvertiser": { "title": "maxCreativesPerAdvertiser", "minimum": 1, "maximum": 100000, "type": "integer", "description": "maxCreativesPerAdvertiser", "default": 200 }, "includeCreativeDetails": { "title": "includeCreativeDetails", "type": "boolean", "description": "includeCreativeDetails", "default": false }, "timeoutSecs": { "title": "timeoutSecs", "minimum": 1, "maximum": 120, "type": "integer", "description": "timeoutSecs", "default": 20 }, "proxyConfiguration": { "title": "proxyConfiguration", "type": "object", "description": "Keep Apify Proxy on: Google blocks direct datacenter traffic to the Transparency Center with a /sorry page. Standard datacenter proxy groups work; sessions rotate automatically.", "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 } } } } } } } } } }