{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Ad Copy, Creatives & New Ads", "description": "Search Google Ads Transparency Center by advertiser or domain. Export copy and media where available, filter by region/platform/date and monitor unseen ads. Coverage depends on limits and source access.", "version": "0.1", "x-build-id": "YhkqhLYstAWeQUtVf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datasmithlab~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datasmithlab-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/datasmithlab~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-datasmithlab-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/datasmithlab~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-datasmithlab-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": "Advertiser names, domains or IDs", "type": "array", "description": "Advertiser names (Nike), domains (nike.com) or advertiser IDs (AR16735076323512287233). A name is matched to the advertisers Google suggests for it.", "items": { "type": "string" } }, "domains": { "title": "Domains", "type": "array", "description": "Optional. Ads whose landing page is on these domains, e.g. hubspot.com.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Optional. IDs from the advertiser's Transparency Center page (AR…).", "items": { "type": "string" } }, "startUrls": { "title": "Transparency Center URLs", "type": "array", "description": "Optional. Paste advertiser pages (adstransparency.google.com/advertiser/AR…) or domain searches (?domain=…). Only the advertiser or domain is taken from the URL; use the Region, Platforms and date fields below for filters.", "items": { "type": "string" } }, "resultType": { "title": "What to return", "enum": [ "ads", "advertisers" ], "type": "string", "description": "Advertisers mode is a cheap check: total ad count and advertiser names for each domain, or the advertisers that match each name.", "default": "ads" }, "region": { "title": "Region", "enum": [ "anywhere", "AE", "AL", "AM", "AR", "AT", "AU", "AZ", "BA", "BD", "BE", "BG", "BH", "BR", "BY", "CA", "CH", "CL", "CN", "CO", "CR", "CY", "CZ", "DE", "DK", "DO", "DZ", "EC", "EE", "EG", "ES", "ET", "FI", "FR", "GB", "GE", "GH", "GR", "GT", "HK", "HR", "HU", "ID", "IE", "IL", "IN", "IS", "IT", "JO", "JP", "KE", "KR", "KW", "KZ", "LB", "LK", "LT", "LU", "LV", "MA", "MD", "ME", "MK", "MT", "MX", "MY", "NG", "NL", "NO", "NZ", "OM", "PA", "PE", "PH", "PK", "PL", "PR", "PT", "QA", "RO", "RS", "RU", "SA", "SE", "SG", "SI", "SK", "TH", "TN", "TR", "TW", "UA", "US", "UY", "VE", "VN", "ZA" ], "type": "string", "description": "Country where the ads were shown, or 'anywhere'.", "default": "US" }, "platforms": { "title": "Platforms", "type": "array", "description": "Leave empty for all platforms. YouTube and Google Maps for now; more platforms are added once each filter is verified.", "items": { "type": "string", "enum": [ "MAPS", "YOUTUBE" ], "enumTitles": [ "Google Maps", "YouTube" ] } }, "adFormat": { "title": "Ad format", "enum": [ "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Leave empty for all." }, "startDate": { "title": "Shown from", "type": "string", "description": "Only ads shown on or after this date (YYYY-MM-DD)." }, "endDate": { "title": "Shown until", "type": "string", "description": "Only ads shown on or before this date (YYYY-MM-DD)." }, "includeAdContent": { "title": "Extract ad copy", "type": "boolean", "description": "Read each ad's preview and return its text: headline, description, display URL, sitelinks, CTA, Shopping product title, YouTube video ID. Ads where text is found are charged as 'ad with content'.", "default": true }, "includeDetails": { "title": "Include regions and variations", "type": "boolean", "description": "One extra request per ad: the countries it was shown in (with last shown date) and all its variations.", "default": false }, "onlyNewAds": { "title": "Only new ads since last run", "type": "boolean", "description": "Return only ads not seen in a previous run with the same search. Schedule it daily to monitor competitors. Make the first run large enough to see all current ads (a small first run leaves older ads 'new'). Up to 10 extra pages of already seen ads are checked per advertiser/domain.", "default": false }, "maxAdsPerTarget": { "title": "Max ads per advertiser/domain", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Per domain, per advertiser ID, and per advertiser matched by a name. Google returns 40 ads per page. With 'Only new ads', already seen ads do not count.", "default": 100 }, "maxAdvertisersPerQuery": { "title": "Max advertisers per name", "minimum": 1, "maximum": 50, "type": "integer", "description": "A name like 'Nike' matches several advertisers; the ones with the most ads are used first.", "default": 3 }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Hard stop: you are never charged for more rows than this.", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google limits each IP to a few dozen requests. Residential proxy (default) is the most reliable; datacenter IPs get blocked quickly.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }