{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Competitor Ads & Monitoring", "description": "Get the ads any advertiser runs on Google Search, YouTube, Shopping, Maps and Play, from the Ads Transparency Center: images, formats, dates, regions and EU reach. Search by name, domain or link.", "version": "0.1", "x-build-id": "OoaVoyH5zrLepFmMW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stratumics~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stratumics-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/stratumics~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-stratumics-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/stratumics~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-stratumics-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": { "advertisers": { "title": "Advertisers", "type": "array", "description": "Advertiser ids from the Transparency Center (AR followed by digits, as in its links) for an exact match, or advertiser names (for example Nike). A name is matched to the account with the most ads among Google's suggestions (in the chosen region), or to the account behind the brand's .com website; a doubtful match is reported in the log. Raise \"Advertisers per name\" to take more matches.", "items": { "type": "string" } }, "domains": { "title": "Domains", "type": "array", "description": "Websites, for example nike.com. You get the ads that link to the site, from every advertiser account that runs them.", "default": [], "items": { "type": "string" } }, "urls": { "title": "Ads Transparency Center links", "type": "array", "description": "Optional. Paste links copied from adstransparency.google.com: an advertiser page, a domain search or a single ad. The region, platform, format and dates in a link apply to it.", "default": [], "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Only ads shown in this country. Anywhere returns ads from every region. A region filter is strict: an advertiser that targets other countries can return few or no ads.", "default": "anywhere" }, "platform": { "title": "Platform", "enum": [ "all", "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "type": "string", "description": "Only ads shown on this Google service. Google applies this filter to ads shown since September 2023.", "default": "all" }, "format": { "title": "Ad format", "enum": [ "all", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only text, image or video ads.", "default": "all" }, "dateRange": { "title": "Date range", "enum": [ "anytime", "today", "yesterday", "last-7-days", "last-30-days", "custom" ], "type": "string", "description": "Only ads shown in this period (UTC). Choose Custom to set your own dates below.", "default": "anytime" }, "startDate": { "title": "Custom start date", "type": "string", "description": "First day of a custom date range (YYYY-MM-DD). Used only when Date range is Custom." }, "endDate": { "title": "Custom end date", "type": "string", "description": "Last day of a custom date range (YYYY-MM-DD). Leave empty for today." }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 0, "maximum": 10000, "type": "integer", "description": "How many ads to read for each advertiser, domain or link, most recently shown first. 0 reads up to 10,000.", "default": 100 }, "maxAdvertisersPerName": { "title": "Advertisers per name", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many advertiser accounts a name may match, biggest first. Brands often run separate accounts per country.", "default": 1 }, "includeDetails": { "title": "Include ad details", "type": "boolean", "description": "Open each ad's detail page and preview for every variation, the regions it ran in with dates, the ad text (headline, description, display URL, call to action) and YouTube video where Google shows them, and for ads shown in the EU the times shown, platforms, topic and audience selection. Up to two extra requests per ad; when Google rate-limits every connection, the rest of the ads are saved without them. No extra charge.", "default": true }, "onlyNewAds": { "title": "Only new ads", "type": "boolean", "description": "Save only ads earlier runs with the same inputs have not returned. The Actor remembers creative ids in the key-value store google-ads-transparency-monitor in your account. Pair it with a schedule for competitor alerts.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional. A name for the remembered list, so different schedules keep separate histories even with the same inputs. Leave empty to derive it from the inputs.", "default": "" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "With Apify Proxy on (the default), the Actor starts with a direct connection, moves requests to Apify Proxy datacenter IPs when Google rate-limits it or a run needs many detail pages, and to residential IPs (at no extra charge to you) when Google refuses the datacenter ones too. Ad previews never use residential IPs. Turn it off to never use a proxy, or pick proxy groups or your own proxy URLs to send every request through them.", "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 } } } } } } } } } }