{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper", "description": "Google Ads Transparency scraper: get every ad creative from the Google Ads Transparency Center by domain, advertiser ID, URL or advertiser name, with format, first/last shown dates, regions, platforms, impressions, ad text, landing URL and media links. Monitor new ads.", "version": "1.0", "x-build-id": "ujGOwDWjYdoWXhTvn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/groupoject~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-groupoject-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/groupoject~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-groupoject-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/groupoject~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-groupoject-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": { "advertiserDomains": { "title": "Advertiser domains", "type": "array", "description": "Websites whose Google ads you want, e.g. \"nike.com\". Returns ads from every advertiser account Google links to that domain. Protocol, \"www.\" and paths are ignored.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Google advertiser IDs (start with \"AR\", e.g. AR16735076323512287233). Find them in an advertiser's Transparency Center URL or in a previous run's output.", "items": { "type": "string" } }, "startUrls": { "title": "Transparency Center URLs", "type": "array", "description": "Links copied from adstransparency.google.com: an advertiser page (/advertiser/AR...), a single ad (/advertiser/AR.../creative/CR...) or a domain search (?domain=...). Region, platform, format and date filters in the URL override the filters below for that URL.", "items": { "type": "string" } }, "searchTerms": { "title": "Advertiser name search", "type": "array", "description": "Brand or company names, e.g. \"Nike\". Each term is matched against the Transparency Center's advertiser search and expands to the best-matching advertiser accounts (see the next field). This searches advertiser names, not ad copy.", "items": { "type": "string" } }, "maxAdvertisersPerSearchTerm": { "title": "Advertisers per search term", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many matching advertiser accounts to scrape for each search term. Names that contain the term as a whole word rank first, then accounts with more ads.", "default": 3 }, "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", "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", "CI", "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", "KP", "KR", "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", "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", "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", "UM", "US", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW", "AX" ], "type": "string", "description": "Only ads shown in this country. \"Anywhere\" returns ads from all regions.", "default": "anywhere" }, "dateFrom": { "title": "Shown on or after", "pattern": "^(\\d{4}-\\d{2}-\\d{2}|\\d{1,4} ?(day|days|week|weeks|month|months))?$", "type": "string", "description": "Only ads shown on or after this date. Use YYYY-MM-DD or a relative value like \"30 days\" or \"6 months\". Google only applies date filters to roughly the last 12 months." }, "dateTo": { "title": "Shown on or before", "pattern": "^(\\d{4}-\\d{2}-\\d{2}|\\d{1,4} ?(day|days|week|weeks|month|months))?$", "type": "string", "description": "Only ads shown on or before this date (YYYY-MM-DD or relative). Defaults to today when \"Shown on or after\" is set." }, "format": { "title": "Ad format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format.", "default": "ALL" }, "platform": { "title": "Platform", "enum": [ "ALL", "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "type": "string", "description": "Only ads shown on this Google platform.", "default": "ALL" }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum ads to return for each domain, advertiser ID, URL or matched advertiser. Google lists the most recently shown ads first.", "default": 100 }, "maxTotalAds": { "title": "Max ads in total", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Hard cap for the whole run, across all inputs. 0 = no cap (your maximum charge limit still applies).", "default": 0 }, "includeDetails": { "title": "Include regions, impressions & targeting", "type": "boolean", "description": "Opens each ad's detail record: regions where it ran, per-region first/last shown dates, impression ranges by platform (published mainly for EU/Türkiye), audience-targeting categories and the number of variations. Turn off for a faster, lighter run.", "default": true }, "extractAdContent": { "title": "Extract ad text & media from previews", "type": "boolean", "description": "Reads Google's rendered ad preview to pull headline, description, display URL, call to action, YouTube video ID, landing URL (when exposed) and image links. Adds roughly 40 KB of download per ad.", "default": true }, "onlyNewAds": { "title": "Only new ads (monitoring)", "type": "boolean", "description": "Remembers which ads earlier runs already returned and only outputs ads not seen before. The first run returns everything and records it. Ideal for scheduled runs.", "default": false }, "monitorStateName": { "title": "Monitor name", "type": "string", "description": "Optional name for the monitoring memory, so different schedules don't share it. Leave empty to derive it from the inputs and filters." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many ads are enriched in parallel. Higher is faster but more likely to be throttled by Google.", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy (datacenter) is the default. Every retry uses a new IP, and the run can switch to residential automatically if Google blocks datacenter IPs (see next option).", "default": { "useApifyProxy": true } }, "residentialFallback": { "title": "Fall back to residential proxy when blocked", "type": "boolean", "description": "If Google throttles most datacenter requests (HTTP 429 / 'unusual traffic'), switch this run to Apify residential proxy so it still finishes. Has no effect when you already selected residential or use your own proxies.", "default": true }, "debugMode": { "title": "Debug logging", "type": "boolean", "description": "Log every request retry and parser decision.", "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 } } } } } } } } } }