{ "openapi": "3.0.1", "info": { "title": "Google Ads Advertiser Intelligence & Creative Clusters", "description": "Organize public Google Ads Transparency data by advertiser, creative and theme. Extract available creative metadata and advertiser summaries for agency research. Public ad data does not reveal private campaign performance.", "version": "1.0", "x-build-id": "LntU7DYPbvngP3VWY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/egeusta~google-ads-transparency-competitor-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-egeusta-google-ads-transparency-competitor-intelligence", "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/egeusta~google-ads-transparency-competitor-intelligence/runs": { "post": { "operationId": "runs-sync-egeusta-google-ads-transparency-competitor-intelligence", "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/egeusta~google-ads-transparency-competitor-intelligence/run-sync": { "post": { "operationId": "run-sync-egeusta-google-ads-transparency-competitor-intelligence", "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": "One entry per competitor: an advertiser domain (nike.com), an advertiser name (Nike), a Transparency Center advertiser ID (AR12345678901234567890) or a pasted adstransparency.google.com/advertiser/AR... URL. Domains and names are matched to the largest advertiser with a similar name; use the ID to pin an exact advertiser.", "default": [ "nike.com" ], "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Only \"anywhere\" is currently supported (Google's region filter could not be verified, so other values are rejected rather than silently ignored).", "default": "anywhere" }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper bound on ad creatives collected per advertiser. Each delivered creative is billed, so start small.", "default": 200 }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 200, "type": "integer", "description": "Upper bound on result pages requested per advertiser.", "default": 10 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Per-request timeout for Transparency Center fetches.", "default": 30 }, "concurrency": { "title": "Advertiser concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "Number of advertisers processed in parallel.", "default": 2 }, "minRequestDelayMs": { "title": "Minimum delay between requests (ms)", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Client-side rate limiting between requests / retries.", "default": 800 }, "maxRetries": { "title": "Max retries", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries for transient request failures (timeout, network, HTTP error).", "default": 2 }, "maxResponseBytes": { "title": "Max response bytes", "minimum": 100000, "maximum": 40000000, "type": "integer", "description": "Hard ceiling on bytes read from a single Transparency Center response.", "default": 4000000 }, "longRunningDays": { "title": "Long-running threshold (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "An ad is flagged long-running when its observed run duration is at least this many days.", "default": 30 }, "newAdWindowDays": { "title": "New ad window (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "An ad is flagged new when it was first shown within this many days of the run date.", "default": 7 }, "activeWindowDays": { "title": "Active window (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "An ad is treated as active when last shown within this many days of the run date (or still running).", "default": 14 }, "resetSnapshot": { "title": "Reset stored snapshot", "type": "boolean", "description": "Ignore any stored snapshot and treat this run as a fresh baseline (no change events).", "default": false } } }, "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 } } } } } } } } } }