{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency & Ad Library Scraper", "description": "Scrape the Google Ads Transparency Center (Google Ad Library) by domain, advertiser ID or name. Get days running, first/last shown, countries per ad and ad copy - even for screenshot-only text ads (OCR) and responsive ads. Filter by country, platform, format, dates and min days running.", "version": "0.1", "x-build-id": "H8xVErcXuILfzLLtd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datalume~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datalume-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/datalume~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-datalume-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/datalume~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-datalume-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, booking.com (one per line). You can also paste an adstransparency.google.com link with ?domain=…. Subdomains are included.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs or Transparency Center links", "type": "array", "description": "Optional. Advertiser IDs (AR…) or adstransparency.google.com/advertiser/AR… links — the most exact way to target one advertiser.", "items": { "type": "string" } }, "queries": { "title": "Advertiser names", "type": "array", "description": "Optional. Advertiser names, e.g. 'Samsung Electronics'. Each name is looked up on the Transparency Center and its top match is scraped (see 'Advertisers per name').", "items": { "type": "string" } }, "region": { "title": "Country", "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", "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.", "default": "anywhere" }, "platform": { "title": "Platform", "enum": [ "all", "search", "youtube", "shopping", "maps", "play" ], "type": "string", "description": "Only ads shown on this Google platform.", "default": "all" }, "format": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only ads of this format.", "default": "all" }, "dateFrom": { "title": "Shown from (date)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional, YYYY-MM-DD. Only ads shown on or after this date." }, "dateTo": { "title": "Shown until (date)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional, YYYY-MM-DD. Only ads shown on or before this date." }, "minDaysRunning": { "title": "Minimum days running", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only ads shown on at least this many days. Long-running ads are usually the ones that work — use e.g. 30 to find an advertiser's winners. 0 = no filter.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "recentlyShown", "longestRunning", "newest" ], "type": "string", "description": "Order of the ads you get. 'Longest running' and 'Newest' scan up to 'Max ads to scan per target' and keep the best.", "default": "recentlyShown" }, "onlyNewAds": { "title": "Only new ads since last run", "type": "boolean", "description": "For scheduled monitoring: return only ads this Actor has not returned to you before for the same domain/advertiser. The first run returns everything.", "default": false }, "maxAdsPerTarget": { "title": "Max ads per domain/advertiser", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum ads returned for each domain, advertiser ID or advertiser name.", "default": 200 }, "maxResults": { "title": "Max total ads (0 = no limit)", "minimum": 0, "type": "integer", "description": "Hard cap on ads across all targets — use it to control cost.", "default": 0 }, "includeRegions": { "title": "Include countries per ad", "type": "boolean", "description": "Add the list of countries where each ad was shown, with the last date per country (1 extra request per ad, same price).", "default": true }, "includeAdCopy": { "title": "Include text-ad copy", "type": "boolean", "description": "For text ads, extract the headline, description, display URL and business name — from Google's text preview when available, otherwise by OCR of the ad snapshot image (most big advertisers' text ads are stored only as images). Ads with copy are charged as 'ad with copy'.", "default": true }, "advertisersPerQuery": { "title": "Advertisers per name", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many matching advertisers to scrape for each advertiser name (in Transparency Center search order).", "default": 1 }, "maxScanPerTarget": { "title": "Max ads to scan per target", "minimum": 100, "maximum": 10000, "type": "integer", "description": "With minimum days, 'Longest running' / 'Newest' sorting or 'Only new ads', this many ads are scanned per target before filtering. Scanning is free; only returned ads are charged.", "default": 1000 }, "concurrency": { "title": "Parallel targets", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many domains/advertisers are scraped at the same time.", "default": 3 } } }, "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 } } } } } } } } } }