{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper - Full Ad Text & Creatives", "description": "See competitors' Google ads with the content itself: headline, description, display URL, images, YouTube videos, landing domain, dates, regions and platforms. Search by advertiser or domain. $0.95 per 1,000 ads.", "version": "0.1", "x-build-id": "xnA7Mdaxa8KzczgKs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plotpointtech~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plotpointtech-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/plotpointtech~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-plotpointtech-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/plotpointtech~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-plotpointtech-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 (names or IDs)", "type": "array", "description": "Advertiser names (e.g. \"Nike, Inc.\") or advertiser IDs starting with AR (e.g. AR16735076323512287233). You can also paste a Transparency Center advertiser URL. Names are matched to the closest advertiser in Google's search suggestions.", "items": { "type": "string" } }, "domains": { "title": "Domains", "type": "array", "description": "Find ads that point to a website, e.g. expedia.com. Returns ads from every advertiser that advertises this domain.", "items": { "type": "string" } }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser / domain", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of ads to return for each advertiser or domain.", "default": 20 }, "region": { "title": "Region", "type": "string", "description": "Two-letter country code where the ads were shown (US, GB, DE, FR, IN ...), or \"anywhere\".", "default": "anywhere" }, "platform": { "title": "Platform", "enum": [ "ANY", "SEARCH", "YOUTUBE", "MAPS", "PLAY", "SHOPPING" ], "type": "string", "description": "Only ads shown on this Google platform.", "default": "ANY" }, "format": { "title": "Ad format", "enum": [ "ANY", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format.", "default": "ANY" }, "startDate": { "title": "Shown on or after", "type": "string", "description": "Only ads shown in this date range (YYYY-MM-DD). Leave empty for all available dates." }, "endDate": { "title": "Shown on or before", "type": "string", "description": "End of the date range (YYYY-MM-DD)." }, "fetchAdContent": { "title": "Extract ad content", "type": "boolean", "description": "Render each ad's preview to extract the headline, description, display URL, destination URL, images and YouTube video IDs. Turn off for a faster, metadata-only run.", "default": true }, "ocrTextAds": { "title": "Read archived text ads with OCR", "type": "boolean", "description": "Google keeps many search text ads only as an image of the rendered ad. When on, the actor reads the headline, description and display URL from that image with OCR (marked textSource = ocr_archived_image).", "default": true }, "ocrLanguage": { "title": "OCR language", "enum": [ "auto", "eng", "deu", "fra", "spa", "ita", "por", "nld", "pol", "tur", "rus", "jpn", "chi_sim", "kor", "eng+deu", "eng+fra", "eng+spa" ], "type": "string", "description": "Language of the text ads, for OCR. 'auto' uses English plus the main language of the selected region (e.g. German for DE). Combine with + for mixed sets, e.g. eng+deu.", "default": "auto" }, "includeRegionDetails": { "title": "Include per-region details", "type": "boolean", "description": "Add the list of regions where each ad was shown, with last-shown dates (and first-shown dates, impression ranges and platforms where Google publishes them, mainly EU/UK).", "default": true }, "detectPlatforms": { "title": "Detect platforms", "type": "boolean", "description": "Label each ad with the Google platforms it ran on (Search, YouTube, Maps, Play, Shopping) by cross-checking the platform-filtered ad lists. Adds a few extra requests per advertiser.", "default": true }, "maxVariantsToRender": { "title": "Max variants to render per ad", "minimum": 1, "maximum": 10, "type": "integer", "description": "Many ads have several variants. Stop after rendering this many if text has been found.", "default": 2 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 6, "type": "integer", "description": "Ads processed in parallel. Kept low to stay polite.", "default": 4 } } }, "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 } } } } } } } } } }