{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Center Scraper", "description": "See every ad an advertiser is running on Google (Search, YouTube, Shopping, Maps, Play) with first/last shown dates, format, preview creative and ad text, by advertiser ID, advertiser name or domain. Pay per ad.", "version": "0.1", "x-build-id": "DP6FjakqJyTRNuzTO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ceo.sss~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ceo.sss-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/ceo.sss~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-ceo.sss-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/ceo.sss~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-ceo.sss-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": { "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Google advertiser IDs (start with AR...). Copy from an adstransparency.google.com/advertiser/AR... URL. Fastest and most precise option.", "items": { "type": "string" } }, "advertiserNames": { "title": "Advertiser names", "type": "array", "description": "Free-text advertiser names, e.g. \"Shopify\". Google's name search is a prefix match, so we fetch 50 candidates and pick the verified advertiser with the most ads (see maxAdvertisersPerName). The chosen advertiser is logged. For big brands prefer domains or advertiserIds.", "items": { "type": "string" } }, "domains": { "title": "Domains", "type": "array", "description": "Website domains, e.g. \"notion.so\". Returns ads from every advertiser whose ads link to that domain (matchedDomain is set on each row).", "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "\"anywhere\" or an ISO 3166-1 alpha-2 country code (US, GB, IN, DE, ...). Only ads shown in that region are returned.", "default": "anywhere" }, "format": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only ads of this format (Google's classification). Text ads are often stored as screenshots.", "default": "all" }, "platform": { "title": "Platform", "enum": [ "all", "search", "youtube", "shopping", "maps", "play" ], "type": "string", "description": "Only ads shown on this Google surface.", "default": "all" }, "dateFrom": { "title": "Shown on or after", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "YYYY-MM-DD. Only ads that were shown on or after this date." }, "dateTo": { "title": "Shown on or before", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "YYYY-MM-DD. Only ads that were shown on or before this date." }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser / domain", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Cap per advertiser ID (or per domain query). Ads are returned newest activity first.", "default": 100 }, "maxAdvertisersPerName": { "title": "Advertisers to take per name", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many matching advertisers to scrape for each entry in advertiserNames.", "default": 1 }, "includeCreativeDetails": { "title": "Include creative details (regions + ad text)", "type": "boolean", "description": "Makes 1-2 extra requests per ad to fetch the regions the ad was shown in and, where Google renders the ad as HTML, the visible ad text and creative image URLs. Slower; roughly 3x the requests. Ads that Google only stores as a screenshot cannot yield text.", "default": false }, "includeRaw": { "title": "Include raw parsed data", "type": "boolean", "description": "Attach the parsed upstream preview (and detail, if fetched) under `raw` for debugging.", "default": false }, "minDelayMs": { "title": "Min delay between requests (ms)", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Pause between requests. Measured: one IP survives about 50 requests/min for only 1-2 minutes before Google's 429/captcha wall, but 20-25/min for hundreds of requests. Lower only with residential proxies.", "default": 2500 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy is on by default and is enough at the default delay. Switch to RESIDENTIAL if you see repeated 429s.", "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 } } } } } } } } } }