{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper + Creative Monitor", "description": "Scrape public Google Ads Transparency creatives, group creative families, analyze competitor ad activity, and monitor new, updated, stopped, and newly observed ads across runs.", "version": "0.1", "x-build-id": "fKeAADazrdatM2IYU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/produkdigitalali~google-ads-transparency-creative-intelligence-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-produkdigitalali-google-ads-transparency-creative-intelligence-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/produkdigitalali~google-ads-transparency-creative-intelligence-monitor/runs": { "post": { "operationId": "runs-sync-produkdigitalali-google-ads-transparency-creative-intelligence-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/produkdigitalali~google-ads-transparency-creative-intelligence-monitor/run-sync": { "post": { "operationId": "run-sync-produkdigitalali-google-ads-transparency-creative-intelligence-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": { "queries": { "title": "Keywords, domains, IDs, or Transparency URLs", "maxItems": 100, "type": "array", "description": "Mixed public search targets. Domains, AR advertiser IDs, full Ads Transparency URLs, and brand keywords are detected automatically.", "items": { "type": "string", "minLength": 1, "maxLength": 8192 }, "default": [] }, "domains": { "title": "Advertiser domains", "maxItems": 100, "type": "array", "description": "Domains to resolve to public Google Ads Transparency advertisers.", "items": { "type": "string", "minLength": 1, "maxLength": 500 }, "default": [] }, "advertiserIds": { "title": "Google advertiser IDs", "maxItems": 100, "type": "array", "description": "Direct AR-prefixed Google Ads Transparency advertiser IDs. Recommended for stable scheduled monitoring.", "items": { "type": "string", "minLength": 3, "maxLength": 100 }, "default": [] }, "targets": { "title": "Advanced target definitions", "maxItems": 100, "type": "array", "description": "Optional explicit target objects with query, target type, stable targetId, and label.", "items": { "type": "object", "required": [ "query" ], "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 8192, "title": "Query", "description": "Keyword, domain, Google AR advertiser ID, or Ads Transparency URL." }, "type": { "type": "string", "enum": [ "keyword", "domain", "advertiser_id", "transparency_url" ], "title": "Target type", "description": "Explicit interpretation of the query." }, "targetId": { "type": "string", "maxLength": 120, "title": "Target ID", "description": "Optional stable target identity copied to outputs." }, "label": { "type": "string", "maxLength": 500, "title": "Label", "description": "Optional human-readable target label." } }, "additionalProperties": false }, "default": [] }, "maxTargets": { "title": "Maximum targets", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum unique target definitions processed in one run.", "default": 20 }, "resolutionPolicy": { "title": "Advertiser resolution policy", "enum": [ "best_match", "all_matches" ], "type": "string", "description": "best_match processes the highest-scoring advertiser; all_matches processes several visible candidates.", "default": "best_match" }, "maxAdvertisersPerTarget": { "title": "Maximum advertisers per target", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum advertiser candidates processed for one target when all_matches is selected.", "default": 3 }, "region": { "title": "Region", "enum": [ "anywhere", "US", "GB", "ID", "AU", "CA", "DE", "FR", "JP", "SG", "IN", "BR", "ES", "IT", "NL", "MX", "KR", "NZ", "MY", "TH", "PH", "VN", "AE", "SA", "ZA", "SE", "CH", "PL", "TR" ], "type": "string", "description": "Google Ads Transparency region filter. Use anywhere for no built-in region filter; regionTargetId can cover additional markets.", "default": "anywhere" }, "regionTargetId": { "title": "Advanced Google region target ID", "minimum": 1, "type": "integer", "description": "Optional Google geo-target ID overriding the built-in region mapping." }, "maxAdsPerAdvertiser": { "title": "Maximum ads per advertiser", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on creative IDs collected for each advertiser. Stop detection is conservative when this limit truncates a crawl.", "default": 100 }, "includeDetails": { "title": "Fetch creative details", "type": "boolean", "description": "Fetch per-creative detail pages/RPC data. Disable only for fast creative-ID discovery.", "default": true }, "includeAdRecords": { "title": "Include ad records", "type": "boolean", "description": "Emit one structured AD record per collected creative in normal reader mode.", "default": true }, "includeAdvertiserSummary": { "title": "Include advertiser intelligence summary", "type": "boolean", "description": "Emit deterministic activity metrics such as format mix, creative-family count, launch velocity, visible lifespan, and landing-domain concentration.", "default": true }, "includeResolutionRecords": { "title": "Include advertiser resolution records", "type": "boolean", "description": "Emit the visible advertiser candidates, scores, ambiguity flag, and selected advertiser IDs for each non-direct target.", "default": true }, "fingerprintMedia": { "title": "Fingerprint image media", "type": "boolean", "description": "Download public image assets when available and compute exact SHA-256 plus a 64-bit perceptual dHash for stronger creative-family grouping.", "default": false }, "auditLandingPages": { "title": "Audit exposed landing pages", "type": "boolean", "description": "When a destination URL is publicly exposed, audit bounded HTTP/SEO signals and monitor landing-page changes, breaks, and recoveries.", "default": false }, "monitorMode": { "title": "Monitoring mode", "type": "boolean", "description": "Persist per-advertiser creative and landing-page state across runs and classify newly observed, proven-new, updated, stopped, reactivated, broken, changed, and recovered signals.", "default": false }, "emitChangesOnly": { "title": "Emit changes only", "type": "boolean", "description": "When monitoring, suppress unchanged creative rows and return only meaningful ad/landing/status changes.", "default": false }, "baselineOnly": { "title": "Quiet first baseline", "type": "boolean", "description": "On the first monitoring run for an advertiser, save current ads without emitting first-observation creative events.", "default": false }, "monitorKey": { "title": "Monitor key", "maxLength": 200, "type": "string", "description": "Namespace for persistent monitoring state. Reuse the same value across related scheduled runs.", "default": "default" }, "stopConfirmationRuns": { "title": "Stop confirmation runs", "minimum": 1, "maximum": 5, "type": "integer", "description": "Number of complete consecutive misses required before AD_STOPPED. The first miss can emit POSSIBLY_STOPPED.", "default": 2 }, "concurrency": { "title": "Creative concurrency", "minimum": 1, "maximum": 40, "type": "integer", "description": "Maximum concurrent creative-detail/media/landing requests inside one advertiser pipeline.", "default": 10 }, "targetConcurrency": { "title": "Target concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum advertiser target pipelines processed concurrently.", "default": 3 }, "requestTimeoutSeconds": { "title": "Request timeout seconds", "minimum": 3, "maximum": 90, "type": "integer", "description": "Per-request timeout for Google/public HTTP requests.", "default": 30 }, "maxRetries": { "title": "Maximum Google retries", "minimum": 0, "maximum": 6, "type": "integer", "description": "Retries transient network, rate-limit, and 5xx Google RPC responses with bounded backoff.", "default": 3 }, "maxRedirects": { "title": "Maximum public redirects", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum redirects followed for public media/landing requests; every redirect target is revalidated against private-network SSRF.", "default": 5 }, "maxMediaBytes": { "title": "Maximum image bytes", "minimum": 1024, "maximum": 10485760, "type": "integer", "description": "Maximum bytes downloaded for one image fingerprint operation.", "default": 5242880 }, "maxLandingPageBytes": { "title": "Maximum landing-page bytes", "minimum": 1024, "maximum": 5242880, "type": "integer", "description": "Maximum bytes downloaded for one exposed landing-page audit.", "default": 2097152 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy configuration. A proxy is recommended for higher-volume Google requests and rate-limit resilience.", "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 } } } } } } } } } }