{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Ads by Advertiser or Domain", "description": "Every ad an advertiser or website runs on Google Search, YouTube, Shopping, Maps and Play, from the Ads Transparency Center: format, first/last shown, days running, image or YouTube video, ad text. Filter by country, platform, format and date. Pay only for ads you get.", "version": "1.0", "x-build-id": "dQkYGukv2T6RQHJU7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/t3data~google-ads-transparency/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-t3data-google-ads-transparency", "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/t3data~google-ads-transparency/runs": { "post": { "operationId": "runs-sync-t3data-google-ads-transparency", "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/t3data~google-ads-transparency/run-sync": { "post": { "operationId": "run-sync-t3data-google-ads-transparency", "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 or domains", "type": "array", "description": "One per line: an advertiser name (\"Nike, Inc.\"), a website domain (nike.com), an advertiser ID (AR…), or a link from adstransparency.google.com (advertiser, creative or domain page).", "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Only ads shown in this country: a two-letter code such as US, GB, DE, IN, BR (all 243 regions Google lists), or \"anywhere\" for all regions. A region in a pasted link wins over this.", "default": "anywhere" }, "format": { "title": "Ad format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format.", "default": "ALL" }, "platforms": { "title": "Platforms", "type": "array", "description": "Only ads shown on these Google platforms. Empty = all platforms.", "items": { "type": "string", "enum": [ "SEARCH", "YOUTUBE", "SHOPPING", "PLAY", "MAPS" ], "enumTitles": [ "Google Search", "YouTube", "Google Shopping", "Google Play", "Google Maps" ] } }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Only ads shown on or after this date (YYYY-MM-DD). Google keeps about the last year of date data." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Only ads shown on or before this date (YYYY-MM-DD)." }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser / domain", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Newest ads come first.", "default": 100 }, "maxAdvertisersPerName": { "title": "Advertisers per name search", "minimum": 1, "maximum": 10, "type": "integer", "description": "A name can match several advertiser accounts (e.g. a brand's country subsidiaries). Exact name matches come first, then the ones with the most ads.", "default": 1 }, "includeAdDetails": { "title": "Include ad text and video from previews", "type": "boolean", "description": "Open each ad's live preview (when Google has one) to pull its headline, description, YouTube video and images. Most search text ads have no live preview, only a picture. Included in the price; turn off for a faster list.", "default": true }, "maxConcurrency": { "title": "Parallel advertisers", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many advertisers or domains to process at the same time.", "default": 10 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is used by default. If Google blocks an IP, the actor retries on fresh IPs and switches to residential IPs automatically. Proxy cost is included in the price.", "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 } } } } } } } } } }