{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Competitor Ad Intelligence at Scale", "description": "Real ads from the public Google Ads Transparency Center for any advertiser or website: advertiser ids and names, creative ids, formats, first and last shown dates, countries, platforms, preview links and ad text. Nothing is estimated.", "version": "1.0", "x-build-id": "nq62XVJwy1HHhTpNx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~google-ads-transparency-competitor-ad-intelligence-at-scale/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-google-ads-transparency-competitor-ad-intelligence-at-scale", "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/alizarin_refrigerator-owner~google-ads-transparency-competitor-ad-intelligence-at-scale/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-google-ads-transparency-competitor-ad-intelligence-at-scale", "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/alizarin_refrigerator-owner~google-ads-transparency-competitor-ad-intelligence-at-scale/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-google-ads-transparency-competitor-ad-intelligence-at-scale", "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": { "advertiserName": { "title": "Advertiser name", "type": "string", "description": "Name of the advertiser as Google shows it, for example 'Nike' or 'Home Depot U.S.A. Inc.'. The run searches the Transparency Center and uses the name match with the most ads that fit your filters. An advertiser id (AR followed by digits) also works." }, "advertiserUrl": { "title": "Transparency Center link", "type": "string", "description": "A link from adstransparency.google.com: an advertiser page (/advertiser/AR...), a single ad (/advertiser/AR.../creative/CR...), or a domain search (?domain=example.com). A normal website address is looked up by its domain." }, "domain": { "title": "Website domain", "type": "string", "description": "Return ads that lead to this website, for example 'nike.com'. Covers every advertiser that runs ads for the domain." }, "searchQuery": { "title": "Search box text", "type": "string", "description": "Works like the search box on the Transparency Center: a website domain is searched as a domain, anything else as an advertiser name. Used only when the fields above are empty. The Transparency Center does not search the words inside ads." }, "region": { "title": "Region", "enum": [ "US", "GB", "CA", "AU", "DE", "FR", "ES", "IT", "JP", "BR", "IN", "ALL" ], "type": "string", "description": "Only ads shown in this country. ALL returns ads from every country.", "default": "US" }, "adFormat": { "title": "Ad format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format.", "default": "ALL" }, "platform": { "title": "Platform", "enum": [ "ALL", "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY", "DISPLAY" ], "type": "string", "description": "Only ads shown on this Google platform. The Transparency Center has no Display filter, so Display returns every platform.", "default": "ALL" }, "dateRange": { "title": "Date range", "enum": [ "7_DAYS", "30_DAYS", "90_DAYS", "1_YEAR", "ALL_TIME" ], "type": "string", "description": "Only ads shown during this period, counted back from today.", "default": "30_DAYS" }, "maxAds": { "title": "Maximum ads", "minimum": 1, "maximum": 500, "type": "integer", "description": "Most ads to return per advertiser (or per domain).", "default": 50 }, "maxAdvertisers": { "title": "Maximum advertisers", "minimum": 1, "maximum": 5, "type": "integer", "description": "For a name search: how many matching advertiser accounts to include (some companies advertise through several). Each gets up to Maximum ads.", "default": 1 }, "includeCreatives": { "title": "Read ad text and preview images", "type": "boolean", "description": "Open Google's preview of each ad to read its text, image links and YouTube video. Turn off for a faster run with ids, dates, countries and preview links only.", "default": true }, "demoMode": { "title": "Demo mode", "type": "boolean", "description": "Return 2 labeled sample rows (demo: true) that show the output format. Nothing is read from Google and nothing is charged.", "default": false }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. Each ad is also sent here as JSON (POST) when it is saved." } } }, "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 } } } } } } } } } }