{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Center Scraper - Ads by Brand", "description": "Ads from the Google Ads Transparency Center by advertiser name, domain or id: format, first and last shown, regions, impressions where Google shows them, preview, image, video and ad text. Region, date, format and platform filters. New-ad alerts. No login.", "version": "0.1", "x-build-id": "MpI9uDcBo0jki2uMP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dottti~google-ads-transparency/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dottti-google-ads-transparency", "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/dottti~google-ads-transparency/runs": { "post": { "operationId": "runs-sync-dottti-google-ads-transparency", "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/dottti~google-ads-transparency/run-sync": { "post": { "operationId": "run-sync-dottti-google-ads-transparency", "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": { "advertisers": { "title": "Advertisers (names, domains or advertiser ids)", "type": "array", "description": "One per line. A domain (nike.com, https://www.noon.com), an advertiser id (AR16735076323512287233) or Transparency Center link, or an advertiser name (Nike). Names are matched to Google's advertiser list; see 'Advertisers per name'. Empty input runs a 10-ad demo for nike.com.", "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Country where the ads were shown, as a 2-letter code (US, GB, SA, AE, EG, DE) or 'anywhere' for all countries.", "default": "anywhere" }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Optional. Only ads shown on or after this date: 2026-10-01, or a relative time such as 30 days, 4 weeks, 3 months." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Optional. Only ads shown on or before this date (2026-10-31 or a relative time)." }, "format": { "title": "Ad format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format.", "default": "ALL" }, "platform": { "title": "Google platform", "enum": [ "ALL", "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "type": "string", "description": "Only ads shown on this Google platform.", "default": "ALL" }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Newest ads to fetch for each advertiser or domain (Google lists ads by last shown date). Large brands have thousands.", "default": 40 }, "maxAdvertisersPerName": { "title": "Advertisers per name", "minimum": 1, "maximum": 10, "type": "integer", "description": "When you type a name, how many matching advertiser accounts to scrape. 1 = the closest match with the most ads (for 'Nike' that is Nike, Inc.). Raise it to include regional accounts such as Nike Retail BV.", "default": 1 }, "includeDetails": { "title": "Include regions and impressions", "type": "boolean", "description": "One extra request per ad for the list of countries with first and last shown dates, impression ranges where Google publishes them (EU and some other regions), and the number of variations. Turn off for a faster, lighter run.", "default": true }, "includeAdText": { "title": "Include ad text and video link", "type": "boolean", "description": "Opens each ad's preview to read the headline and description text, the YouTube video link of video ads and the product image of Shopping ads. Slower: one extra download of about 100 to 400 kB per ad. Text ads that Google stores only as an image have no text to read.", "default": false }, "onlyNew": { "title": "Only new ads (alert mode)", "type": "boolean", "description": "Remembers the ads each advertiser returned last time (per filter set) and delivers only new ones on the next run. Schedule the actor for alerts. The first run delivers everything and saves the baseline. You pay only for new ads.", "default": false }, "stateName": { "title": "Alert list name", "type": "string", "description": "Name for the saved only-new list, so several schedules (for example 'competitors-ksa' and 'brand-us') keep separate memories.", "default": "default" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Leave empty: the actor starts without a proxy and moves to Apify datacenter, then residential proxy only if Google rate-limits it. Set your own proxy here to use only that." }, "autoProxyFallback": { "title": "Automatic proxy fallback", "type": "boolean", "description": "Move to Apify Proxy when Google rate-limits the direct connection.", "default": true }, "allowResidentialFallback": { "title": "Allow residential proxy", "type": "boolean", "description": "Let the fallback use residential proxy as the last step. Residential traffic is included in the price.", "default": true }, "maxRetries": { "title": "Max retries per request", "minimum": 1, "maximum": 8, "type": "integer", "description": "Retries for each request on rate limits, server errors or network errors, with growing waits.", "default": 4 } } }, "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 } } } } } } } } } }