{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper", "description": "Built to beat Google Ads Transparency Center Scraper & API: on the same 17 queries (Oct 2026) it matched 8 of 8 brands to the right company (theirs 3 of 8), reads text-ad copy from Google's pictures, and adds landing pages and EU impressions, at under half the cost. From $1 per 1,000 ads.", "version": "0.2", "x-build-id": "g9i2RwoWeCKzwJpYm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tidyharvest~ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tidyharvest-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/tidyharvest~ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-tidyharvest-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/tidyharvest~ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-tidyharvest-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", "required": [ "queries" ], "properties": { "queries": { "title": "Advertisers, domains or Transparency Center links", "type": "array", "description": "One per line: a brand or advertiser name (Nike), a website (nike.com: every ad that points to it, from any advertiser), an advertiser id (AR...), or a link copied from adstransparency.google.com (advertiser page, single ad, or domain search; its region is used). A brand name resolves to the brand's own advertiser account, including companies that advertise under another legal name (Temu, Shein); the dataset says which one was matched.", "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "", "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", "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 (all 243 regions the Transparency Center offers). Empty = anywhere.", "default": "" }, "format": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Same labels as the Transparency Center.", "default": "all" }, "platform": { "title": "Platform", "enum": [ "all", "search", "youtube", "shopping", "maps", "play" ], "type": "string", "description": "Only ads shown on this Google surface. Google applies this filter only to ads shown since Sep 4, 2023.", "default": "all" }, "startDate": { "title": "Shown from", "type": "string", "description": "YYYY-MM-DD. Keeps ads that ran on or after this date." }, "endDate": { "title": "Shown until", "type": "string", "description": "YYYY-MM-DD. Keeps ads that ran on or before this date." }, "includeDetails": { "title": "Ad details (copy, landing page, reach)", "type": "boolean", "description": "Adds each ad's headline, description, call to action, landing URL and YouTube video (where Google exposes them), every variation, the countries it ran in with dates, impressions per country and platform (EU countries), and audience targeting. Same price; turn off for a faster list.", "default": true }, "readAdText": { "title": "Read text from ad images", "type": "boolean", "description": "Google keeps most text ads only as a picture. This reads the headline, description and display URL from the picture when they aren't available otherwise, and returns every word in image ads as imageText.", "default": false }, "saveImages": { "title": "Save ad images", "type": "boolean", "description": "Copy each ad's picture into this run's storage and add its link as imageCopyUrl, so you keep it after Google's link stops working.", "default": false }, "keywords": { "title": "Keywords (match any)", "type": "array", "description": "Keep an ad only if its advertiser, domain or copy contains one of these. Empty = all.", "items": { "type": "string" } }, "onlyNewAds": { "title": "Only new ads (monitoring)", "type": "boolean", "description": "Remember every ad returned and skip it next time, so a scheduled run returns and bills only ads it hasn't seen. Memory is kept per 'Monitor name'.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Separate memories for separate monitors (e.g. 'competitors-us'). Default: 'default'." }, "maxItemsPerQuery": { "title": "Max ads per query", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap per advertiser or domain. Big brands have thousands of ads. With 'Only new ads' this many of the most recent ads are checked.", "default": 100 }, "maxItems": { "title": "Max ads in total", "minimum": 0, "type": "integer", "description": "Hard cap for the whole run, and so for your cost. It is exact. 0 or empty = no limit." }, "includeEmptyResults": { "title": "Row for queries with no ads", "type": "boolean", "description": "Free row with status no_ads / not_found / error for each query that returned no ads, so a list of companies gets an answer for every one. Not charged.", "default": true } } }, "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 } } } } } } } } } }