{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Center Scraper", "description": "Get the ads an advertiser runs on Google, up to 5,000 per input line. Search by name, ID or domain and filter by region, date, format and platform. Each ad has format, first/last shown, days shown, image or preview URL, text where shown, landing domain. Optional per-region dates and impressions.", "version": "0.1", "x-build-id": "Xb0n6pgO8mkiGeTO1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zovo-one~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zovo-one-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/zovo-one~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-zovo-one-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/zovo-one~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-zovo-one-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", "maxItems": 1000, "type": "array", "description": "Who to look up, one per line. Each line can be a website domain (nike.com), an exact advertiser name (Nike, Inc.), an advertiser ID (AR16735076323512287233) or an Ads Transparency Center URL. A domain returns the ads of every advertiser that sends traffic to it, which can include regional companies and resellers. A name must match exactly, but case, accents, punctuation, & vs and, and suffixes such as Inc or GmbH are ignored; if no name matches, the run report (OUTPUT) lists the closest names and their IDs. An ad URL (.../advertiser/AR.../creative/CR...) saves only that ad, if it is among the first 400 ads Google lists for that advertiser with your filters. Up to 100 advertisers per run (at most 1,000 lines in total, counting lines that cannot be read). A line that cannot be read is reported and the other lines still run.", "default": [ "nike.com" ], "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Country where the ads were shown, as a 2-letter code (US, GB, DE, FR, JP; UK also works), or \"anywhere\" for all regions. Empty means anywhere. Example: US", "default": "anywhere" }, "dateFrom": { "title": "Shown since", "pattern": "^(|\\d{4}-\\d{2}-\\d{2}|\\d{1,4}\\s*([Dd][Aa][Yy]|[Ww][Ee][Ee][Kk]|[Mm][Oo][Nn][Tt][Hh]|[Yy][Ee][Aa][Rr])[Ss]?(\\s+[Aa][Gg][Oo])?)$", "type": "string", "description": "Only ads shown on or after this date. Use YYYY-MM-DD (2026-01-01) or a relative value such as \"30 days\", \"2 weeks\", \"3 months\" or \"1 year\". Google's date filter covers about the last 12 months. Leave empty for all dates; every ad still has firstShown and lastShown." }, "dateTo": { "title": "Shown until", "pattern": "^(|\\d{4}-\\d{2}-\\d{2})$", "type": "string", "description": "Only ads shown on or before this date, as YYYY-MM-DD (2026-06-30). Needs \"Shown since\". Empty means today (UTC)." }, "format": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only ads of this format: text, image or video. Many text ads come as an image (imageUrl).", "default": "all" }, "platform": { "title": "Google platform", "enum": [ "all", "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "type": "string", "description": "Only ads shown on this Google platform: Search, YouTube, Shopping, Maps or Play.", "default": "all" }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many ads to save for each line of \"Advertisers\" (1 to 5,000). Each saved ad is one $0.0012 charge, so 100 ads cost $0.12. Big advertisers have thousands of ads. The Actor reads 40 ads per request.", "default": 50 }, "includeDetails": { "title": "Include ad details", "type": "boolean", "description": "Adds, per ad, the regions where it was shown with first and last dates per region, Google's impression ranges where Google publishes them (mainly the EU), platforms and every creative variation's image. Costs one extra request and one \"ad-detail\" charge ($0.002) per ad, and is slower (about one ad per second). Failed lookups are free.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google rate-limits busy IP addresses, so Apify Proxy is on by default. If the run reports that Google blocked every request, pick the RESIDENTIAL proxy group and run again.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 3, "type": "integer", "description": "How many advertisers are read in parallel (1 to 3). All requests share one rate limit.", "default": 2 } } }, "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 } } } } } } } } } }