{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper", "description": "Scrape ads from the Google Ads Transparency Center by advertiser domain, ID or name: format, first/last shown dates, regions, preview, ad copy, images, YouTube links and political ad spend. Filter by region, date, format and platform; monitor only new ads. No login or browser.", "version": "0.0", "x-build-id": "Pf6cjgi3ZA24AAdjV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rjmacarthy~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rjmacarthy-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/rjmacarthy~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-rjmacarthy-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/rjmacarthy~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-rjmacarthy-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": { "domains": { "title": "Advertiser domains", "type": "array", "description": "Websites whose ads you want, e.g. nike.com. Google returns every advertiser account whose ads point to the domain (a brand often has several, for example one per country). URLs are accepted and reduced to the domain.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Advertiser IDs such as AR16735076323512287233. Copy them from an adstransparency.google.com/advertiser/AR... URL (pasting the whole URL also works). The most precise way to target one advertiser.", "items": { "type": "string" } }, "advertiserNames": { "title": "Advertiser names", "type": "array", "description": "Advertiser names as shown in the Ads Transparency Center, e.g. \"Nike, Inc.\". Each name is looked up with Google's search suggestions and resolved to one advertiser: the exact name match with the most ads, otherwise the closest match with the most ads. The log lists the other candidates with their IDs. Names are ambiguous, so prefer IDs or domains when you can.", "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "anywhere", "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "IC", "BQ", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CK", "CR", "CI", "HR", "CW", "CY", "CZ", "CD", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "XK", "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", "CG", "RE", "RO", "RW", "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", "TW", "TJ", "TZ", "TH", "BS", "GM", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "VI", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW" ], "type": "string", "description": "Only ads shown in this country. \"Anywhere\" searches all regions.", "default": "anywhere" }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Only ads shown on or after this date (YYYY-MM-DD), or a relative value such as \"30 days\". An ad matches if it ran at any point in the date range." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Only ads shown on or before this date (YYYY-MM-DD). Leave empty for today." }, "adFormat": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Text, image or video ads only. Google's own format label is used, so Shopping product ads are counted as image ads.", "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": 0, "type": "integer", "description": "Stop after this many ads for each domain, advertiser ID or name you entered, most recently shown first. 0 = no limit. For a domain the limit covers all advertiser accounts found for that domain together.", "default": 100 }, "fetchDetails": { "title": "Fetch ad details", "type": "boolean", "description": "For every ad, also fetch its detail page and preview: the list of regions where it ran with per-region first/last shown dates (and impression ranges for EU countries), who paid for it, targeting types, ad copy, image and YouTube URLs where available, and the advertiser's country. Costs up to 2 extra requests per ad and is charged as a separate \"ad details\" event. Much slower: about 1 ad per second.", "default": false }, "politicalAdsOnly": { "title": "Political ads only", "type": "boolean", "description": "Search Google's political ads report instead of all ads. Adds spend and impression ranges to each ad. Requires a region where Google publishes political ads: Argentina, Australia, Brazil, Chile, EU countries, India, Israel, Mexico, New Zealand, South Africa, Taiwan, the United Kingdom or the United States. With no domains, IDs or names, the run returns all political ads in that region.", "default": false }, "onlyNewAds": { "title": "Only new ads (incremental mode)", "type": "boolean", "description": "Remember which ads were already output and only output (and charge for) ads that are new since the previous run. The first run outputs all matching ads and saves them as the baseline. Ideal for scheduled competitor monitoring.", "default": false }, "stateKey": { "title": "Monitor name (state key)", "type": "string", "description": "Name of this monitor's memory. Runs with the same name share the list of already-seen ads (per domain or advertiser). Use different names for independent monitors, e.g. one per region.", "default": "default" }, "stateStoreName": { "title": "State key-value store name", "type": "string", "description": "Named key-value store in your account where incremental state is kept (letters, digits and dashes).", "default": "google-ads-transparency-state" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "On by default (Apify datacenter proxy). Google blocks Apify's servers when they connect directly, so leave this on. If the log still says Google is rate-limiting or CAPTCHA-checking the run, switch to the RESIDENTIAL proxy group.", "default": { "useApifyProxy": true } }, "requestDelayMs": { "title": "Delay between requests", "minimum": 250, "maximum": 10000, "type": "integer", "description": "Minimum pause between requests to adstransparency.google.com. Google rate-limits this endpoint per IP address, so the default of 1 second is deliberately polite. Lower it only when using rotating proxies.", "default": 1000 } } }, "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 } } } } } } } } } }