{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Ads, Text, Videos, Regions", "description": "Scrape the Google Ads Transparency Center by brand name, domain or advertiser ID. Get every ad a company runs on Google Search, YouTube, Shopping, Maps and Play: images, ad text, YouTube links, first and last shown dates, and the countries each ad ran in. No login.", "version": "1.0", "x-build-id": "FbSmK5BMF87GXzuoN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kvali~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kvali-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/kvali~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-kvali-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/kvali~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-kvali-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": [ "queries" ], "properties": { "queries": { "title": "Brands, domains, advertiser IDs or links", "type": "array", "description": "One per line. Mix freely: a brand name (\"Nike\"), a website domain (\"nike.com\": every advertiser whose ads point there), an advertiser ID (\"AR16735076323512287233\") or a link copied from adstransparency.google.com (advertiser, ad or domain page).", "items": { "type": "string" } }, "resultType": { "title": "What to return", "enum": [ "ads", "advertisers" ], "type": "string", "description": "\"Ads\" returns one row per ad. \"Advertisers\" returns one summary row per advertiser (ads found, formats, first and last shown, active in the last 7 days), which is a cheap way to check which companies run Google Ads.", "default": "ads" }, "maxAdsPerQuery": { "title": "Max ads per query", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many ads for each line above (for a brand name, for each matching advertiser). Big brands have tens of thousands of ads.", "default": 50 }, "region": { "title": "Region", "type": "string", "description": "Two-letter country code (US, GB, DE, ...) to get only ads shown in that country. Leave empty for ads shown anywhere.", "default": "" }, "adFormat": { "title": "Ad format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format.", "default": "ALL" }, "platforms": { "title": "Google platforms", "type": "array", "description": "Only ads shown on these Google products. Leave empty for all. Google records platforms only for ads shown since September 2023.", "items": { "type": "string", "enum": [ "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "enumTitles": [ "Google Search", "YouTube", "Google Shopping", "Google Maps", "Google Play" ] }, "default": [] }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Only ads shown on or after this date (YYYY-MM-DD)." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Only ads shown on or before this date (YYYY-MM-DD)." }, "includeDetails": { "title": "Ad details: text, video link, all regions", "type": "boolean", "description": "One extra lookup per ad adds: the ad text (headline, description, display URL, when Google has a text preview), the YouTube video link for video ads, every variation of the ad, and every country it ran in with the last date shown there. Slower, and billed per ad as \"ad details\".", "default": false }, "maxAdvertisersPerQuery": { "title": "Advertisers per brand name", "minimum": 1, "maximum": 10, "type": "integer", "description": "A brand name can match several advertiser accounts (\"Nike, Inc.\", \"Nike Retail BV\", ...). Use this many of the best matches. Domains and advertiser IDs are not affected.", "default": 3 }, "onlyNew": { "title": "Only ads not seen in earlier runs", "type": "boolean", "description": "For scheduled monitoring: skip ads this Actor already returned in earlier runs with the same monitor name. You pay only for new ads.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Keeps separate \"already seen\" lists for different monitors (for example one per competitor). Leave empty to use the shared default list." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google rate-limits heavy use. The Actor slows down, retries and switches to Apify Proxy by itself when needed; turn a proxy on here for very large jobs.", "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 } } } } } } } } } }