{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Ad Copy, Headlines & Creatives", "description": "Scrape competitors' Google Ads from the Ads Transparency Center by domain, brand or advertiser ID: headlines, descriptions, display URLs and sitelinks of text ads (read from the ad), image and video creatives, first and last shown dates. Filter by country, format and date. Monitor mode for new ads.", "version": "0.1", "x-build-id": "H1cliV6BtV1QbOYsv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plain-signal~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plain-signal-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/plain-signal~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-plain-signal-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/plain-signal~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-plain-signal-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", "required": [ "advertisers" ], "properties": { "advertisers": { "title": "Advertisers", "type": "array", "description": "One per line: a website domain (nike.com), an advertiser ID (AR16735076323512287233), a link from adstransparency.google.com, or a brand name (Nike; the advertiser with the most ads is used).", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "anywhere", "US", "GB", "CA", "AU", "DE", "AT", "CH", "FR", "ES", "IT", "NL", "BE", "PL", "SE", "DK", "NO", "FI", "IE", "PT", "BR", "MX", "AR", "CO", "CL", "IN", "JP", "KR", "SG", "HK", "TW", "ID", "MY", "PH", "TH", "VN", "AE", "SA", "IL", "TR", "ZA", "NG", "KE", "EG", "NZ", "CZ", "HU", "RO", "GR", "UA", "PK", "PE", "BG", "CN" ], "type": "string", "description": "Only ads shown in this country. 'Anywhere' covers all countries.", "default": "anywhere" }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Newest ads first. Large brands run thousands of ads; set this to what you need.", "default": 100 }, "includeAdCopy": { "title": "Include ad copy", "type": "boolean", "description": "Read headline, description, display URL and sitelinks from each ad. Text ads are read from Google's rendered screenshot with OCR. Turn off for faster runs if you only need dates and creative links.", "default": true }, "mode": { "title": "Mode", "enum": [ "ads", "advertisers" ], "type": "string", "description": "'Ads' returns every ad. 'Advertiser check' returns one row per entry: does it run Google Ads, roughly how many, and when it last ran one. Useful for lead lists.", "default": "ads" }, "adFormat": { "title": "Ad format", "enum": [ "ANY", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format.", "default": "ANY" }, "shownInLastDays": { "title": "Shown in the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only ads Google showed within this many days. Leave empty for all ads, including ones that stopped running." }, "maxItems": { "title": "Max results in total", "minimum": 1, "type": "integer", "description": "Stop after this many results across all advertisers. Caps the cost of a run.", "default": 1000 }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Give a name (e.g. 'competitors') and schedule the Actor: each run checks the newest ads (up to 'Max ads per advertiser') and returns only those it hasn't returned before under that name." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed normally. Use Apify Proxy if Google starts rate-limiting large runs.", "default": { "useApifyProxy": 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 } } } } } } } } } }