{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper + New Ads Monitor", "description": "Get every ad a company runs on Google Search, YouTube, Display and Shopping from the Google Ads Transparency Center. Search by advertiser name, domain or ID, filter by country, format and date, extract ad text, and get only new ads on scheduled runs.", "version": "0.1", "x-build-id": "v121DCUF7lPf2jQ4s" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alucard2392~google-ads-transparency/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alucard2392-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/alucard2392~google-ads-transparency/runs": { "post": { "operationId": "runs-sync-alucard2392-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/alucard2392~google-ads-transparency/run-sync": { "post": { "operationId": "run-sync-alucard2392-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": [ "targets" ], "properties": { "targets": { "title": "Advertisers, domains or URLs", "type": "array", "description": "One per line. Accepts an advertiser name (\"Nike\"), a domain (\"nike.com\"), an advertiser ID (\"AR16735076323512287233\") or an Ads Transparency Center URL.", "items": { "type": "string" } }, "region": { "title": "Country", "type": "string", "description": "2-letter country code (US, GB, DE, VN…) or \"anywhere\".", "default": "anywhere" }, "format": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only return ads of this format.", "default": "all" }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Only ads that were shown at some point on or after this date (YYYY-MM-DD). Ads still running are included." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Only ads that were shown at some point on or before this date (YYYY-MM-DD). An ad that started before and is still running counts." }, "maxAdsPerTarget": { "title": "Max ads per target", "minimum": 1, "type": "integer", "description": "Stop after this many ads for each advertiser, domain or URL.", "default": 100 }, "extractText": { "title": "Extract ad text & media", "type": "boolean", "description": "Get the headline, description, display URL and sitelinks of every ad (read from the preview, or by OCR when Google only keeps a screenshot), plus the YouTube URL of video ads and product image URLs. Adds a small extra charge per ad.", "default": false }, "ocrLanguage": { "title": "OCR language", "type": "string", "description": "Tesseract language code(s) for reading screenshot-only text ads, e.g. eng, deu, fra, spa, vie, or eng+deu.", "default": "eng" }, "includeDetails": { "title": "Include countries and variations", "type": "boolean", "description": "Fetch each ad's detail page: the countries it ran in (with last-shown date) and all creative variations. Adds a small extra charge per ad.", "default": false }, "onlyNewAds": { "title": "Only new ads (monitoring mode)", "type": "boolean", "description": "Remember which ads were already returned and skip them next time. Schedule the Actor daily or weekly to get just the ads your competitors launched since the last run.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Keeps separate memories for different monitors. Use the same name on every scheduled run of one monitor.", "default": "default" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Recommended for runs of more than a few hundred ads: Google rate-limits per IP. Only the small search requests use the proxy.", "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 } } } } } } } } } }