{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Center Scraper: Ad Copy & Video", "description": "Scrape the Google Ads Transparency Center by domain, advertiser or link: every ad with headline and description (OCR for search ads), image, YouTube video link, first and last shown, countries, EU impressions and targeting. Ad check mode. New-ads alerts. $0.99/1K.", "version": "0.1", "x-build-id": "vvy5afv2owP0gMsR9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s_actors~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s_actors-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/s_actors~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-s_actors-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/s_actors~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-s_actors-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": { "searchTerms": { "title": "🔎 Advertisers, domains or links", "type": "array", "description": "One per line, mix freely: a domain (\"nike.com\", \"hellofresh.com\": every advertiser whose ads lead there), an advertiser name (\"Nike\": the matching advertiser account with the most ads), an advertiser ID (AR16735076323512287233) or a link copied from adstransparency.google.com (advertiser, single ad or domain search; its region / format / platform are used).", "items": { "type": "string" } }, "mode": { "title": "📋 What to get", "enum": [ "ads", "advertisers" ], "type": "string", "description": "Ad check is a cheap pass over a list of companies or domains: does each run Google ads, how many (Google's range), last shown, verified advertiser, country. One request per advertiser.", "default": "ads" }, "region": { "title": "🌍 Region (where the ads were shown)", "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", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "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", "CI", "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", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW", "AX" ], "type": "string", "description": "Only ads shown in this country. Anywhere = all countries. Ads shown in the EU also come with impressions by country and platform and the targeting used (EU Digital Services Act data).", "default": "anywhere" }, "adFormat": { "title": "🖼️ Ad format", "enum": [ "all", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Text = search ads (headline, description, display URL), Image = display banners, Video = YouTube ads (with the video link).", "default": "all" }, "platforms": { "title": "📺 Platforms", "type": "array", "description": "Only ads shown on these Google platforms. Empty = all. Google records platforms since 2023-09-04.", "items": { "type": "string", "enum": [ "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "enumTitles": [ "Google Search", "YouTube", "Google Shopping", "Google Maps", "Google Play" ] } }, "dateFrom": { "title": "📅 Shown since", "type": "string", "description": "Only ads shown on or after this day: 2026-01-31 or relative: \"30 days\", \"2 weeks\", \"6 months\". Empty = all time (Google keeps ads since 2018)." }, "dateTo": { "title": "📅 Shown until", "type": "string", "description": "Only ads shown on or before this day (same formats). Empty = today." }, "onlyActiveAds": { "title": "🟢 Only ads running now", "type": "boolean", "description": "Only ads shown in the last day or two (= \"Shown since\" yesterday). Every row has activeNow.", "default": false }, "maxAdsPerTarget": { "title": "💯 Max ads per advertiser / domain", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Ads per input line (per advertiser for a name). Google lists the most recently shown ads first. Big brands run thousands: Nike ~9 000.", "default": 100 }, "maxAdvertisersPerName": { "title": "👥 Advertisers per name", "minimum": 1, "maximum": 10, "type": "integer", "description": "A name such as \"Nike\" matches several advertiser accounts (Nike, Inc.; NIKE SRL; Nike Retail BV). 1 = only the one with the most ads. Domains always cover every advertiser.", "default": 1 }, "extractAdText": { "title": "✍️ Ad copy (headline, description)", "type": "boolean", "description": "Read the text of each ad: headline, description, display URL, call to action, landing URL where shown, keyword insertion ({KeyWord:...}). Search text ads are pictures on Google: read by OCR. Video ads get the YouTube link. Off = faster, no text.", "default": true }, "includeDetails": { "title": "🌐 Countries, variations, EU reach", "type": "boolean", "description": "Open each ad: every country it ran in (first and last day each), all variations, and for ads shown in the EU impressions by country and platform plus targeting (demographics, location, contextual, customer lists). One more request per ad.", "default": true }, "onlyNewAds": { "title": "🔔 Only new ads (alerts)", "type": "boolean", "description": "Remember every ad returned and next time return only ads not seen before (each row isNew: true). First run = everything. Ads seen before are free.", "default": false }, "monitorName": { "title": "🏷️ Alert name", "type": "string", "description": "Separate memory for each list you track: \"competitors-us\", \"brand-x\". Same name = same list.", "default": "default" }, "maxConcurrency": { "title": "⚡ Parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "Ads read at once (details, previews, OCR).", "default": 6 }, "proxyConfiguration": { "title": "🛡️ Proxy", "type": "object", "description": "The Actor reads Google directly and switches to Apify Proxy (datacenter, then residential) when Google starts refusing.", "default": { "useApifyProxy": true } }, "debugLog": { "title": "🐞 Debug log", "type": "boolean", "description": "Log every retry.", "default": 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 } } } } } } } } } }