{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper & Alerts | $1.50/1K", "description": "Scrape competitors' Google ads from the Ads Transparency Center, Google's public ad library: ad copy of text ads as headline and description (OCR), images, YouTube videos, regions, platforms and impressions. Monitor advertisers and get Slack, Discord, webhook or e-mail alerts for new ads.", "version": "1.0", "x-build-id": "xflInYSXeomh4uPtd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/layerwiselabs~google-ads-transparency-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-layerwiselabs-google-ads-transparency-monitor", "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/layerwiselabs~google-ads-transparency-monitor/runs": { "post": { "operationId": "runs-sync-layerwiselabs-google-ads-transparency-monitor", "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/layerwiselabs~google-ads-transparency-monitor/run-sync": { "post": { "operationId": "run-sync-layerwiselabs-google-ads-transparency-monitor", "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", "type": "array", "description": "Whose ads to get. Each line is a website domain (nike.com), an advertiser name (Zalando SE), an advertiser ID (AR17568630107302526977) or a Transparency Center URL. A domain returns every advertiser that promotes it.", "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "anywhere", "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "CI", "CD", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RO", "RU", "RW", "RE", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TM", "TC", "TV", "TR", "VI", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW", "AX" ], "type": "string", "description": "Only ads shown in this country.", "default": "anywhere" }, "platform": { "title": "Platform", "enum": [ "all", "search", "youtube", "shopping", "maps", "play" ], "type": "string", "description": "Only ads shown on this Google service.", "default": "all" }, "adFormat": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only ads of this format.", "default": "all" }, "shownInLastDays": { "title": "Shown in the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only ads shown within this many days before today (up to about 365, as far as Google's date filter reaches). Overrides 'Shown from'. 0 = no limit.", "default": 0 }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Only ads shown on or after this day, YYYY-MM-DD. Google's date filter covers about the last 12 months." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Only ads shown on or before this day, YYYY-MM-DD." }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 1, "maximum": 50000, "type": "integer", "description": "How many ads to return per line in Advertisers, most recently shown first. With 'Only new ads', each check looks through up to 5,000 ads and returns at most this many new ones; any others follow with the next run.", "default": 50 }, "includeDetails": { "title": "Include regions, platforms and impressions", "type": "boolean", "description": "Per ad: countries with first and last day shown, impressions per country and platform, topic and all variations. One extra request per ad.", "default": true }, "includeAdContent": { "title": "Include ad text, images and videos", "type": "boolean", "description": "Reads headline, description and display URL of text ads (OCR), product titles and images of image ads, and YouTube link, title and channel of video ads.", "default": true }, "onlyNewAds": { "title": "Only new ads (monitoring)", "type": "boolean", "description": "Remembers which ads each advertiser already had and returns only ads launched since the previous check. The first run saves the current ads as a baseline and returns nothing. Schedule the Actor (for example daily) to watch competitors.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Keeps separate memories for different monitors with the same advertisers. Saved tasks get their own memory automatically." }, "slackWebhookUrl": { "title": "Slack webhook URL", "type": "string", "description": "Posts new ads to a Slack channel (Incoming Webhook URL). Needs 'Only new ads'." }, "discordWebhookUrl": { "title": "Discord webhook URL", "type": "string", "description": "Posts new ads to a Discord channel. Needs 'Only new ads'." }, "webhookUrl": { "title": "Webhook URL (JSON)", "type": "string", "description": "Sends the new ads as JSON in a POST request, for example to Make, Zapier or n8n. Needs 'Only new ads'." }, "notifyEmail": { "title": "E-mail for alerts", "type": "string", "description": "Sends new ads by e-mail through the apify/send-mail Actor (billed to your account as a few cents of platform usage). Use the e-mail address of your Apify account. Needs 'Only new ads'." }, "ocrLanguages": { "title": "OCR language", "type": "string", "description": "Tesseract language codes for reading text ads, e.g. 'deu' or 'fra+eng'. Empty = the language of the region; with 'Anywhere', the language of the country where each ad was shown most." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Ads processed in parallel (previews, images and text recognition). Requests to the Transparency Center itself always run one after another, which keeps blocks by Google rare.", "default": 4 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave it off: the Actor connects directly and moves to residential Apify Proxy by itself while Google blocks it. A proxy set here is used first, with residential Apify Proxy and the run's own IP as backup.", "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 } } } } } } } } } }