{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper & Ad Monitor", "description": "Export public Google Ads Transparency Center ad records by advertiser, domain or ID. Filter by country, date, format and platform; request available media and statistics.", "version": "0.1", "x-build-id": "BGbPnKjfgc1LGdoBM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-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/fetch_cat~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-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/fetch_cat~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-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": { "queries": { "title": "Advertisers, domains, keywords, IDs, or URLs", "type": "array", "description": "Enter advertiser or brand names, domains, Google advertiser IDs beginning with AR, or advertiser URLs from Google Ads Transparency Center. Names and domains use advertiser suggestions; URLs containing an AR ID search that advertiser's ads, not one exact creative. This is advertiser discovery, not an ad-copy keyword search.", "items": { "type": "string" } }, "advertiserIds": { "title": "Direct advertiser IDs", "type": "array", "description": "Optional Google advertiser IDs beginning with AR. Direct IDs skip advertiser suggestion lookup and are best for repeat monitoring.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "US", "CA", "MX", "BZ", "GT", "SV", "HN", "NI", "CR", "PA", "CU", "JM", "HT", "DO", "TT", "BB", "BS", "GD", "LC", "VC", "KN", "DM", "CO", "VE", "GY", "SR", "BR", "EC", "PE", "BO", "PY", "UY", "AR", "CL", "GB", "IE", "FR", "MC", "BE", "NL", "LU", "DE", "AT", "CH", "LI", "NO", "SE", "DK", "FI", "IS", "EE", "LV", "LT", "ES", "PT", "IT", "MT", "GR", "CY", "AL", "SI", "HR", "BA", "ME", "RS", "MK", "PL", "CZ", "SK", "HU", "RO", "BG", "MD", "UA", "BY", "RU", "GE", "AM", "AZ", "KZ", "UZ", "TM", "TJ", "KG", "TR", "IL", "LB", "JO", "IQ", "KW", "SA", "AE", "QA", "BH", "OM", "YE", "AF", "PK", "IN", "BD", "NP", "BT", "LK", "MV", "CN", "TW", "HK", "MO", "JP", "KR", "MN", "TH", "VN", "KH", "LA", "MM", "MY", "SG", "ID", "PH", "BN", "TL", "AU", "NZ", "PG", "FJ", "MA", "DZ", "TN", "LY", "EG", "SD", "MR", "ML", "NE", "SN", "GM", "CV", "GW", "GN", "SL", "LR", "CI", "GH", "BF", "TG", "BJ", "NG", "CM", "CF", "TD", "CD", "CG", "GA", "GQ", "ET", "ER", "DJ", "SO", "SS", "KE", "UG", "TZ", "RW", "BI", "AO", "ZM", "MW", "MZ", "ZW", "NA", "BW", "ZA", "LS", "SZ", "MG", "MU", "SC" ], "type": "string", "description": "Country used for the public Google Ads Transparency search. Unsupported codes are rejected instead of silently using another country.", "default": "US" }, "adStatus": { "title": "Ad status", "enum": [ "all", "active", "inactive" ], "type": "string", "description": "Save all ads, active ads whose last-shown date is today or later, or inactive historical ads.", "default": "all" }, "dateFrom": { "title": "First date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional date in YYYY-MM-DD format. Ads last shown before this date are skipped." }, "maxResultsPerQuery": { "title": "Maximum ads per query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of ad records to save for each query or advertiser ID.", "default": 20 }, "searchTerms": { "title": "Legacy search terms", "type": "array", "description": "Backward-compatible alias for queries used by older tasks and API integrations. New integrations should use queries.", "items": { "type": "string" } }, "regions": { "title": "Legacy regions", "maxItems": 1, "type": "array", "description": "Backward-compatible alias for country. The first two-letter country code is used when country is not explicitly set.", "items": { "type": "string" } }, "adFormats": { "title": "Legacy ad formats", "uniqueItems": true, "type": "array", "description": "Backward-compatible alias for formats. Accepts text, image, and video.", "items": { "type": "string", "enum": [ "text", "image", "video" ] } }, "platforms": { "title": "Google platforms", "uniqueItems": true, "type": "array", "description": "Only return ads shown on the selected Google platforms. Platform-filtered results cover ads shown from September 4, 2023 onward.", "items": { "type": "string", "enum": [ "GOOGLE_SEARCH", "YOUTUBE", "GOOGLE_SHOPPING", "GOOGLE_MAPS", "GOOGLE_PLAY" ], "enumTitles": [ "Google Search", "YouTube", "Google Shopping", "Google Maps", "Google Play" ] }, "default": [] }, "formats": { "title": "Creative formats", "uniqueItems": true, "type": "array", "description": "Only save creatives matching the selected formats.", "items": { "type": "string", "enum": [ "text", "image", "video" ], "enumTitles": [ "Text", "Image", "Video" ] }, "default": [] }, "dateTo": { "title": "Last date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional date in YYYY-MM-DD format. Ads first shown after this date are skipped." }, "maxItems": { "title": "Legacy maximum ads", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Backward-compatible alias for maxResultsPerQuery used by older tasks and API integrations." }, "maxAdsScannedPerQuery": { "title": "Maximum ads scanned per query", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Safety limit for ads inspected while applying format, status, or date filters. A query returns partial results instead of scanning indefinitely.", "default": 500 }, "compareDatasetId": { "title": "Baseline dataset", "type": "string", "description": "Optional previous dataset (ID or name) to compare with this run. The Actor writes new, removed, and unchanged ad IDs to CHANGE_SUMMARY." }, "includeAdDetails": { "title": "Include ad details", "type": "boolean", "description": "Fetch extra creative details and media. Leave disabled for faster, more reliable discovery runs; enable when detail fields are important.", "default": false }, "includeTransparencyStats": { "title": "Include regional transparency statistics", "type": "boolean", "description": "Fetch detailed regions, impression ranges, and platform breakdowns where Google publishes them. Availability varies by country and ad.", "default": false }, "downloadMedia": { "title": "Download creative media", "type": "boolean", "description": "Save exposed image and video files to the run key-value store and return their record keys. This automatically fetches ad details.", "default": false }, "proxyConfiguration": { "title": "Connection settings", "type": "object", "description": "Apify Proxy is enabled by default and used from the first Google request when initialization succeeds. Keep the default, select your own proxy URLs or groups, or disable Apify Proxy with no custom URLs for direct-only access. Explicit saved-task/API settings are preserved; omission enables the same existing managed configuration. Country defaults to the search country; initialization can retry without the country restriction. Retries use the configured proxy product without automatic residential escalation. Invalid settings are rejected before collection and charging, not converted into a managed default. If proxy initialization is unavailable, requests use direct access only. Proxy traffic can incur platform usage. Never share proxy credentials in support requests.", "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 } } } } } } } } } }