{ "openapi": "3.0.1", "info": { "title": "Google Ads Analyzer", "description": "Extract ad data from Google Ads Transparency Center by domain. Three modes: FULL (basic data), OCR (AI text extraction from images - headlines, descriptions, URLs), and LITE (summary counts). Filter by date range and region. Perfect for competitor analysis and ad research.", "version": "0.1", "x-build-id": "70kPRFPOxuNQmcqRF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/amernas~google-ads-analyzer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-amernas-google-ads-analyzer", "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/amernas~google-ads-analyzer/runs": { "post": { "operationId": "runs-sync-amernas-google-ads-analyzer", "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/amernas~google-ads-analyzer/run-sync": { "post": { "operationId": "run-sync-amernas-google-ads-analyzer", "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": [ "keywords" ], "properties": { "keywords": { "title": "Domain Name", "type": "string", "description": "A single domain name (e.g., 'clay.com', 'apify.com') or Google Ads Transparency Center URL (e.g., 'https://adstransparency.google.com/?region=anywhere&domain=clay.com') to search for ads." }, "runMode": { "title": "Run Mode", "enum": [ "FULL", "OCR", "LITE" ], "type": "string", "description": "Select the run mode. 'FULL' fetches detailed ad information without OCR. 'OCR' fetches detailed ad information WITH OCR text extraction. 'LITE' fetches only counts of ad creatives per format for each advertiser.", "default": "FULL" }, "dateRangePreset": { "title": "Date Range Preset", "enum": [ "ANYTIME", "LAST_7_DAYS", "LAST_30_DAYS", "CUSTOM_RANGE" ], "type": "string", "description": "Select a preset date range for filtering ads, or choose 'Custom Range' to specify start and end dates.", "default": "ANYTIME" }, "customStartDate": { "title": "Custom Start Date (YYYY-MM-DD)", "type": "string", "description": "Specify the start date for the custom date range (e.g., 2023-01-01). Used only if 'Date Range Preset' is 'Custom Range'." }, "customEndDate": { "title": "Custom End Date (YYYY-MM-DD)", "type": "string", "description": "Specify the end date for the custom date range (e.g., 2023-01-31). Used only if 'Date Range Preset' is 'Custom Range'." }, "count": { "title": "Max Ads Count Per Keyword", "minimum": 1, "type": "integer", "description": "The maximum number of ad creatives to retrieve for each keyword/found advertiser when in FULL or OCR mode. For LITE mode, the actor attempts to count all relevant creatives.", "default": 10 }, "region": { "title": "Region Code", "type": "string", "description": "The region code to filter ads by (e.g., 'US', 'GB'). Use 'anywhere' for no specific region. Refer to README.md or script's show_regions_list() for available codes.", "default": "anywhere" }, "proxyConfig": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by the scraper. Uses Apify Proxy or custom proxy URLs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [] } } } }, "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 } } } } } } } } } }